Visión general

Sit.Sync.Smg es un servicio desasistido desarrollado a medida para ESOFITEC GLOBAL SOLUTIONS, S.L. que mantiene sincronizados los contactos de clientes y clientes potenciales de a3ERP con Salesmanago, la plataforma de marketing automation desde la que se lanzan las campañas comerciales.

Es un ejecutable Windows sin interfaz que se lanza desde una tarea programada. En cada ejecución sube a Salesmanago los contactos que han cambiado en a3ERP desde la vez anterior, baja a a3ERP las bajas de comunicaciones (opt-out) que los contactos han solicitado en Salesmanago y envía un correo con el resumen de lo ocurrido.

Qué problema resuelve#

Marketing segmenta las campañas en Salesmanago por etiquetas: empresa, representante, ruta, productos con mantenimiento vivo, mantenimientos dados de baja, fase comercial. Toda esa información vive en a3ERP, repartida entre la ficha del cliente, sus características de organización, sus contactos y las cuotas de mantenimiento de Sit.Sat. Sin sincronización habría que mantener a mano dos bases de datos que cambian a diario.

En sentido contrario, cuando un contacto se da de baja de las comunicaciones desde un correo de Salesmanago, a3ERP tiene que enterarse para no volver a escribirle desde el ERP. El sincronizador traslada ese opt-out a la casilla Enviar e-mail del contacto.

Qué hace en cada ejecución#

1. Subida (a3ERP → Salesmanago). Lee el registro de cambios que dejan los desencadenadores del diccionario, compone los datos de cada contacto afectado con la vista SalesmanagoContacts y crea o actualiza el contacto en Salesmanago con sus datos, propiedades y etiquetas. Fuerza el opt-out de los contactos obsoletos y de los correos que han sido sustituidos.
2. Bajada (Salesmanago → a3ERP). Consulta los contactos modificados en Salesmanago en el mismo periodo y traslada su estado de opt-out al campo ENVIAREMAIL de __CONTACTOS. Nunca crea contactos en a3ERP.
3. Notificación. Envía un correo con el resumen y los errores acumulados a la dirección configurada.

Existe además un modo masivo pensado para la primera puesta en marcha o para limpiezas globales: reexportar todos los contactos, bajar todos los opt-out o borrar en bloque las etiquetas que siguen un patrón. Se activa desde el fichero de configuración y, mientras está activo, sustituye a la ejecución normal.

Piezas que lo componen#

La vista es la pieza clave para soporte: el ejecutable no interpreta ni transforma los datos de negocio, solo los recoge de la vista y los sube. Si hay que cambiar qué propiedades o etiquetas se envían, basta con modificar la vista; el ejecutable no se toca. Lo único que hace el ejecutable por su cuenta es sanear los literales de las etiquetas para que Salesmanago los admita, como se explica en Datos sincronizados.

Identificación del desarrollo#

Contenido de esta documentación#

• Guía del usuario: para quien trabaja con los contactos desde Salesmanago o a3ERP; qué viaja, cuándo, qué significa cada etiqueta y qué hacer cuando algo no cuadra, sin detalle técnico.
• Funcionamiento: la ventana de sincronización, qué cambios se detectan, la subida, la bajada, el correo de resumen y el modo masivo.
• Datos sincronizados: campo a campo, qué se envía a Salesmanago y de dónde sale en a3ERP.
• Instalación y configuración: requisitos, componentes, tarea programada y el fichero appsettings.json.
• Resolución de problemas: dónde mirar, síntomas habituales, consultas SQL útiles y comportamientos conocidos.