X12 323 — Vessel Schedule and Itinerary

Le 323 transporte l'itinéraire d'un navire : escales prévues, fenêtres d'arrivée et de départ, lien voyage / service maritime.

Objet

Le 323 est émis par un armement maritime (ocean carrier) ou un opérateur portuaire pour publier l'horaire d'un navire sur un service liner : ports d'escale dans l'ordre, ETA / ETD par port, numéro de voyage, lloyd's number du navire, code de service. C'est la version structurée des Vessel Schedule publiés sur les sites des armements.

Il alimente les outils de visibilité supply-chain (CargoSmart, GTNexus, INTTRA, Project44) et les ERP des chargeurs qui ajustent leur cut-off de booking. Acquitté par 997, il est typiquement publié en mode broadcast vers tous les abonnés d'un service.

Structure d'enveloppe

Le 323 voyage à l'intérieur des trois niveaux d'enveloppe X12 (ISA/IEA, GS/GE avec functional group KS, et ST/SE). Exemple didactique en 004010 :

ISA*00*          *00*          *ZZ*OCEANCARRIER  *ZZ*BCO           *260514*0830*U*00401*000000323*0*P*>~
GS*KS*OCEANCARRIER*BCO*20260514*0830*1*X*004010~
ST*323*0001~
KS1*ACME-EAST-005*20260514~
V1*9876543*ACME EXPRESS*US*MSC*VOYAGE-EAST-005~
V9*AE*ACME EAST SERVICE~
LX*1~
R4*L*UN*USNYC*NEW YORK*US~
DTM*139*20260520*1800~
DTM*140*20260521*1400~
LX*2~
R4*P*UN*USCHS*CHARLESTON*US~
DTM*139*20260523*0600~
DTM*140*20260523*2000~
LX*3~
R4*P*UN*BRRIO*RIO DE JANEIRO*BR~
DTM*139*20260603*0700~
DTM*140*20260605*0200~
SE*15*0001~
GE*1*1~
IEA*1*000000323~

Segments courants

• Header — ST, KS1 (Beginning Segment for Vessel Schedule and Itinerary), V1 (Vessel Identification), V9 (Service Identification).
• Itinéraire — boucle LX par escale, avec R4 (Port or Terminal Identification : code UN/LOCODE), DTM*139 (ETA), DTM*140 (ETD).
• Détails — R4 qualifié L (Load), D (Discharge), P (Port of Call), T (Transshipment).
• Statut — ZC1 ou Q5 pour ajustements ultérieurs.
• Summary — SE.

Pièges courants

• UN/LOCODE obligatoire : R4 doit utiliser le code UN/LOCODE officiel (USNYC, USCHS) ; un libellé port en libre rend l'itinéraire inutilisable par les hub de visibilité.
• ETA vs ETB : DTM*139 est l'arrivée au port (rade) ; l'amarrage (berth) passe par un code distinct. Confondre fait dériver les cut-off de booking de 12-24h.
• Itinéraires multi-services : un même navire peut basculer entre services (loop AE → loop AE2 après mise en cale sèche) ; toujours utiliser V9 pour identifier le service de l'itinéraire publié.

Transactions liées

• 324
• 300
• 301
• X12 — Hub

Documentation

Le code 323 et le nom Vessel Schedule and Itinerary sont publics et listés sur x12.org/products/transaction-sets. La structure complète des loops, qualifiers et code-lists est distribuée par DISA via les Implementation Guides (TR3) propriétaires. ediverse.io ne couvre que les concepts publics, l'enveloppe et des exemples didactiques.