Gli errori di importazione di TimeBro (Memtime) si verificano quando le voci di tempo non riescono a essere mappate o inviate in Zoho Projects. L'integrazione normalmente mappa il tempo registrato a Progetti, Attività o Issue automaticamente, quindi questi errori indicano che la mappatura automatica o la connessione tra i sistemi si è interrotta.[1]
Cosa significa
Il connettore Memtime-Zoho Projects ha tentato di creare registri di tempo in Zoho Projects, ma la chiamata API è fallita o ha restituito un errore di validazione. I fallimenti si verificano quando l'integrazione non riesce a trovare il Progetto/Attività/Issue di destinazione, le credenziali OAuth/API vengono rifiutate, il payload viola una regola di campo di Progetti, o un problema di limite di frequenza/formato a monte impedisce un POST riuscito all'API del tempo di Progetti.[1][2]
Cause comuni
- Il Progetto, l'Attività o l'Issue non esiste più o è stato rinominato, quindi l'integrazione non riesce a trovare la voce per nome o ID.[1]
- Il token di integrazione Memtime o la concessione OAuth a Zoho Projects sono scaduti o sono stati revocati, causando risposte 401/403.[1]
- La validazione dei campi o un campo personalizzato obbligatorio in Zoho Projects rifiuta il payload (formato data errato, campo obbligatorio mancante, discrepanza nel flag fatturabile).[2]
- Limiti di frequenza API, guasti temporanei di rete o grandi invii in blocco hanno causato timeout o errori 429/5xx.[2]
- Le autorizzazioni sono cambiate per l'account utente Zoho Projects utilizzato dal connettore (permesso di Creare/Registrare Tempo mancante).[3]
Come risolvere
- Cattura il testo esatto dell'errore e l'intervallo di tempo dai log di importazione di Memtime. Copia il JSON di una voce fallita o una riga CSV per la risoluzione dei problemi.
- In Zoho Projects, conferma che il Progetto/Attività/Issue di destinazione esista e controlla il suo ID interno: Progetti > [Progetto] > Attività (apri attività) per verificare l'ID o il nome esatto. Se il connettore corrisponde per nome, assicurati che ortografia e maiuscole/minuscole siano esatte.[1]
- Ri-autorizza l'integrazione da Memtime: apri Memtime Impostazioni > Integrazioni > Zoho Projects e fai clic su Riconnetti o Accedi di nuovo. Conferma il consenso OAuth e che sia selezionata la corretta organizzazione Zoho. Questo risolve i token scaduti o revocati.[1]
- Verifica che l'utente Zoho Projects utilizzato dall'integrazione disponga delle autorizzazioni per la registrazione del tempo: Zoho Projects > Impostazioni > Utenti e autorizzazioni > Profili. Assicurati che siano abilitati Creare/Registrare Tempo e l'accesso al progetto specifico.[3]
- Controlla le regole di validazione e i campi personalizzati di Zoho Projects: se Progetti impone campi obbligatori sulle voci di tempo, allenta la regola o aggiungi i dati del campo mancante nella mappatura di Memtime. Prova con una singola voce manuale.[2]
- Se gli errori mostrano 429/5xx o timeout di rete, attendi 5-10 minuti e riprova il batch fallito. Per importazioni di grandi dimensioni, dividi in batch più piccoli. Monitora i log di Memtime per codici di limite di frequenza ripetuti.[2]
- Riprova le voci fallite dopo le correzioni. Se la mappatura rimane instabile, esporta le righe fallite e importale manualmente in Zoho Projects tramite importazione CSV come soluzione temporanea.
Quando escalare
Escala al Supporto Zoho quando puoi riprodurre i fallimenti dopo la riautorizzazione e i controlli delle autorizzazioni, o quando i log mostrano risposte 4xx/5xx senza una chiara causa di validazione o autorizzazione. Fornisci il JSON/CSV della voce fallita, i timestamp, l'ID dell'account/organizzazione e l'output del log di integrazione in modo che il supporto possa tracciare le chiamate API.[1]