Logística: integraciones que fallan de forma controlada.
Un escenario para sistemas de pedidos, tarifas, etiquetas y tracking que dependen de terceros.
Contexto de negocio
Una API de transportista no es una dependencia bajo el control del equipo. Tarifas, etiquetas y actualizaciones pueden llegar tarde, fallar o repetirse. El sistema necesita distinguir un retraso recuperable de una operación que requiere revisión humana.
Riesgos que evaluamos
Reintentos ilimitados, consumo de cuota, creación de etiquetas duplicadas, trabajos sin timeout, colas sin métricas y estados de pedido que no reflejan el fallo de una integración.
Plan de intervención
Mapear operaciones y estados. Revisar timeouts, reintentos con backoff, idempotencia y dead-letter queues. Agregar trazabilidad por pedido y alertas de antigüedad de cola. Probar fallos simulados de la API en un entorno controlado y acordar el procedimiento de reproceso.
Entregables
Mapa de integraciones; política de timeouts y reintentos; propuesta de idempotencia; alertas y métricas de cola; runbook de reproceso y conciliación.
Cómo se valida
Al simular timeout y respuestas repetidas, los pedidos deben conservar su estado y evitar efectos duplicados en el alcance probado. Medir profundidad y antigüedad de cola y comprobar el reproceso de mensajes. Los cambios en código de negocio se cotizan por separado del diagnóstico de infraestructura.