Aperçu du cas d'utilisation

Une grande entreprise de logistique nécessite une visibilité en temps réel pour les opérations de camionnage. La visibilité permet aux expéditeurs et aux parties prenantes de suivre les livraisons à différents niveaux, garantissant une transparence dans les mouvements logistiques.

Remarque : OneRail prend en charge le suivi de la visibilité, mais ne fournit pas de services d'itinéraire.

Dans cette structure :

• shipmentId → Représente l'identifiant client pour l'ensemble du chargement.
• orderId → Représente une commande client sur le chargement.

Étapes de mise en œuvre

Configurer la visibilité avec l'API OneRail

Créer une livraison de visibilité

Utilisez le point de terminaison /visibility/create pour initialiser le suivi de visibilité pour le chargement.

Champs minima requis :

• orderId → Identifiant unique pour une commande client
• SCAC → Code Alpha Standard du transporteur pour l'identifier

Si une visibilité au niveau du chargement est requise, un shipmentId doit également être inclus.

Pour plus d'informations sur ce point de terminaison, reportez-vous à la référence Swagger suivante : Créer une visibilité.

Ajouter des livraisons individuelles

Chaque livraison au sein du chargement peut également être ajoutée individuellement en utilisant /visibility/{orderId}/add-deliveries.

Pour plus d'informations sur ce point de terminaison, reportez-vous à la référence Swagger suivante : Ajouter des livraisons à la visibilité.

Suivi des événements en temps réel

Exploitez les événements de visibilité pour tenir les parties prenantes informées.

• PICKED_UP → Le chargement est chargé à l'origine.
• EN_ROUTE_TO_DELIVERY → Le camion est en transit vers la destination.
• DELIVERED → La commande a été livrée avec succès.
• GEO → Envoie des mises à jour de position GPS en temps réel lorsque c'est pris en charge.

Exemple de mise à jour d'événement (POST /visibility/{orderId}/event) :

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