Integrar operaciones logísticas con ERP Siesa: arquitectura, APIs y puntos de fallo

Por qué la integración ERP es el cuello de botella

Distribuidoras y operadores logísticos en Colombia dependen de Siesa ERP para inventario, cartera, facturación electrónica DIAN y rutas de despacho. El e-commerce, WMS móvil o marketplace externo que no refleja stock real genera sobreventa, devoluciones costosas y pérdida de confianza B2B.

La integración no es «un API call»: es modelo de consistencia — eventual vs strong —, manejo de excepciones (producto discontinuado, lista de precios por cliente, impuestos por municipio) y observabilidad cuando el middleware falla a las 2 a.m.

Conecta diseña adapters sobre contenedores aislados en infraestructura propia, con colas Redis y reintentos idempotentes. El ERP no debe recibir ráfagas síncronas desde el checkout en Black Friday.

Patrones de integración recomendados

Stock: polling incremental cada N minutos para catálogo masivo + webhook o evento push para SKUs críticos de alta rotación. Nunca confíes solo en batch nocturno si vendes same-day delivery.

Pedidos: e-commerce crea orden en estado pendiente → middleware valida stock y crédito en Siesa → confirma o rechaza en menos de 30 segundos. Timeout visible al usuario — no spinner infinito.

Maestros de producto: Siesa es source of truth para SKU, unidad de medida, impuestos. El canal digital es réplica read-only salvo atributos de marketing (descripción larga, SEO slug).

Facturación: separar flujo de pedido entregado vs factura electrónica emitida. Legalmente distintos; mezclarlos en un solo endpoint complica reversión de notas crédito.

Puntos de fallo que auditamos en cada proyecto

Duplicación de pedidos por reintento HTTP sin Idempotency-Key — el cliente ve un cargo; ERP registra dos albaranes.

Race condition en stock: dos compras del último unit simultáneas. Mitiga con reserva temporal en middleware o lock optimista en Siesa según capacidad del módulo.

Codificación de caracteres en nombres de cliente o dirección de entrega — guía de transporte ilegible, rechazo en última milla.

Ventanas de mantenimiento Siesa no comunicadas al canal digital — checkout caído sin banner. Sincroniza calendario IT con marketing.

Seguridad y red en integraciones

APIs hacia ERP no expuestas a internet sin VPN, Cloudflare Tunnel o allowlist IP. Web Checker 360 en subdominios api.* detecta puertos y TLS débiles antes de auditoría de cliente enterprise.

Credenciales de servicio rotadas trimestralmente; logs sin PII en texto plano. JSON Formatter en cliente para depurar payloads sin filtrarlos a SaaS externos.

Separación de entornos QA/prod con bases Siesa distintas — error clásico: tester crea pedido real porque apuntó URL de producción.

Próximos pasos con Conecta

Software a medida Conecta incluye discovery de módulos Siesa activos, mapa de entidades y plan de fases: lectura de stock → pedidos → facturación → reportes.

DevOps garantiza uptime del middleware, backups de cola y alertas cuando lag de sincronización supera umbral acordado (ej. 15 minutos).

Si hoy exportas CSV manual entre bodega y ERP, el ROI de integración se paga en un trimestre — calcula horas-hombre y errores de digitación antes de posponer.