Descripción general del caso de uso

Una gran empresa de logística requiere visibilidad en tiempo real para las operaciones de carga de camión. La visibilidad permite a los remitentes y partes interesadas rastrear las entregas en diferentes niveles, garantizando la transparencia en los movimientos logísticos.

Nota: OneRail admite el seguimiento de visibilidad pero no ofrece servicios de enrutamiento.

En esta estructura:

• shipmentId → Representa el designador del cliente para toda la carga de camión.
• orderId → Representa una orden del cliente en la carga de camión.

Pasos de implementación

Configurar la visibilidad mediante la API de OneRail

Crear una entrega de visibilidad

Use el endpoint /visibility/create para iniciar el seguimiento de visibilidad para la carga de camión.

Campos mínimos requeridos:

• orderId → Identificador único de una orden del cliente
• SCAC → Código de transportista alfabético estándar que identifica al transportista

Si se requiere visibilidad a nivel de carga de camión, también se debe incluir un shipmentId.

Para obtener más información sobre este endpoint, consulte la siguiente referencia de Swagger: Crear visibilidad.

Agregar entregas individuales

Cada entrega dentro de la carga de camión también puede agregarse individualmente mediante /visibility/{orderId}/add-deliveries.

Para obtener más información sobre este endpoint, consulte la siguiente referencia de Swagger: Agregar entregas a la visibilidad.

Seguimiento de eventos en tiempo real

Aproveche los eventos de visibilidad para mantener informadas a las partes interesadas.

• PICKED_UP → La carga de camión está cargada en el origen.
• EN_ROUTE_TO_DELIVERY → El camión está en tránsito hacia el destino.
• DELIVERED → La orden se ha entregado exitosamente.
• GEO → Envía actualizaciones de ubicación GPS en tiempo real cuando sea compatible.

Ejemplo de actualización de evento (POST /visibility/{orderId}/event):

  {
  "eventType": "PICKED_UP",
  "orderId": "MasterBOL123",
  "eventOn": "2025-02-01T08:00:00Z"
}