Lede
L'errore di sincronizzazione "Cliente non collegato" appare quando Zoho Books rifiuta un record inviato da Zoho CRM perché il contatto o l'account CRM non è mappato al modulo clienti di Books nella configurazione di sincronizzazione contatti attiva. Questo impedisce la creazione o l'aggiornamento del record in Books finché il collegamento non viene corretto [1][2].
Cosa significa
Il connettore CRM–Books di Zoho utilizza una configurazione di sincronizzazione contatti per mappare i moduli CRM (Contatti, Account o un modulo personalizzato) al modulo Clienti o Contatti in Books. Quando Books riceve un invio per un record e non riesce a trovare un ID cliente Books corrispondente per il record CRM, restituisce: "Il cliente associato a questo record non è collegato al modulo scelto nella configurazione di sincronizzazione contatti corrente." In breve, al record CRM manca la relazione mappata prevista a un record cliente Books, quindi Books rifiuta l'operazione [1][2].
Cause comuni
- La configurazione di sincronizzazione contatti mappa il modulo CRM errato (ad esempio, mappa Account ma invia Contatti) [1].
- Il record CRM non è mai stato sincronizzato con Books, o la sincronizzazione iniziale è fallita, quindi non è registrato alcun ID cliente Books [1][2].
- Il record CRM è stato unito, eliminato o il suo ID è stato modificato dopo la sincronizzazione, quindi il collegamento Books memorizzato è obsoleto.
- Regole di sincronizzazione contatti multiple o un problema di autorizzazioni dell'account di prova hanno impedito al connettore di creare il cliente in Books [1].
Come risolverlo
- Apri Zoho Books > Impostazioni > Integrazioni > Zoho CRM > Sincronizzazione contatti e conferma quale modulo CRM è mappato ai Clienti di Books. Se ti aspetti Contatti, assicurati che Contatti sia selezionato; se Account, seleziona Account [1].
- In Zoho CRM, apri il record esatto che ha causato l'errore e controlla la presenza di un campo di sincronizzazione Zoho Books (spesso un ID cliente Books o un campo di stato della sincronizzazione). Se assente, invia manualmente o risincronizza quel record da CRM a Books utilizzando l'interfaccia utente del connettore.
- Se esiste una mappatura ma il record continua a fallire, esegui una sincronizzazione una tantum per un piccolo set di record: nelle impostazioni di integrazione CRM di Books, utilizza "Sincronizza ora" per i contatti. Monitora i log di sincronizzazione per i fallimenti e annota gli ID dei record mostrati nell'errore.
- Per i record uniti/eliminati, ripristina o ricrea il record CRM, quindi ristabilisci il collegamento sincronizzando un nuovo record o modificando il cliente Books per farlo corrispondere al nome/email del CRM.
- Se il tuo account è una prova o vedi il codice 57 ("non autorizzato"), verifica che l'utente che esegue la sincronizzazione disponga delle autorizzazioni richieste sia in Books che in CRM, e aggiorna i token OAuth per il connettore prima di riprovare [1].
Quando escalare
Escala al Supporto Zoho quando i log mostrano un errore interno del connettore, quando non riesci a localizzare gli ID dei record menzionati nei log di sincronizzazione, o quando le autorizzazioni e le mappature sono corrette ma gli invii falliscono ancora. Fornisci le voci del log di sincronizzazione e gli ID dei record CRM per accelerare la diagnosi.
[1]: Post della community Zoho che discutono di errori di invio Books–CRM e problemi di mappatura.
[2]: Esempi di thread della community di fallimenti di sincronizzazione Books–CRM e mappatura contatti.