Pedidos mayoristas farmacéuticos integrados con ERP

Una plataforma de pedidos B2B para la distribución farmacéutica mayorista: un miniprograma para compradores, una consola de operador y una API Spring Boot. Tareas programadas traen productos y stock del ERP del distribuidor y le devuelven pedidos y clientes, con reintentos.

EN BREVE: Construimos pedidos en autoservicio para un mayorista farmacéutico mientras el ERP del distribuidor seguía siendo el sistema de referencia: tareas programadas traen catálogo y stock, devuelven pedidos y clientes con reintento y consultan el estado de los documentos hasta que la mercancía sale y se emiten las facturas.

Resumen

Farmacias y clínicas hacen sus pedidos desde un miniprograma. Los operadores gestionan productos, acreditaciones de compradores, pedidos y posventa en una consola web. Productos, stock y facturas siguen saliendo del ERP, y la plataforma solo envía pedidos pagados y aprobados y sus clientes.

Flujo de integración: el miniprograma de compradores y la consola de operador usan la API de la plataforma; tareas programadas traen del ERP los productos cada 30 minutos y el stock cada minuto, envían pedidos y clientes cada minuto con reintento y consultan el estado de los documentos cada 5 minutos, convirtiendo los albaranes de salida contabilizados en pedidos enviados y recuperando las facturas.

Problema

Los compradores mayoristas necesitaban pedir en autoservicio, pero el stock, la contabilidad y la facturación tenían que quedarse en el ERP. Los dos sistemas debían mantenerse coherentes a través de una especificación de interfaz publicada por el lado del ERP.

Restricciones

  • El ERP es el sistema de referencia para productos, stock, estado de documentos y facturas.
  • Las acreditaciones de los compradores se comprueban antes de la compra, incluido el reconocimiento de documentos en las licencias subidas.
  • Desarrollo y tests deben funcionar sin acceso real a pagos, logística, notificaciones ni ERP.

Arquitectura

ParteImplementación
BackendJava 17, Spring Boot 3.3, MySQL 8, Redis, almacenamiento de objetos compatible con S3, migraciones Flyway
ClientesMiniprograma de una plataforma de mensajería para compradores; consola de operador en Vue 3
Adaptador de ERPConmutable entre una simulación en memoria, que lleva los pedidos hasta “contabilizado” y genera facturas, y la implementación HTTP
CalendarioCatálogo cada 30 minutos; stock cada minuto; envío de pedidos y clientes con reintento cada minuto; consulta del estado de documentos cada 5 minutos
OperaciónPágina de integración en la consola con estado y logs de sincronización; sincronización, envío y consulta se pueden lanzar a mano

Decisiones clave

  1. Traer y consultar, sin base de datos compartida. La plataforma llega al ERP solo a través de su interfaz publicada, así que un cambio de esquema en un lado no rompe el otro.
  2. Adaptadores con simulación primero. Pago, logística, notificaciones y ERP tienen cada uno su simulación, lo que permite ejecutar en local todo el ciclo de vida del pedido, facturación incluida, sin credenciales de los socios.
  3. Los secretos, fuera del repositorio. La CI ejecuta la verificación del backend, lint, comprobación de tipos, tests y build de la consola, además de un escaneo de secretos, y solo se suben ficheros de entorno de ejemplo.

Evidencias

  • 45 clases de test en el backend y 56 ficheros de migración.
  • Los documentos de despliegue en producción cubren publicación, rollback, rotación de secretos, copia de seguridad y restauración.

Límites

No se publican el volumen de pedidos, el número de compradores, la fecha de puesta en marcha ni las condiciones comerciales.

Preguntas frecuentes

¿Cómo se mantiene el stock sincronizado con el ERP?

Los productos se traen cada 30 minutos y el stock cada minuto. Pedidos y clientes se envían con reintento. El estado de los documentos se consulta cada 5 minutos.

¿Se puede desarrollar sin acceso al ERP real?

Un adaptador de ERP simulado reproduce el ciclo de vida de los documentos, facturación incluida.

¿Qué pasa cuando falla un envío al ERP?

El registro sigue en cola y se reintenta en la siguiente ejecución, que corre cada minuto. Los operadores ven los logs de sincronización y pueden lanzar un reintento desde la consola.