Ir al contenido principal

New - Integración con Alegra

La integración entre Clientify y Alegra permite sincronizar automáticamente la información comercial y administrativa entre ambas plataformas, manteniendo contactos, empresas, productos y presupuestos alineados y evitando duplicados.

Daniel avatar
Escrito por Daniel
Actualizado hace más de 2 semanas

¿Qué información se sincroniza?

La integración permite sincronizar las siguientes entidades:

  • Contactos

  • Empresas

  • Productos

  • Presupuestos

La información puede crearse o actualizarse desde cualquiera de las dos plataformas.

Sentido de la sincronización

La sincronización es bidireccional:

  • Alegra ↔ Clientify

    • Contactos

    • Empresas

    • Productos

    • Presupuestos

Los cambios realizados en una plataforma se reflejan en la otra.

Sincronización de contactos

Vinculación de contactos

Para evitar duplicados, los contactos se vinculan utilizando el siguiente orden:

  1. ID de Alegra, almacenado en el campo personalizado in_alegra

  2. NIF/CIF (identification en Alegra)

  3. Creación de un nuevo contacto si no existe coincidencia

⚠️ Nota importante:
Solo se sincronizan contactos que tengan identification (NIF/CIF) informado en Alegra.

Estados y tipo de contacto

Los tipos de contacto de Alegra se traducen en Clientify de la siguiente forma:

  • client → estado client

  • lead → estado cold-lead

  • Otros → estado other

Además, el tipo de contacto se asigna como:

  • Cliente actual

  • Cliente potencial

A todos los contactos sincronizados se les añade automáticamente la etiqueta alegra.

Sincronización de empresas

En Alegra, las empresas se gestionan como contactos de tipo provider.

Durante la sincronización:

  • Se crean o actualizan como empresas en Clientify

  • Se vinculan por NIF/CIF

  • Se guarda el ID de Alegra para futuras sincronizaciones

Sincronización de productos

Los productos se sincronizan de forma bidireccional entre ambas plataformas.

Requisitos

  • El producto debe tener informado el campo reference en Alegra.

  • Este campo se utiliza como SKU en Clientify.

Si un producto no tiene reference, no se sincroniza.

Sincronización de presupuestos

Los presupuestos se sincronizan de forma bidireccional.

Durante la sincronización:

  • Se identifican en Clientify con el código ALG-{id}

  • Se sincronizan:

    • Contacto o empresa asociada

    • Productos

    • Líneas del presupuesto

    • Fechas, observaciones e importe total

Al sincronizar un presupuesto, primero se asegura la existencia del contacto/empresa y de los productos asociados.

Modos de sincronización

La integración puede ejecutarse en dos modos:

  • Full: sincroniza todos los registros disponibles.

  • Modified: sincroniza solo los registros modificados en las últimas 25 horas.

Esto permite una migración inicial completa y posteriores sincronizaciones incrementales.

Resolución de conflictos

Cuando un registro existe en ambas plataformas:

  • Se comparan las fechas de última modificación.

  • El registro más reciente prevalece:

    • Si Clientify es más reciente → se actualiza Alegra.

    • Si Alegra es más reciente → se actualiza Clientify.

Webhooks y sincronización en tiempo real

La integración soporta webhooks para sincronización inmediata cuando se producen cambios en Clientify:

  • contact.saved

  • company.saved

  • product.saved

  • budget.saved

Estos eventos permiten reflejar los cambios en Alegra sin esperar a una sincronización programada.

Configuración de la integración

Requisitos

  • Cuenta activa de Alegra

  • API Token válido de Alegra

  • Contactos y empresas con NIF/CIF informado

  • Productos con reference (SKU)

Configuración en Clientify

  1. Accede a Integraciones en Clientify

  2. Selecciona Alegra

  3. Introduce:

    • Email del usuario de Alegra

    • API Token

  4. Guarda la configuración

Si las credenciales son correctas, la integración se activará automáticamente.

Campos personalizados automáticos

Al activar la integración, Clientify crea automáticamente los campos necesarios para almacenar:

  • ID de Alegra

  • Información de vinculación interna

Estos campos no requieren configuración manual.

Consideraciones importantes

  • Solo se sincronizan contactos y empresas con NIF/CIF.

  • Los impuestos de los productos se sincronizan y se mantienen asociados.

  • Los presupuestos siempre mantienen la referencia ALG-{id}.

  • En modo Modified solo se sincronizan cambios recientes (últimas 25 horas).

¿Ha quedado contestada tu pregunta?