Logística y datos
APIs y eventos en operación logística: webhooks, colas y trazabilidad
Diseño event-driven para despachos, recepciones e inventario: cuándo REST basta, cuándo cola, idempotencia y correlación entre sistemas.
14 min de lectura · Actualizado 2026-07-22
De polling a eventos: cuándo dar el salto
Polling cada 5 minutos a Siesa para «¿hay pedido nuevo?» funciona con 50 pedidos/día. Con 5.000 pedidos/día quema CPU ERP y llega tarde al transportador.
Modelo event-driven: Siesa o middleware emite evento PedidoConfirmado, InventarioAjustado, DespachoRealizado. Consumidores suscritos — WMS, TMS, e-commerce tracking — reaccionan sin preguntar constantemente.
REST síncrono sigue válido para consultas puntuales (saldo stock un SKU). Eventos para state changes que disparan acciones en cadena.
Webhooks vs message broker
Webhooks HTTP simples hacia partners con pocos endpoints y SLA claro. Reintentos exponenciales, firma HMAC en header, timeout 10 s.
Cola Redis/RabbitMQ interna cuando múltiples consumidores, orden parcial tolerado o picos absorbibles. Dead-letter queue para mensajes fallidos 5 veces — no perder despacho.
Nunca mezclar lógica crítica solo en webhook sin persistir evento — si receptor caído, necesitas replay desde log inmutable.
Idempotencia y correlación
EventId UUID en cada mensaje. Consumidor registra procesados y ignora duplicado — transportistas reenvían POST por timeout de red.
CorrelationId desde pedido web hasta guía transporte — soporte rastrea cadena completa en logs sin preguntar a tres proveedores.
JSON Formatter para inspeccionar payload de evento en soporte L1 antes de escalar a ingeniería — reduce MTTR.
Contratos de evento y versionado
Schema version en payload (eventVersion: 2). Consumidores antiguos ignoran campos nuevos; productores mantienen compatibilidad hacia atrás 90 días.
Catálogo documentado: tipo, campos obligatorios, ejemplo, frecuencia esperada. Onboarding de nueva transportadora sin llamada de 3 horas explicando JSON.
Testing: contract tests en CI simulan eventos desde fixtures — detecta ruptura antes de deploy viernes.
Operación y observabilidad Conecta
Dashboard lag de cola, tasa error webhook, age of oldest unprocessed message. Alertas PagerDuty/Slack cuando lag > umbral.
DevOps Conecta despliega brokers en LXC dedicados, backups de cola y tunnels Cloudflare para webhooks entrantes sin exponer IP origen.
Software a medida diseña taxonomía de eventos alineada a procesos Siesa reales — no copiar patrón de ecommerce genérico que ignora notas crédito ni consignación.
Ponlo en práctica ahora
Usa las herramientas gratuitas del Toolbox para validar tu configuración en minutos.
¿Necesitas que lo resolvamos contigo?
Un ingeniero de Conecta puede aplicar esto en tu operación: servicio relacionado o conversación directa.