Entidades sincronizadas
Clientes
Sincronización bidireccional
GIAV (Gesintur) ↔ Clientify
Los clientes se sincronizan como:
Contactos o Empresas en Clientify, según su tipo.
Expedientes
Sincronización unidireccional
GIAV (Gesintur) → Clientify
Los expedientes se crean como oportunidades (deals) en Clientify.
Vinculación y deduplicación de clientes
Para evitar duplicados, la integración utiliza el siguiente orden de vinculación:
ID de Gesintur, almacenado en el campo personalizado
gesintur_idDocumento (NIF/CIF)
Creación de un nuevo registro si no existe coincidencia
⚠️ Importante
Solo se sincronizan clientes que tengan Documento (NIF/CIF) informado en Gesintur.
Persona vs Empresa
La integración determina automáticamente el tipo de registro en Clientify:
Si el cliente en Gesintur tiene tipo empresa → se crea una Empresa en Clientify
En cualquier otro caso → se crea un Contacto
Campos adicionales sincronizados en clientes
Además de los datos básicos, también se sincronizan:
Sede fiscal
Tipo de cliente, mapeado a:
Estado del contacto
Tipo de contacto
Consentimiento de email
Consentimiento RGPD
Estos valores se actualizan automáticamente desde Gesintur hacia Clientify.
Sincronización de expedientes como oportunidades
Cada expediente de Gesintur se sincroniza como una oportunidad (deal) en Clientify con la siguiente información:
Nombre de la oportunidad: número de expediente
ID del expediente: guardado en el campo personalizado
gesintur_expediente_idFecha de inicio: fecha de creación del deal
Estado del expediente: mapeado a la fase del pipeline en Clientify
Un mismo cliente puede tener varias oportunidades, una por cada expediente.
Modos de sincronización
La integración puede ejecutarse en dos modos:
Full
Sincroniza todos los clientes y expedientes disponibles.Modified
Sincroniza únicamente los registros modificados desde la última ejecución.
Paginación y rendimiento
La API de Gesintur utiliza paginación automática:
Tamaño de página por defecto: 100 registros
Control interno por índice de página
Esto permite sincronizar grandes volúmenes de datos de forma segura.
Requisitos técnicos adicionales
Para que la integración funcione correctamente:
Es obligatorio que los clientes tengan Documento (NIF/CIF).
La coincidencia del documento debe ser exacta.
Si existe un ID pero el documento no coincide, el registro no se actualiza.
Consideraciones importantes
Los consentimientos de email y RGPD siempre se sincronizan desde Gesintur.
Los tipos de cliente se traducen automáticamente a los estados de Clientify.
Los errores en un cliente o expediente no interrumpen el resto de la sincronización.
La integración utiliza la API SOAP de Gesintur.
