> ## Documentation Index
> Fetch the complete documentation index at: https://docs.papslogistics.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Statuts de livraison

> Comment suivre l'évolution du statut d'une commande

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](/guides/configure-webhook).

```json theme={null}
{
  "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é                                                                 |

<Note>
  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.
</Note>

## Bonnes pratiques

<Steps>
  <Step title="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.
  </Step>
</Steps>