> ## 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.

# Suivre une commande

> Consultez le statut et l'historique d'une commande

Ce guide explique comment suivre l'évolution d'une commande après la création d'une mission.

## Consulter une commande par UID

**`GET /orders/fetch/{uid}`**

### Authentification

```http theme={null}
x-api-key: {{PAPS_API_KEY}}
```

### Paramètres de chemin

| Paramètre | Type   | Requis | Description                       |
| --------- | ------ | -----: | --------------------------------- |
| `uid`     | string |    oui | Identifiant unique de la commande |

### Exemple de requête

```bash theme={null}
curl https://{{BASE_URL}}/orders/fetch/{{ORDER_UID}} \
  -H "x-api-key: {{PAPS_API_KEY}}"
```

### Réponse — `200`

```json theme={null}
{
  "code": 200,
  "message": "Success",
  "error": null,
  "data": {
    "uid": "{{ORDER_UID}}",
    "createdAt": "2026-08-01T10:00:00.000Z",
    "type": "Delivery",
    "service": "Marketplace",
    "status": "OnDelivery",
    "address": {
      "city": "Dakar-Plateau",
      "address": "Plateau, Dakar"
    },
    "client": {
      "companyName": "John Corporation",
      "address": {
        "city": "Dakar",
        "address": "Cité Keur Gorgui",
        "region": "Dakar Region",
        "country": "Senegal"
      }
    },
    "parcels": [
      {
        "uid": "...",
        "description": "iPhone 13 Pro Max",
        "size": "XL",
        "status": "OnDelivery",
        "refClient": "4759XHG0MKH"
      }
    ],
    "receiver": {
      "firstname": "John",
      "lastname": "Doe",
      "phoneNumber": "+221770000000",
      "address": {
        "city": "Dakar-Plateau",
        "address": "Dakar-Plateau, Dakar, Sénégal"
      }
    },
    "mission": {
      "jobType": "Pickup"
    },
    "deliveryTask": {
      "taskDriver": {
        "firstname": "Amadou",
        "lastname": "Diallo",
        "phoneNumber": "+221770000001"
      },
      "taskConveyor": null
    },
    "activities": [
      {
        "date": "2026-08-01T10:05:00.000Z",
        "triggerAction": "StatusUpdated",
        "triggerActionData": {}
      }
    ]
  }
}
```

### Champs de réponse

| Champ          | Type   | Description                                                               |
| -------------- | ------ | ------------------------------------------------------------------------- |
| `uid`          | string | Identifiant unique de la commande                                         |
| `createdAt`    | string | Date de création                                                          |
| `type`         | string | Type de commande                                                          |
| `service`      | string | Service à l'origine de la commande                                        |
| `status`       | string | Statut courant. Voir [Statuts de livraison](/concepts/delivery-statuses). |
| `address`      | object | Adresse de livraison (`city`, `address`)                                  |
| `client`       | object | Informations du client émetteur                                           |
| `parcels`      | array  | Colis associés à la commande                                              |
| `receiver`     | object | Informations du destinataire                                              |
| `mission`      | object | Type de mission d'origine (`jobType`)                                     |
| `deliveryTask` | object | Livreur assigné (`taskDriver`) et convoyeur (`taskConveyor`)              |
| `activities`   | array  | Historique des changements de statut                                      |

## Consulter l'historique d'activité d'un colis

**`GET /orders/history`**

### Paramètres de requête

| Paramètre   | Type   | Requis | Description                                                           |
| ----------- | ------ | -----: | --------------------------------------------------------------------- |
| `sourceUid` | string |    oui | Identifiant source du colis ou de la commande                         |
| `context`   | string |    oui | `Order`, `Parcel`, `Task`, `Request`, `Runsheet`, `User` ou `Default` |

### Exemple de requête

```bash theme={null}
curl "https://{{BASE_URL}}/orders/history?sourceUid={{ORDER_UID}}&context=Order" \
  -H "x-api-key: {{PAPS_API_KEY}}"
```

## Consulter le statut d'un colis

**`GET /tasks/fetch-order/{id}`**

### Paramètres de chemin

| Paramètre | Type   | Requis | Description          |
| --------- | ------ | -----: | -------------------- |
| `id`      | string |    oui | Identifiant du colis |

### Réponse — `200`

```json theme={null}
{
  "code": 200,
  "message": "Success",
  "error": null,
  "data": {
    "_id": "...",
    "uid": "...",
    "status": "OnDelivery",
    "updatedAt": "2026-08-01T10:05:00.000Z",
    "description": "iPhone 13 Pro Max",
    "quantity": 1,
    "value": 10000,
    "size": "XL",
    "refClient": "4759XHG0MKH"
  }
}
```

### Champs de réponse

| Champ         | Type   | Description                     |
| ------------- | ------ | ------------------------------- |
| `_id`         | string | Identifiant interne du colis    |
| `uid`         | string | Identifiant unique du colis     |
| `status`      | string | Statut courant du colis         |
| `updatedAt`   | string | Date de dernière mise à jour    |
| `description` | string | Description du colis            |
| `quantity`    | number | Quantité                        |
| `value`       | number | Valeur déclarée du colis        |
| `size`        | string | Format du colis                 |
| `refClient`   | string | Référence fournie par le client |

## Notes et règles métier

* Privilégiez les [webhooks](/guides/configure-webhook) pour être notifié en temps réel plutôt que d'interroger ces endpoints en boucle.
* Voir [Statuts de livraison](/concepts/delivery-statuses) pour le détail du cycle de vie d'une commande.