Integración del ERP con una plataforma externa de pedidos

Problema

Los clientes de una distribuidora hacen sus pedidos en una plataforma que no es el ERP. Sin integración, alguien vuelve a teclear lo mismo en el otro lado y las direcciones de entrega y los maestros divergen en cuestión de meses. El fondo del asunto es que el formato de la plataforma lo decide otro, y cuando ese formato cambia, cambia sin pedir permiso.

Solución

La sincronización es bidireccional y cubre pedidos, direcciones de entrega y maestros. Corre sobre tareas de servidor programadas, sin que nadie tenga que lanzarla a mano.

Entre la API externa y el ERP hay un modelo propio de intercambio. Lo que llega de fuera se traduce primero a ese modelo y solo después se convierte en documentos y maestros de SAP Business One. Es una capa de más que parece ceremonia hasta el día en que la plataforma cambia el contrato de su API.

Cuando eso ocurre, el cambio se queda en la capa de traducción. El resto del add-on ni se entera: sigue hablando el idioma de dentro.

Arquitectura

Por qué está montado así

Metí en medio un modelo de intercambio propio. El formato externo no toca nunca las entidades del ERP, así que cuando la plataforma cambia su contrato el cambio se queda en una capa.

El cliente REST está aislado. La serialización y los reintentos no se mezclan con la lógica de negocio.

Sincroniza por tareas programadas, no por eventos de pantalla. El usuario no debería esperar a que responda un sistema que no controlamos.

Escribe contra el ERP por el SDK y no contra las tablas, para que las validaciones y la numeración las siga haciendo SAP.

Resultado

186 commits en este cliente.