Les erreurs d'importation TimeBro (Memtime) surviennent lorsque les entrées de temps ne parviennent pas à être mappées ou à être envoyées dans Zoho Projects. L'intégration mappe normalement le temps suivi aux Projets, Tâches ou Incidents automatiquement, donc ces erreurs signifient que le mappage automatisé ou la connexion entre les systèmes est rompu.[1]
Ce que cela signifie
Le connecteur Memtime vers Zoho Projects a tenté de créer des journaux de temps dans Zoho Projects, mais l'appel API a échoué ou a renvoyé une erreur de validation. Les échecs se produisent lorsque l'intégration ne trouve pas le Projet/Tâche/Incident cible, que les identifiants OAuth/API sont rejetés, que la charge utile viole une règle de champ de Projets, ou qu'un problème de débit/format en amont empêche un POST réussi à l'API de temps de Projets.[1][2]
Causes courantes
- Le Projet, la Tâche ou l'Incident n'existe plus ou a été renommé, de sorte que l'intégration ne peut pas faire correspondre l'entrée par nom ou ID.[1]
- Le jeton d'intégration Memtime ou l'autorisation OAuth accordée à Zoho Projects a expiré ou a été révoquée, provoquant des réponses 401/403.[1]
- La validation des champs ou un champ personnalisé requis dans Zoho Projects rejette la charge utile (format de date incorrect, champ requis manquant, incompatibilité du drapeau facturable).[2]
- Les limites de débit de l'API, les pannes réseau temporaires ou les envois en masse importants ont provoqué des délais d'attente ou des erreurs 429/5xx.[2]
- Les autorisations ont été modifiées pour le compte utilisateur Zoho Projects utilisé par le connecteur (permission Créer/Enregistrer le temps manquante).[3]
Comment résoudre le problème
- Capturez le texte d'erreur exact et la plage horaire des journaux d'importation Memtime. Copiez le JSON d'une entrée échouée ou une ligne CSV pour le dépannage.
- Dans Zoho Projects, confirmez que le Projet/Tâche/Incident cible existe et vérifiez son ID interne : Projets > [Projet] > Tâches (ouvrir la tâche) pour vérifier l'ID ou le nom exact. Si le connecteur correspond par nom, assurez-vous de l'orthographe et de la casse exactes.[1]
- Réautorisez l'intégration depuis Memtime : ouvrez Memtime Paramètres > Intégrations > Zoho Projects et cliquez sur Reconnecter ou Se connecter à nouveau. Confirmez le consentement OAuth et que la bonne organisation Zoho est sélectionnée. Cela résout les jetons expirés ou révoqués.[1]
- Vérifiez que l'utilisateur Zoho Projects utilisé par l'intégration dispose des autorisations d'enregistrement du temps : Zoho Projects > Configuration > Utilisateurs et autorisations > Profils. Assurez-vous que Créer/Enregistrer le temps et l'accès au projet spécifique sont activés.[3]
- Vérifiez les règles de validation et les champs personnalisés de Zoho Projects : si Projets impose des champs requis sur les entrées de temps, relâchez la règle ou ajoutez les données du champ manquant dans le mappage Memtime. Testez avec une entrée manuelle.[2]
- Si les erreurs affichent 429/5xx ou des délais d'attente réseau, attendez 5 à 10 minutes et réessayez le lot échoué. Pour les importations volumineuses, divisez-les en lots plus petits. Surveillez les journaux Memtime pour les codes de limitation de débit répétés.[2]
- Réessayez les entrées échouées après les corrections. Si le mappage reste instable, exportez les lignes échouées et importez-les manuellement dans Zoho Projects via l'importation CSV comme solution de contournement temporaire.
Quand escalader
Escaladez vers le support Zoho lorsque vous pouvez reproduire les échecs après réautorisation et vérification des autorisations, ou lorsque les journaux affichent des réponses 4xx/5xx sans cause claire de validation ou d'autorisation. Fournissez le JSON/CSV de l'entrée échouée, les horodatages, l'ID du compte/organisation et la sortie du journal d'intégration afin que le support puisse retracer les appels API.[1]