ediverse

Tapez pour rechercher dans les standards, messages, outils et glossaire.

ediverse Explorer la plateforme

À la une PEPPOL BIS Billing 3.0 L’obligation européenne d’e-invoicing arrive : France sept 2026, Belgique janv 2026, Allemagne 2025.

— 01

Fondamentaux

— 02

Standards

— 03

Messages phares

— 04

Outils

X12 313 — Shipment Status Inquiry (Ocean)

Le 313 interroge le statut d'un shipment ocean en cours — position du conteneur, étape ETA, événements port — auprès d'un transporteur ocean ou un opérateur portuaire.

Objet

Le 313 documente une question structurée sur le statut d'un container ou d'un BL : où est-il, quand arrive-t-il, quels événements ont été enregistrés. Il est typiquement émis par un freight forwarder ou un consignee qui interroge le transporteur ocean.

Il déclenche un 315 (Status Details Ocean) en réponse. Acquitté par 997. Largement remplacé par les API REST modernes (Maersk, MSC, Hapag-Lloyd), mais persiste dans les contrats existants.

Structure d'enveloppe

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

x12 example-313.x12 
ISA*00*          *00*          *ZZ*FORWARDER     *ZZ*OCEANCARRIER  *260515*1130*U*00401*000000313*0*P*>~
GS*IS*FORWARDER*OCEANCARRIER*20260515*1130*1*X*004010~
ST*313*0001~
B4*04*Q*20260515~
N9*BM*BL-2026-7788~
N9*EQ*MSCU1234567~
Q5*XB*20260515~
SE*7*0001~
GE*1*1~
IEA*1*000000313~

Segments courants

  • Header — ST, B4 (Beginning Segment for Inquiry or Reply).
  • Référence BL — N9*BM.
  • Référence Equipment — N9*EQ (Container number).
  • Status type — Q5*XB (Status reason — Bypass / Update).
  • Summary — SE.

Pièges courants

  • EDI vs API parity : un 313 doit retourner les MÊMES jalons que l'API de la compagnie ; un timeline divergent rend le carrier non auditable.
  • Container vs BL key : interroger par container number sans BL n'est pas toujours résolvable côté carrier ; toujours porter les deux clés.
  • Stale data : un 315 retour de plus de 6 h est considéré stale par les enterprise shippers ; documenter le timestamp du dernier event.

Transactions liées

Documentation

Le code 313 et le nom Shipment Status Inquiry (Ocean) 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.