Blog · BL-20

Diseña un producto de gestión de excepciones con datos de trazabilidad: de estados de paquetes a flujos de trabajo

La trazabilidad de múltiples transportistas requiere más que traducir estados de tránsito. Analiza la relación entre pedidos y paquetes, la normalización de eventos, los cambios de entrega estimada, la derivación de excepciones, las notificaciones y la conciliación.

Muestra el estado de la transportadora en la página de pedidos para ir más allá de la visibilidad básica. Identifica cuántos paquetes componen un pedido, cuáles presentan retrasos, qué direcciones necesitan corrección, cuándo contactar al cliente, quién gestiona aduanas o pérdidas, y cómo sincronizar estas acciones con el sistema de soporte.

Un debate sobre pedidos multipaquete en r/ecommerce detalla cómo los correos automáticos de distintos sistemas confunden a los clientes cuando reciben solo una parte de la compra. Este caso ilustra el primer obstáculo del modelo de datos: pedidos, shipment, package y tracking number no corresponden al mismo objeto.

Separa los pedidos de los paquetes físicos

Un pedido admite múltiples envíos, cada envío agrupa varios paquetes, y los paquetes pueden cambiar de guía, transferirse a transportistas locales, devolverse o reintentar entrega. Mantener un único tracking_number en la tabla de pedidos sobrescribirá el historial con cada actualización.

Estructura cuatro niveles de relación: el pedido almacena el compromiso comercial, shipment representa la operación logística, package define la unidad física y tracking identity vincula al transportista con la guía. Los eventos se asocian al identificador de rastreo y se consolidan en el paquete y el pedido. Al dividir envíos, presenta un progreso por pedido, como entregado 1/2 y otra unidad prevista para mañana.

Establece versiones explícitas para las relaciones de paquetes. Tras consolidaciones o reenvíos, los números previos suelen mantenerse activos; registra replaced_by, last_mile_tracking o vínculos de tipo parent-child sin tratar los códigos nuevos como pedidos independientes.

Normaliza eventos sin perder los datos originales del transportista

La documentación de FedEx Basic Integrated Visibility detalla eventos de escaneo, ventanas de entrega previstas, estados de retraso y motivos, indicando que no todas las guías devuelven estimaciones completas. Diseña sistemas compatibles con distintas fuentes y precisiones.

Agrupa los estados internos en fases como label_created, accepted, in_transit, out_for_delivery, delivered, exception, returning y unknown. Conserva el código original, la descripción, la ubicación, la hora del evento, el momento de recepción y la carga útil del transportista para auditorías.

Evita basar las reglas de normalización solo en descripciones de texto, ya que los proveedores modifican formatos y idiomas. Las actualizaciones de DHL Unified Tracking muestran cambios en marcas de tiempo y textos de eventos. Mapea códigos estables y deriva los valores desconocidos a una cola de revisión.

Diferencia las marcas de tiempo: event time indica el momento físico, received time cuando el sistema lo procesa y record time cuando se registra. GS1 EPCIS v2.0.1 distingue estas propiedades; adopta este límite para evitar alterar el orden cronológico de los datos.

Clasifica las excepciones con criterios operativos

Cada excepción exige acciones distintas: problemas de dirección requieren contactar al destinatario, demoras aduaneras piden factura comercial, y fallos de entrega admiten reprogramación. Mapea los eventos a una categoría de causa, un equipo responsable y un plazo límite.

Evalúa el contexto del pedido, como artículos de alto valor, cadena de frío o plazos estrictos. Los modelos automatizan la clasificación de texto, pero las políticas comerciales y las capacidades del transportista deben definir los reembolsos o reprogramaciones.

Una tarjeta de excepción procesable incluye:

  • El pedido con sus paquetes asociados y las cantidades completadas y pendientes.
  • El evento actual, la descripción del transportista, los tiempos de registro y la frescura de los datos.
  • La estimación de entrega anterior y nueva junto con el motivo del cambio; deja el campo vacío si falta la fuente.
  • La acción recomendada, el equipo responsable, el estado de notificación al cliente y la próxima revisión.
  • Las autorizaciones para reembolsos, reenvíos o cambios de dirección para prevenir errores operativos.

Combina webhooks y sondeos periódicos

DHL Shipment Tracking Unified Push ofrece actualizaciones por identificador de rastreo o cuenta, aunque la disponibilidad varía según el transportista y la región. Los webhooks reducen las consultas, pero pueden duplicar o desordenar mensajes.

Implementa claves de idempotencia para cada evento o genera huellas auditables combinando transportista, guía, código, hora y ubicación. Almacena el evento bruto antes de procesarlo de forma asincrónica. Utiliza sondeos para recuperar datos faltantes adaptando la frecuencia según el estado del envío.

La documentación de FedEx aconseja consultar únicamente según los requerimientos operativos y excluir los paquetes entregados de los rastreos masivos. Evalúa el costo total de los endpoints en función del ciclo de vida de los envíos. Consultar todos los pedidos cada 30 segundos desperdicia cuota y vulnera restricciones de los proveedores.

Prioriza las acciones del cliente sobre cada evento de escaneo

Enviar alertas por cada cambio de ubicación genera ruido. Informa sobre la recepción inicial, cambios significativos en fechas, requerimientos de acción, entregas en proceso y finalización. Agrupa las reglas a nivel de pedido para evitar mensajes duplicados.

Las notificaciones de excepciones deben detallar los hechos conocidos y los pasos siguientes. Emplea dominios verificables en enlaces de modificación para mitigar riesgos de suplantación.

Limita los datos personales en las vistas internas. Las instrucciones de uso de DHL Unified Tracking definen condiciones sobre el uso de rastreo, autorizaciones y retención de datos; revisa los acuerdos vigentes antes de integrar estas fuentes.

Comienza el MVP con una cola de excepciones

Comienza con una tienda, dos transportistas y los pedidos en tránsito recientes. Valida la relación multipaquete, la deduplicación y las excepciones principales antes de integrar herramientas de soporte. Deja las vistas de mapas y los modelos predictivos para etapas posteriores.

Mide la latencia de eventos, la proporción de estados desconocidos, la anticipación en la detección de anomalías y los tiempos de respuesta. Comprueba que el estado de entrega aplique a la totalidad de los paquetes.

El método de productos de reposición de inventario gestiona la oferta previa, la guía de recuperación de APIs atiende fallos de origen, y este producto de excepciones logísticas procesa los eventos posteriores al envío para cerrar el ciclo de atención.

Este contenido no confirma el lanzamiento de herramientas de rastreo en EveryInfra. El valor de los datos de trazabilidad radica en identificar incidencias específicas por paquete para delegar la solución en el equipo adecuado.