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 --> [*]
    INSPECTION_DONE --> [*]
    CANCELLED --> [*]
  • DRAFT : le document existe mais n'a aucune valeur légale — modifiable librement.
  • ISSUED : le document est émis, les parties sont notifiées, un crédit est consommé.
  • TRANSIT : la marchandise a été prise en charge (signature de collecte effectuée).
  • DELIVERED : livraison confirmée (signature de livraison effectuée).
  • 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.
  • 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.