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

# Missions, commandes et colis

> Comprendre les entités centrales de l'API Paps

L'API Paps s'articule autour de trois entités principales : la **mission** (task), la **commande** (order) et le **colis** (parcel).

## Mission (task)

Une mission représente une opération logistique : retrait (`Pickup`), dépôt (`Dropoff`) ou livraison depuis un stock Paps (`FromStock`).

Vous créez une mission avec `POST /tasks` en précisant le type, le véhicule souhaité, le destinataire et les colis concernés. Voir [Créer une mission](/guides/create-task).

```json theme={null}
{
  "type": "Pickup",
  "vehicleType": "SCOOTER",
  "datePickup": "2026-08-01",
  "timePickup": "11:00",
  "address": "Dakar-Plateau, Dakar, Sénégal",
  "receiver": { "...": "..." },
  "parcels": [{ "...": "..." }]
}
```

## Commande (order)

Une commande est le suivi d'une mission une fois prise en charge par Paps. Vous la consultez via `GET /orders/fetch/{uid}` avec l'UID retourné lors de la création, et la reprogrammez via `POST /orders/fetch/{uid}/reschedule`.

## Colis (parcel)

Un colis (`ParcelDTO`) décrit un objet à transporter : format, description, prix, montant à collecter et informations de retrait. Chaque mission peut contenir plusieurs colis.

Vous consultez le statut d'un colis via `GET /tasks/fetch-order/{id}`.

## Relations entre les entités

```mermaid theme={null}
flowchart LR
    A[Mission créée] --> B[Colis rattachés à la mission]
    B --> C[Commande générée par Paps]
    C --> D[Suivi du statut]
    C --> E[Bordereau généré]
    D --> F[Notification via webhook]
```

Une mission regroupe un ou plusieurs colis. Une fois prise en charge, elle donne lieu à une ou plusieurs commandes suivies indépendamment.