Integración

¡Bienvenido al área de integración de Demander! 🚀

Esta guía fue creada para ERPs y desarrolladores que necesitan integrar sus sistemas a nuestra fuerza de ventas.

Aquí entenderá, de forma directa:

Cómo funciona la integración con Demander.
Cuáles son los tipos de flujo de datos.
Qué mecanismos puede utilizar.
Y qué enfoque tiene más sentido para su escenario.

📌 Primero, comprenda si su escenario necesita integración

La mejor forma de trabajar con Demander es a través de la integración entre sistemas.

Cuando la empresa cuenta con un ERP integrado a Demander, el ERP debe ser el origen oficial de los datos de registro. En este caso, información como clientes, productos, vendedores y precios debe registrarse o modificarse en el ERP y enviarse a Demander a través de la integración.

Sin embargo, también es posible trabajar sin integración y realizar los registros directamente en Demander. Este escenario tiene sentido principalmente cuando la empresa no posee un ERP integrado o cuando determinado campo no es enviado por el ERP.

👉 Vea cómo identificar si su escenario debe utilizar alta manual o integración en el artículo Alta manual e integración con ERP.

🔄 ¿Cómo funciona la integración con Demander?

Si su escenario utiliza integración, es importante comprender que puede ocurrir en dos flujos independientes:

Envío de datos: información del ERP se envía a Demander.
Consulta de datos: información de Demander es consultada por el ERP.

No es necesario utilizar el mismo mecanismo para ambos flujos.

Esto es intencional y permite elegir la tecnología más adecuada para cada necesidad, considerando factores como volumen de datos, periodicidad, rendimiento y esfuerzo de implementación.

A continuación, explicamos cada uno de estos flujos y los mecanismos disponibles.

🔃 Tipos de flujos de datos

En Demander, es posible dividir la integración en dos flujos principales: envío de datos y consulta de datos.

Cada flujo tiene objetivos y características diferentes y en muchos escenarios es común utilizar tecnologías distintas para cada uno de ellos.

Comprender esta separación es importante para definir la mejor estrategia de integración, considerando factores como volumen de datos, periodicidad, rendimiento y esfuerzo de implementación.

A continuación se presentan los dos tipos de flujos utilizados en las integraciones con Demander.

Envío de datos a Demander (Datos del ERP → Demander)

Este es el flujo donde su ERP o sistema envía información a Demander.

Ejemplos:

Vendedores.
Clientes.
Productos.
Actualizaciones generales de registros.

👉 Aquí está alimentando la fuerza de ventas.

Consulta de datos en Demander (Datos de Demander → ERP)

En este caso, su sistema consulta datos de Demander para uso interno.

Ejemplos:

Pedidos realizados por los vendedores.
Clientes registrados por los vendedores.
Clientes modificados por los vendedores.
Otras opciones de recepción de datos en el ERP.

👉 Aquí está consumiendo datos de la fuerza de ventas.

💡 ¿Por qué separar envío y consulta?

Porque cada flujo tiene características diferentes.

El envío de datos:

Puede involucrar un gran volumen de datos.
Puede requerir validación de layout.
La periodicidad puede ser diferente entre empresas y segmentos.

La consulta de datos:

La periodicidad puede ser diferente entre empresas e segmentos.
Puede depender del modelo del ERP (código, estructura, esfuerzo, entre otras opciones).

Mecanismos de integración

Actualmente, Demander ofrece tres mecanismos de integración:

API de Archivo de Texto

Cómo funciona:

Integración basada en archivos de texto.
Codificación UTF-8.
Campos separados por barra vertical o pipe (|).
Cada línea es un registro/tabla, diferenciándose la tabla por el primer campo.
Los demás campos siguen el diseño específico de cada entidad.

Ejemplo simplificado:
18|123|Empresa Ejemplo|RUT/RFC|... (18 significa clientes, 123 sería el código del cliente y así sucesivamente para el resto de los campos)

✅ Puntos fuertes:

Alto rendimiento para grandes volúmenes de datos.
Facilita el procesamiento por lotes.
Libertad del ERP para parametrizar la periodicidad y manipulación interna.

⚠️ Puntos de atención:

La validación del formato corre por cuenta de la implementación.
Puede requerir mayor esfuerzo inicial de desarrollo.
Si el ERP no trabaja con archivos de texto, pueden presentarse dificultades iniciales.

📝 Documentación:

Sincronizador Demander

El Sincronizador Demander es un ejecutable en Java que actúa como puente entre su base de datos y la fuerza de ventas.

En resumen, funciona como una interfaz para transformar los datos de la base de datos del ERP o de Demander en archivos de texto (en el formato de layout de Demander).

Internamente, el Sincronizador utiliza la API de archivos de texto, por lo que comparte algunos puntos positivos y de atención del mecanismo anterior.

Cómo funciona:

Instalado en un servidor o máquina con acceso a la base de datos del ERP.
Permite configurar scripts de: lectura, inserción y actualización.
Genera automáticamente archivos en el layout de Demander (depende directamente de los scripts).
También consume archivos de Demander ya listos.

