Statuts de livraison

Le statut d’une commande évolue tout au long de son cycle de vie, du retrait à la livraison finale.

Consulter le statut courant

GET /orders/fetch/{uid} retourne l’état actuel d’une commande.
GET /orders/history retourne l’historique complet des activités d’un colis.
GET /tasks/fetch-order/{id} retourne le statut d’un colis par son identifiant.

Être notifié des changements

Un événement est envoyé à votre webhook à chaque changement de statut d’un colis. Voir le guide Configurer un webhook.

{
  "status": "OnDelivery",
  "message": "The driver confirmed that he received all the parcels from the runsheet that contains the parcels and starts the parcels delivery",
  "data": { "...": "..." }
}

Valeurs de statut

Statut	Signification
`ToPick`	Le colis a été créé et attend d’être récupéré par un livreur
`PickFailed`	Le colis n’a pas pu être récupéré par le livreur chez le client
`Picked`	Le colis a été récupéré par le livreur et est en route vers l’entrepôt
`ToReceive`	Le colis a été récupéré et attend d’être réceptionné par le gestionnaire de stock
`AwaitingDelivery`	Le colis a été réceptionné à l’entrepôt par le gestionnaire de stock
`NotReceived`	Le colis n’a pas été réceptionné à l’entrepôt
`ToBeAssigned`	Le colis réceptionné a été mis dans une tournée et attend d’être assigné à un livreur
`Dispatched`	Le colis est dans une tournée et attend d’être assigné à un livreur
`Received`	Le colis est réceptionné à l’entrepôt et attend d’être livré
`ToHandOver`	La tournée contenant le colis a été assignée à un livreur et attend de lui être remise
`HandedOver`	Le colis a été remis au livreur pour livraison
`OnDelivery`	Le livreur a confirmé la réception des colis de la tournée et démarre la livraison
`Delivered`	Le colis a été livré avec succès au destinataire
`Successful`	La livraison a été confirmée par l’agent de réconciliation
`Failed`	La livraison a échoué
`Cancelled`	La livraison a été annulée
`NotCollected`	Le colis n’a pas été physiquement collecté par l’agent
`MoneyToCollect`	Le colis a été livré et réconcilié ; le montant reste à collecter
`ToReturn`	Le colis annulé et réconcilié attend d’être retourné au client
`RToBeAssigned`	Le colis est dans une tournée de retour et attend d’être assigné à un livreur
`RToHandOver`	Le colis a été remis au livreur pour un retour
`OnReturn`	Le colis est en cours de retour
`Returned`	Le colis a été retourné au client
`NotReturned`	Le retour du colis n’a pas pu être effectué
`SentBack`	Le retour du colis a été effectué avec succès par le livreur
`OutOfStock`	Le colis est temporairement indisponible en entrepôt
`Dropped`	L’agent de stock a confirmé le dépôt du colis à l’entrepôt par le livreur
`Archived`	Le colis a été archivé

Cette liste peut évoluer. Traitez les valeurs de statut comme des chaînes plutôt que comme une énumération strictement fermée dans votre code.

Bonnes pratiques

Combinez webhook et polling

Utilisez le webhook comme source principale de mise à jour, et GET /orders/fetch/{uid} comme filet de sécurité en cas de doute.

Getting Started

Guides d'intégration

Concepts

API Reference

Resources

Statuts de livraison

Consulter le statut courant

Être notifié des changements

Valeurs de statut

Bonnes pratiques

​Consulter le statut courant

​Être notifié des changements

​Valeurs de statut

​Bonnes pratiques

Consulter le statut courant

Être notifié des changements

Valeurs de statut

Bonnes pratiques