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 --> CLOSED
    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 : 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).
• CLOSED : statut terminal du cas normal, atteint directement depuis TRANSIT dès que la signature de livraison est effectuée — aucun palier DELIVERED intermédiaire. Une pièce jointe de type POD (preuve de livraison) est attachable à tout moment, comme n'importe quel autre type de pièce jointe, mais n'a aucun effet sur le statut — voir Pièces jointes & PDF.
• DELIVERED : statut historique, non atteignable par un nouveau document — conservé uniquement pour les documents qui l'ont atteint avant la refonte du modèle de statuts ; ceux-ci transitionnent vers CLOSED de la même façon (DELIVERED --> CLOSED).
• 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.