👉 En la práctica: se conecta directamente a la base de datos y deja que el Sincronizador se encargue de la transformación de datos. Siendo necesario armar los scripts según el estándar de la base de datos y del layout de Demander.

✅ Puntos fortes:

Reduce significativamente el esfuerzo de desarrollo.
Automatiza la generación y lectura de archivos en el layout de Demander.
Ideal para quienes buscan rapidez en la implementación.

⚠️ Puntos de atención:

Dependencia de un ejecutable corriendo en el entorno.
Si la instalación está en la nube, existen ciertas dificultades en algunos escenarios de instalación.
En algunos procesos más complejos pueden surgir dificultades (inserción de pedidos e ítems del pedido).

📝 Documentación:

Sincronizador de Demander

API REST (JSON)

La API REST de Demander permite integrar datos mediante peticiones HTTP utilizando JSON.

Es el mecanismo de integración más reciente de Demander, por lo que no cuenta con todos los endpoints homologados, pero se implementarán nuevos endpoints según la demanda.

✅ Puntos fuertes:

Estándar moderno de integración (HTTP + JSON).
Permite mayor control en la lógica de la aplicación.

⚠️ Puntos de atención:

Puede no ser ideal para grandes volúmenes.
Aún en evolución (nuevos endpoints según la demanda).

📝 Documentación:

API de integración de Demander

💡 Sugerencias para diferentes escenarios

Como ya se ha comentado, entendemos la integración como algo que debe evaluarse de acuerdo con la realidad de cada aplicación y empresa, por lo que en esta sección sugerimos mecanismos de integración para diferentes flujos y realidades empresariales.

Menos trabajo, más resultados

Con el objetivo de implementar una integración funcional y sencilla, la sugerencia de Demander es utilizar el Sincronizador Demander para ambos flujos.

Construir las consultas de selección de datos de acuerdo con el layout de ERP-Demander y crear scripts de inserción de datos para tablas principales o temporales, para luego leer en las tablas de producción mediante alguna rutina interna del propio sistema tercero.

Más independencia para el tercero

Si el objetivo es garantizar mayor independencia y capacidad de decisión para su aplicación, la sugerencia de Demander es utilizar una de las APIs de integración, según su preferencia tecnológica.

En este formato, es posible controlar la periodicidad y qué datos se envían, además de poder crear pantallas dentro de la aplicación para ayudar a los usuarios, soporte y posibles evoluciones, aunque aumente la complejidad.

Escenario más común

A medida que surgen nuevas integraciones, es posible notar un patrón que funciona muy bien y asegura un trabajo considerablemente menor, al tiempo que entrega una gran independencia al tercero.

Este patrón es la sugerencia más común de Demander: dividir los flujos de integración y trabajar con mecanismos diferentes.

Para el envío de datos del ERP a Demander, trabajar con el Sincronizador Demander. Dado que no es necesario crear código con publicaciones, solo instalar el ejecutable, conectar la base de datos y crear los scripts de selección de datos según el layout.

Para la consulta de datos de Demander al ERP, trabajar con una de las APIs de integración, según su preferencia tecnológica. Dado que la inserción de datos en el ERP puede ser controlada con mayor independencia por el tercero, facilitando el soporte y posibles evoluciones, además de garantizar la calidad de los datos que ingresan al sistema.

🔗 Integraciones con ERPs ya estandarizadas

Además de las opciones de integración presentadas en este artículo, Demander cuenta con integraciones ya estandarizadas con algunos ERPs.

Estas integraciones existen para facilitar la implementación y reducir el esfuerzo necesario para desarrollar y mantener una integración desde cero. Cuando el ERP ya cuenta con una integración estandarizada con Demander, parte de las reglas, estructuras y procesos necesarios ya está definida.

Esto permite que la empresa aproveche una integración ya preparada para ese ERP, en lugar de tener que construir toda la comunicación entre los sistemas de forma personalizada.

👉 Si utiliza un ERP que ya cuenta con una integración estandarizada con Demander, consulte el menú Integraciones nativas con ERPs relacionado con este artículo para verificar las opciones disponibles y comprender cómo funciona cada integración.

💬 ¿Tiene dudas sobre si su ERP cuenta con una integración estandarizada con Demander? Póngase en contacto con nuestro equipo. Estamos a su disposición para ayudar a identificar el mejor camino para su escenario.

🛒 Integraciones con sistemas de e-commerce

Demander también se puede integrar con sistemas de e-commerce.

Este tipo de integración tiene necesidades diferentes a las de una integración tradicional con un ERP. Además del envío y recepción de datos de registros, pueden existir procesos específicos relacionados con el catálogo de productos, clientes, precios, pedidos y demás información utilizada entre el e-commerce y la fuerza de ventas.

Por eso, las integraciones con e-commerce cuentan con documentación propia, con orientaciones específicas para este escenario.

👉 Si su objetivo es integrar Demander con una plataforma de e-commerce, consulte el menú Integración con e-commerces relacionado con este artículo para conocer las opciones disponibles y comprender cómo funciona este escenario.

💬 ¿No está seguro de si su sistema se ajusta a este escenario? Póngase en contacto con nuestro equipo. Podemos ayudar a comprender las características de su plataforma e indicar el camino más adecuado.