Qué información se sincroniza?
La integración permite sincronizar las siguientes entidades:
Contactos
Productos
Presupuestos
Los registros pueden crearse o actualizarse desde cualquiera de las dos plataformas.
Sentido de la sincronización
La sincronización es bidireccional:
Facturama ↔ Clientify
Contactos
Productos
Presupuestos
Los cambios realizados en una plataforma se reflejan en la otra.
Sincronización de clientes
Vinculación de clientes
Para evitar duplicados, la integración utiliza el siguiente orden de vinculación:
ID de Facturama, almacenado en el campo personalizado
in_facturamaRFC/NIF (
Rfcen Facturama ytaxpayer_identification_numberen Clientify)Creación de un nuevo registro si no existe coincidencia
⚠️ Importante:
Solo se sincronizan clientes que tengan RFC informado en Facturama.
Persona vs Empresa
La integración determina automáticamente si un cliente se sincroniza como contacto o empresa en Clientify en función del formato del RFC:
RFC de persona física → Contacto
RFC de empresa → Empresa
Datos sincronizados
Entre otros, se sincronizan los siguientes datos:
Nombre o razón social
RFC/NIF
Email
Dirección completa
Ciudad, estado y código postal
Sincronización de productos
Los productos se sincronizan de forma bidireccional.
Requisitos
El producto debe tener informado el campo IdentificationNumber en Facturama.
Este campo se utiliza como SKU en Clientify.
Si un producto no tiene IdentificationNumber, no se sincroniza.
Datos sincronizados
Nombre del producto
SKU
Precio unitario
Sincronización de presupuestos
Los presupuestos (estimates) se sincronizan de forma bidireccional entre ambas plataformas.
Durante la sincronización:
Se vinculan al cliente o empresa correspondiente.
Se sincronizan los productos incluidos en el presupuesto.
Se mantienen importes y datos principales del documento.
Antes de crear un presupuesto, la integración valida que:
Exista el cliente/empresa asociado.
Existan los productos vinculados.
Modos de sincronización
La integración puede ejecutarse en dos modos:
Full
Sincroniza todos los registros disponibles.Modified
Sincroniza únicamente los registros modificados desde la última ejecución.
Esto permite una carga inicial completa y posteriores sincronizaciones incrementales.
Mecanismo de sincronización
El proceso de sincronización sigue estos pasos:
Consulta de registros en Facturama mediante paginación.
Búsqueda de coincidencias en Clientify por ID o RFC.
Creación o actualización del registro correspondiente.
Validación de datos obligatorios.
Continuación del proceso aunque existan errores puntuales.
Configuración de la integración
Requisitos
Cuenta activa de Facturama
Usuario y contraseña válidos
Clientes con RFC válido
Productos con IdentificationNumber
Configuración en Clientify
Accede a Integraciones en Clientify
Selecciona Facturama
Introduce:
Usuario de Facturama
Contraseña de Facturama
Guarda la configuración
Si las credenciales son correctas, la integración se activará automáticamente.
Compatibilidad y requisitos técnicos
Compatibilidad
La integración utiliza la API oficial de Facturama.
Compatible con las versiones actuales del sistema.
Paginación
La API de Facturama utiliza paginación:
Lotes de 100 registros
Control automático del avance por páginas
Consideraciones importantes
Solo se sincronizan clientes con RFC válido.
El RFC debe coincidir exactamente para actualizar un registro existente.
Los productos sin SKU (IdentificationNumber) se omiten.
Si las credenciales son incorrectas, la sincronización se detiene y se registra el error.
Los errores puntuales no bloquean el resto del proceso.