Skip to content

Cycle de vie d'un Freight Document

Le Freight Document (document de transport électronique) est l'entité centrale de l'API. Son cycle de vie suit une machine à états stricte — aucune transition en dehors de celles listées ci-dessous n'est possible.

stateDiagram-v2
    [*] --> DRAFT
    DRAFT --> ISSUED
    DRAFT --> CANCELLED
    ISSUED --> TRANSIT
    ISSUED --> CANCELLED
    TRANSIT --> DELIVERED
    TRANSIT --> DELIVERED_FOR_FURTHER_INSPECTION
    TRANSIT --> CANCELLED
    DELIVERED_FOR_FURTHER_INSPECTION --> INSPECTION_DONE
    DELIVERED --> CLOSED
    CLOSED --> [*]
    INSPECTION_DONE --> [*]
    CANCELLED --> [*]
  • DRAFT : le document existe mais n'a aucune valeur légale — modifiable librement.
  • ISSUED : un chauffeur a été assigné. Le document est facturé et son PDF officiel (v1) existe. L'e-CMR n'est pas encore établi : il le sera quand l'expéditeur (case 22) et le transporteur (case 23) auront signé à la prise en charge. Jusque-là, le PDF porte la mention « En attente des signatures de prise en charge ».
  • TRANSIT : la marchandise a été prise en charge (signature de collecte effectuée).
  • DELIVERED : la signature de livraison est effectuée. Le document reste dans ce statut 21 jours, la fenêtre où le destinataire peut encore émettre des réserves (CMR art. 30 : 7 jours pour les dommages non apparents, 21 jours pour un retard), puis passe automatiquement à CLOSED.
  • CLOSED : statut terminal, en lecture seule. Une pièce jointe de type POD (preuve de livraison) n'a aucun effet sur le statut — voir Pièces jointes & PDF.
  • DELIVERED_FOR_FURTHER_INSPECTION / INSPECTION_DONE : cas d'un litige/contrôle à la livraison, nécessitant une validation supplémentaire avant clôture définitive. Le mécanisme de déclenchement d'un litige n'est pas encore implémenté ; ces statuts existent dans le modèle mais restent structurellement inatteignables.
  • CANCELLED : annulation, possible uniquement depuis DRAFT, ISSUED ou TRANSIT.

Aucun document n'est jamais supprimé physiquement, y compris annulé — pour des raisons de conservation légale.