Introducción
El error de sincronización "Cliente No Vinculado" aparece cuando Zoho Books rechaza un registro enviado desde Zoho CRM porque el contacto o cuenta de CRM no está mapeado al módulo de clientes de Books en la configuración de sincronización de contactos activa. Esto impide que el registro se cree o actualice en Books hasta que se corrija el vínculo [1][2].
Qué significa
El conector de CRM–Books de Zoho utiliza una configuración de sincronización de contactos para mapear módulos de CRM (Contactos, Cuentas o un módulo personalizado) al módulo de Clientes o Contactos en Books. Cuando Books recibe un envío para un registro y no puede encontrar un ID de cliente de Books coincidente para el registro de CRM, devuelve: "El cliente asociado a este registro no está vinculado al módulo elegido en la configuración de sincronización de contactos actual." En resumen, al registro de CRM le falta la relación mapeada esperada con un registro de cliente de Books, por lo que Books rechaza la operación [1][2].
Causas comunes
- La configuración de sincronización de contactos mapea el módulo de CRM incorrecto (por ejemplo, mapea Cuentas pero envía Contactos) [1].
- El registro de CRM nunca se sincronizó con Books, o la sincronización inicial falló, por lo que no hay un ID de cliente de Books registrado [1][2].
- El registro de CRM se fusionó, eliminó o se le cambió el ID después de la sincronización, por lo que el enlace de Books almacenado está obsoleto.
- Múltiples reglas de sincronización de contactos o un problema de permisos de cuenta de prueba impidieron que el conector creara el cliente en Books [1].
Cómo solucionarlo
- Abra Zoho Books > Configuración > Integraciones > Zoho CRM > Sincronización de Contactos y confirme qué módulo de CRM está mapeado a Clientes de Books. Si espera Contactos, asegúrese de que Contactos esté seleccionado; si espera Cuentas, seleccione Cuentas [1].
- En Zoho CRM, abra el registro exacto que causó el error y busque un campo de sincronización de Zoho Books (a menudo un ID de Cliente de Books o un campo de estado de sincronización). Si está ausente, envíe manualmente o resincronice ese registro de CRM a Books usando la interfaz de usuario del conector.
- Si existe un mapeo pero el registro aún falla, ejecute una sincronización única para un pequeño conjunto de registros: en la configuración de integración de CRM de Books, use "Sincronizar ahora" para los contactos. Observe los registros de sincronización en busca de fallos y anote los IDs de registro que se muestran en el error.
- Para registros fusionados/eliminados, restaure o recree el registro de CRM, luego restablezca el vínculo sincronizando un registro nuevo o editando el cliente de Books para que coincida con el nombre/correo electrónico de CRM.
- Si su cuenta es de prueba o ve el código 57 ("no autorizado"), verifique que el usuario que realiza la sincronización tenga los permisos requeridos tanto en Books como en CRM, y actualice los tokens OAuth para el conector antes de reintentar [1].
Cuándo escalar
Escale a Soporte de Zoho cuando los registros muestren un error interno del conector, cuando no pueda localizar los IDs de registro mencionados en los registros de sincronización, o cuando los permisos y mapeos sean correctos pero los envíos sigan fallando. Proporcione las entradas del registro de sincronización y los IDs de registro de CRM para acelerar el diagnóstico.
[1]: Publicaciones de la Comunidad Zoho que discuten errores de envío de Books–CRM y problemas de mapeo.
[2]: Ejemplos de hilos de la Comunidad de fallos de sincronización de Books–CRM y mapeo de contactos.