Lede
L'erreur de synchronisation "Client non lié" apparaît lorsque Zoho Books rejette un enregistrement poussé depuis Zoho CRM car le contact ou le compte CRM n'est pas mappé au module Client de Books dans la configuration de synchronisation des contacts active. Cela empêche la création ou la mise à jour de l'enregistrement dans Books jusqu'à ce que la liaison soit corrigée [1][2].
Ce que cela signifie
Le connecteur CRM–Books de Zoho utilise une configuration de synchronisation des contacts pour mapper les modules CRM (Contacts, Comptes ou un module personnalisé) au module Clients ou Contacts dans Books. Lorsque Books reçoit une poussée pour un enregistrement et ne trouve pas d'ID client Books correspondant pour l'enregistrement CRM, il renvoie : "Le client associé à cet enregistrement n'est pas lié au module choisi dans la configuration de synchronisation des contacts actuelle." En bref, l'enregistrement CRM manque de la relation mappée attendue à un enregistrement client Books, donc Books rejette l'opération [1][2].
Causes courantes
- La configuration de synchronisation des contacts mappe le mauvais module CRM (par exemple, mappage des Comptes mais poussée des Contacts) [1].
- L'enregistrement CRM n'a jamais été synchronisé avec Books, ou la synchronisation initiale a échoué, donc aucun ID client Books n'est enregistré [1][2].
- L'enregistrement CRM a été fusionné, supprimé ou son ID a été modifié après la synchronisation, de sorte que le lien Books stocké est obsolète.
- Plusieurs règles de synchronisation de contacts ou un problème d'autorisation de compte d'essai ont empêché le connecteur de créer le client dans Books [1].
Comment le corriger
- Ouvrez Zoho Books > Paramètres > Intégrations > Zoho CRM > Synchronisation des contacts et confirmez quel module CRM est mappé aux Clients Books. Si vous attendez des Contacts, assurez-vous que Contacts est sélectionné ; si vous attendez des Comptes, sélectionnez Comptes [1].
- Dans Zoho CRM, ouvrez l'enregistrement exact qui a causé l'erreur et recherchez un champ de synchronisation Zoho Books (souvent un ID client Books ou un champ de statut de synchronisation). S'il est absent, poussez manuellement ou resynchronisez cet enregistrement de CRM vers Books en utilisant l'interface utilisateur du connecteur.
- Si un mappage existe mais que l'enregistrement échoue toujours, exécutez une synchronisation ponctuelle pour un petit ensemble d'enregistrements : dans les paramètres d'intégration CRM de Books, utilisez "Synchroniser maintenant" pour les contacts. Surveillez les journaux de synchronisation pour les échecs et notez les ID d'enregistrement indiqués dans l'erreur.
- Pour les enregistrements fusionnés/supprimés, restaurez ou recréez l'enregistrement CRM, puis rétablissez le lien en synchronisant un nouvel enregistrement ou en modifiant le client Books pour qu'il corresponde au nom/email du CRM.
- Si votre compte est un essai ou si vous voyez le code 57 ("non autorisé"), vérifiez que l'utilisateur effectuant la synchronisation dispose des autorisations requises dans Books et CRM, et actualisez les jetons OAuth pour le connecteur avant de réessayer [1].
Quand escalader
Escaladez vers le support Zoho lorsque les journaux montrent une erreur interne du connecteur, lorsque vous ne parvenez pas à localiser les ID d'enregistrement mentionnés dans les journaux de synchronisation, ou lorsque les autorisations et les mappages sont corrects mais que les poussées échouent toujours. Fournissez les entrées du journal de synchronisation et les ID d'enregistrement CRM pour accélérer le diagnostic.
[1]: Articles de la communauté Zoho discutant des erreurs de poussée Books–CRM et des problèmes de mappage.
[2]: Exemples de fils de discussion communautaires sur les échecs de synchronisation Books–CRM et le mappage des contacts.