ediverse

Type to search across standards, messages, tools and glossary.

ediverse Explore the platform

Spotlight PEPPOL BIS Billing 3.0 The EU e-invoicing mandate is here — France Sept 2026, Belgium Jan 2026, Germany 2025.

— 01

Foundations

— 02

Standards

— 03

Flagship messages

— 04

Tools

X12 310 — Freight Receipt and Invoice (Ocean)

The 310 carries freight receipt and invoice for an ocean shipment: confirmation of shipped cargo and invoice of carriage charges.

Purpose

The 310 documents, in a single transaction, the receipt (Mate's Receipt or B/L data) and the ocean invoice: loaded cargo line, containers, weight, charges (ocean freight, BAF / CAF, THC, documentation, port congestion surcharges), taxes and total.

It consolidates roles split in EDIFACT (IFTMCS for the notice + INVOIC for the invoice). Acknowledged by 997, it triggers shipper-side accounting. The 310 is the post-shipment financial instrument in the North American ocean-carrier circuit.

Envelope structure

The 310 travels within the three X12 envelope levels (ISA/IEA, GS/GE with functional group IO, and ST/SE). Didactic example in release 004010:

x12 example-310.x12 
ISA*00*          *00*          *ZZ*ACMECARRIER   *ZZ*ACMENVOCC     *260514*1430*U*00401*000000310*0*P*>~
GS*IO*ACMECARRIER*ACMENVOCC*20260514*1430*1*X*004010~
ST*310*0001~
B3**MAEU-7741230*PP*20260514*BL*MAEU-7741230*ACMECARRIER*USD~
N9*BM*MAEU-7741230~
N1*SH*ACME ELECTRONICS INC*92*S-0001~
N1*CN*ACME EU GMBH*92*C-0042~
N7*ULD*HLCU8741230*40HC~
R4*L*UN*USNYC*PORT OF NEW YORK*US~
R4*D*UN*DEHAM*HAMBURG*DE~
L0*1*22000*N*68*M3*22000~
L1*1*OCEAN FREIGHT*USD*3800.00~
L1*2*BAF*USD*420.00~
L1*3*THC ORIGIN*USD*325.00~
L3**N*22000**4545.00~
SE*12*0001~
GE*1*1~
IEA*1*000000310~

Common segments

  • Header — ST, B3 (Beginning Segment for Carrier's Invoice), N9*BM (B/L number), DTM.
  • Parties — N1 (SH, CN, NT, FW).
  • Equipment — N7 (Container ISO type).
  • Routing — R4*L / R4*D.
  • Charges — L0 (Weight / Volume), L1 (Rate and Charges, repeated per line).
  • Summary — L3 (Total Weight and Charges), SE.

Common pitfalls

  • Currency and exchange rate: B3 carries the default currency; for charges billed in local currency (port congestion in EUR for example), L1 must carry the explicit currency, otherwise L3 total is computed in a wrong mixed currency.
  • THC origin vs destination: explicitly encode L1*THC ORIGIN and L1*THC DESTINATION; rolling both into a single THC makes reconciliation impossible on the shipper side.
  • B/L number: N9*BM is the reconciliation key with the upstream 304 — a mismatch triggers a manual dispute at the carrier.

Documentation

The code 310 and the name Freight Receipt and Invoice (Ocean) are public and listed on x12.org/products/transaction-sets. The complete structure of loops, qualifiers and code lists is distributed by DISA via the proprietary Implementation Guides (TR3). ediverse.io covers only public concepts, the envelope and didactic examples.