20 de junio de 20267 min lectura

Visibilidad de embarques: normalice eventos antes de añadir un agente

QD

Por Equipo Quantum Developers

Monitor con tarjetas de buque, avión y almacén conectadas a un contenedor central, junto a un sello físico verde sin texto.
Compartir

Un agente de monitoreo solo puede gobernarse si cada cambio del embarque conserva identidad, tiempo del evento, fuente, vocabulario y evidencia; una ETA sin ese linaje es una opinión difícil de auditar. Antes de pedir predicciones o resúmenes, la organización debe lograr que eventos de naviera, aerolínea, almacén y sensor hablen de un mismo objeto sin borrar quién afirmó qué.

El problema no es falta de mapas

Muchas torres de control muestran un punto y una fecha estimada. La dificultad aparece cuando dos participantes reportan estados distintos, una actualización llega tarde o un evento corrige otro. Si el tablero sobrescribe el valor anterior, operaciones pierde la secuencia que permitiría decidir.

“Embarque” tampoco es una identidad suficiente. Puede referirse a reserva, documento, unidad logística, contenedor, pieza, vuelo o tramo. Una alerta debe decir qué objeto cambió y qué relación lo conecta con el resultado que el equipo controla.

Qué aportan tres estándares y qué no resuelven solos

El estándar GS1 EPCIS estructura visibilidad mediante las dimensiones qué, cuándo, dónde, por qué y cómo, con vocabulario de contexto empresarial. Es útil para eventos sobre objetos físicos o digitales y su cadena de custodia.

IATA ONE Record define para carga aérea un modelo común, una API y una especificación de seguridad; mantiene datos en la fuente y permite al propietario controlar acceso. Su “registro único” es una vista enlazada del embarque, no una orden para copiar todo a una base central.

El estándar DCSA Track & Trace ofrece procesos, estructuras de evento y APIs para seguimiento de contenedores a través de fases marítimas. Aporta vocabulario sectorial para eventos como transporte, equipo y embarque.

Los tres reducen ambigüedad dentro de sus ámbitos, pero no garantizan que una empresa vincule correctamente un evento aéreo con una orden interna o conserve la evidencia original. Esa es responsabilidad de la capa operativa.

Sobre canónico de evento logístico

No fuerce todos los mensajes a un esquema gigante. Cree un sobre pequeño y mantenga el payload original mediante referencia.

Campo Función
event_id identidad del hecho recibido; soporta deduplicación
source_system y source_party quién publicó y desde qué sistema
source_standard/version EPCIS, ONE Record, DCSA u otro vocabulario
object_type/object_id pieza, unidad logística, contenedor, envío o reserva
occurred_at/timezone cuándo ocurrió en el mundo operativo
received_at cuándo la plataforma lo conoció
event_type/business_step qué ocurrió en vocabulario canónico y original
location_id dónde ocurrió, con sistema de identificación
related_objects relaciones con orden, tramo, documento y transporte
evidence_ref mensaje original, documento o lectura permitida
supersedes_event_id corrección explícita sin borrar historia
confidence/origin dato declarado, sensor, cálculo o inferencia

Separar occurred_at de received_at permite detectar latencia y ordenar correctamente. Un evento recibido después puede describir un hecho anterior. La línea de tiempo debe conservar ambos.

Mapeo práctico a una línea de ejecución

El siguiente mapeo no afirma equivalencia normativa; es un contrato operativo para integrar conceptos:

Pregunta operativa GS1 EPCIS ONE Record DCSA Línea común
¿Qué cambió? objeto/evento objeto logístico shipment/equipment/transport event object_id + related_objects
¿Cuándo? eventTime evento o cambio del objeto eventDateTime occurred_at
¿Dónde? readPoint/businessLocation ubicación enlazada event location location_id
¿Por qué/contexto? businessStep/disposition tipo y relaciones del modelo eventType/classifier event_type + business_step
¿Quién lo afirma? fuente del repositorio/participante dueño del dato publisher source_party
¿Qué evidencia existe? evento capturado recurso y revisión mensaje de API evidence_ref + source version

