Los errores de importación de TimeBro (Memtime) ocurren cuando las entradas de tiempo no se mapean o no se envían a Zoho Projects. La integración normalmente mapea el tiempo registrado a Proyectos, Tareas o Incidencias automáticamente, por lo que estos errores significan que el mapeo automatizado o la conexión entre sistemas se ha roto.[1]
Qué significa
El conector de Memtime a Zoho Projects intentó crear registros de tiempo en Zoho Projects, pero la llamada a la API falló o devolvió un error de validación. Los fallos ocurren cuando la integración no puede encontrar el Proyecto/Tarea/Incidencia de destino, las credenciales OAuth/API son rechazadas, el payload viola una regla de campo de Proyectos, o un problema de formato/límite de tasa anterior impide un POST exitoso a la API de tiempo de Proyectos.[1][2]
Causas comunes
- El Proyecto, Tarea o Incidencia ya no existe o fue renombrado, por lo que la integración no puede emparejar la entrada por nombre o ID.[1]
- El token de integración de Memtime o la concesión de OAuth a Zoho Projects expiró o fue revocado, causando respuestas 401/403.[1]
- La validación de campos o un campo personalizado requerido en Zoho Projects rechaza el payload (formato de fecha incorrecto, campo requerido faltante, discrepancia en el indicador de facturable).[2]
- Límites de tasa de API, fallos temporales de red o envíos masivos grandes causaron tiempos de espera agotados o errores 429/5xx.[2]
- Los permisos cambiaron para la cuenta de usuario de Zoho Projects utilizada por el conector (falta el permiso Crear/Registrar Tiempo).[3]
Cómo solucionarlo
- Capture el texto exacto del error y el rango de tiempo de los registros de importación de Memtime. Copie el JSON de una entrada fallida o una fila CSV para la resolución de problemas.
- En Zoho Projects, confirme que el Proyecto/Tarea/Incidencia de destino existe y verifique su ID interno: Proyectos > [Proyecto] > Tareas (abrir tarea) para verificar el ID o el nombre exacto. Si el conector coincide por nombre, asegúrese de que la ortografía y las mayúsculas sean exactas.[1]
- Vuelva a autorizar la integración desde Memtime: abra Memtime Configuración > Integraciones > Zoho Projects y haga clic en Reconectar o Iniciar sesión de nuevo. Confirme el consentimiento de OAuth y que se selecciona la organización correcta de Zoho. Esto soluciona tokens expirados o revocados.[1]
- Verifique que el usuario de Zoho Projects utilizado por la integración tenga permisos para registrar tiempo: Zoho Projects > Configuración > Usuarios y Permisos > Perfiles. Asegúrese de que Crear/Registrar Tiempo y el acceso al proyecto específico estén habilitados.[3]
- Compruebe las reglas de validación y los campos personalizados de Zoho Projects: si Proyectos exige campos obligatorios en las entradas de tiempo, relaje la regla o agregue los datos del campo faltante en el mapeo de Memtime. Pruebe con una entrada manual.[2]
- Si los errores muestran 429/5xx o tiempos de espera de red agotados, espere 5-10 minutos y reintente el lote fallido. Para importaciones grandes, divídalas en lotes más pequeños. Monitoree los registros de Memtime para códigos de límite de tasa repetidos.[2]
- Reintente las entradas fallidas después de las correcciones. Si el mapeo sigue siendo inestable, exporte las filas fallidas e impórtelas manualmente en Zoho Projects a través de la importación CSV como una solución temporal.
Cuándo escalar
Escale a Soporte de Zoho cuando pueda reproducir fallos después de la reautorización y la verificación de permisos, o cuando los registros muestren respuestas 4xx/5xx sin una causa clara de validación o permiso. Proporcione el JSON/CSV de la entrada fallida, las marcas de tiempo, el ID de cuenta/organización y la salida del registro de integración para que el soporte pueda rastrear las llamadas a la API.[1]