Conserve el término original junto a la traducción canónica. Así una nueva versión del estándar puede remapearse sin reescribir la historia.

De evento a excepción accionable

Un evento no debería generar una alerta solo por ser nuevo. Aplique una regla de estado:

  1. valide identidad, versión y duplicado;
  2. actualice la proyección del objeto sin borrar eventos;
  3. compare el nuevo estado con plan, promesa o política;
  4. clasifique diferencia por acción requerida;
  5. asigne dueño, vencimiento y evidencia;
  6. cierre cuando una acción o evento posterior resuelva la condición.

Una ETA calculada debe registrarse como inferencia con versión, entradas y horizonte, separada de una ETA declarada por el transportista. Si ambas difieren, el agente puede explicar el conflicto y proponer prioridad; no debe fingir una única verdad.

Ejemplo ilustrativo multimodal

Este ejemplo es ilustrativo. Una unidad sale de almacén, viaja por carretera a terminal, cruza por mar y continúa por aire. Un evento EPCIS registra despacho de la unidad; DCSA reporta carga del contenedor; ONE Record actualiza un objeto de carga aérea.

La capa común no intenta convertirlos en el mismo evento. Los enlaza mediante relaciones: la unidad está contenida en el contenedor durante un tramo y asociada a la pieza aérea en otro. Cuando DCSA publica descarga tardía, la proyección detecta que el hito aéreo planificado ya no es alcanzable. El agente prepara una excepción con eventos fuente, diferencia frente al plan y alternativas permitidas. Operaciones decide reprogramar.

El valor no viene de “seguir tres veces”. Viene de preservar el cambio causal desde la fuente hasta la decisión y el resultado.

Gobierno del linaje entre participantes

Defina qué parte puede afirmar cada evento, cómo se autentica, cuánto se retiene y quién puede verlo. Un integrador no debe convertirse silenciosamente en autor. Las correcciones usan supersedes_event_id; nunca editan el pasado. Los datos sensibles permanecen referenciados y protegidos.

Revise métricas de calidad por fuente: completitud de campos obligatorios, latencia, duplicados, correcciones y objetos sin relación. No use cantidad de eventos como sinónimo de visibilidad. Mil mensajes sin identidad común pueden empeorar la operación.

Implementación en Quantum

Quantum Automation Center puede usar el objeto de negocio como eje, la línea de tiempo para eventos normalizados, artefactos y logs para evidencia permitida, y estados para excepciones. Permisos y aprobación humana controlan acciones; analíticas muestran latencia, calidad de fuente y resolución. Consulte monitoreo de embarques y la ontología de Quantum.

El agente debe leer esa historia y producir una recomendación trazable, no sustituirla con un resumen sin referencias.

El contrapunto: otro modelo canónico añade fricción

Es cierto. Una transformación adicional puede perder semántica, retrasar datos y crear un equipo central que bloquea cambios. Si obliga a cada socio a abandonar su estándar, el diseño fracasó.

Mantenga el sobre pequeño, versionado y extensible. Preserve payload y vocabulario originales, y traduzca solo los campos necesarios para identidad, orden, contexto y gobierno. Los equipos sectoriales siguen usando EPCIS, ONE Record o DCSA en profundidad.

Cuándo no construir esta capa

No la construya cuando una sola red y un estándar ya cubren el recorrido y las decisiones necesarias; configure ese estándar directamente. Tampoco use un agente para inventar eventos ausentes o “rellenar” fuentes crónicamente tardías. Una inferencia puede apoyar planificación, pero debe etiquetarse como tal.

Si no existe acuerdo para compartir datos, resuelva derechos y responsabilidad antes de integrar. Más tecnología no crea procedencia.

Prueba de trazabilidad antes del siguiente modelo

Seleccione una excepción cerrada y recorra resultado, decisión, eventos, relaciones y mensajes fuente. Cambie luego una traducción canónica y compruebe que puede reprocesar sin perder el original. Si la cadena se rompe, invierta en identidad y procedencia antes de entrenar otra predicción de ETA.

Sources