X12 transaction code
EDI 310 Freight Receipt and Invoice (Ocean) (X12 310)
EDI 310 is the X12 Freight Receipt and Invoice (Ocean) transaction set, used when ocean shipment charges are ready to bill. The ocean carrier sends the 310 to interested parties to the shipment, typically the shipper or freight forwarder, and can also use it to pass manifest information to a terminal operator.
- Standard
- X12
- Code
- 310
- Partner references
- 4
At a glance
EDI 310 at a glance
What the 310 carries, who sends it to whom, when it goes out, and the segments trading partners list for it.
| Document | X12 310 Freight Receipt and Invoice (Ocean) |
|---|---|
| Business record | Ocean-freight payable |
| Who sends it to whom | The ocean carrier sends the 310 to interested parties to the shipment, typically the shipper or freight forwarder, and can also use it to pass manifest information to a terminal operator. |
| When it is sent | An ocean carrier receives cargo for a booked shipment and issues the combined receipt and freight invoice covering that movement. |
| Match on | Carrier invoice, bill of lading and container references |
| Partner references | 4 trading partners in this directory |
Key segments in an EDI 310
The business segments that appear in at least half of the 5 partner document references listed below, most common first. The table leaves out envelope segments (ISA, GS, ST, SE, GE, IEA). Your partner guide sets which segments and elements your account must send.
| Segment | Name | Purpose | Partner references |
|---|---|---|---|
| B3 | Beginning Segment for Carrier's Invoice | To transmit basic data relating to the carrier's invoice. | 5 of 5 |
| N9 | Reference Identification | To transmit identifying information as specified by the Reference Identification Qualifier. | 5 of 5 |
| V1 | Vessel Identification | To provide vessel details and voyage number. | 5 of 5 |
| C3 | Currency | To specify the currency being used in the transaction set. | 5 of 5 |
| Y2 | Container Details | To specify container information and transportation service to be used. | 5 of 5 |
| N1 | Name | To identify a party by type of organization, name, and code. | 5 of 5 |
| N3 | Address Information | To specify the location of the named party. | 5 of 5 |
| N4 | Geographic Location | To specify the geographic place of the named party. | 5 of 5 |
| R4 | Port or Terminal | Contractual or operational port or point relevant to the movement of the cargo. | 5 of 5 |
| DTM | Date/Time Reference | To specify pertinent dates and times. | 5 of 5 |
Stacksync connects EDI documents such as the X12 310 to your ERP, CRM and databases with two-way sync. Read the EDI overview, check pricing and security, or book a demo to walk through your partner guide.
Implementation guide
X12 310 mapping and validation
X12 310 Freight Receipt and Invoice (Ocean) is used when ocean shipment charges are ready to bill. Preserve carrier invoice, bill of lading and container references so the ocean-freight payable in your business system stays connected to the original document.
Use the version and implementation guide agreed with your trading partner to confirm required fields and responses.
| Document or decision | Record and matching IDs | What to test |
|---|---|---|
| Match the business record | ocean-freight payable carrier invoice, bill of lading and container references |
|
| Update the receiving system | Processing the ocean-freight payable ID assigned by the receiving system and processing result |
|
| Check the processing result | Processing status for the ocean-freight payable Original document reference and matching response |
|
Implementation steps
-
Choose the starting event and owner
Decide which application acts when ocean shipment charges are ready to bill. Name the operational owner of the ocean-freight payable and the team that resolves rejected or ambiguous messages.
-
Keep record IDs connected
Map carrier invoice, bill of lading and container references. Confirm qualifiers, code lists, units and date/time meaning against the agreed X12 version and partner guide. Preserve the source reference alongside any new destination identifier.
-
Test failures before launch
Run the failure cases in the mapping table against realistic ocean-freight payable data. Check how the receiving system reports a rejection and how your team corrects it without creating a duplicate.
-
Track every document to completion
Record transport delivery and document validation separately from successful ocean-freight payable processing. Give unresolved errors an owner and check the receiving system before approving retries.
Go-live checklist
- An approved 310 sample and the agreed version and partner guide are available.
- The mapping tests pass with realistic ocean-freight payable data.
- Each submitted document can be traced through delivery, validation and processing in the receiving system.
- Your team knows how to investigate and recover a rejected or timed-out ocean-freight payable without processing it twice.
Document structure
X12 310 Freight Receipt and Invoice (Ocean) at the element level
The X12 310 reference contains 75 segment entries and 489 data elements; 78 are marked mandatory in this reference. Use the version and partner guide agreed for your account to confirm required fields.
- Segments
- 75
- Data elements
- 489
- Mandatory elements
- 78
| Segment | Elements | Mandatory |
|---|---|---|
| B3 | 14 | 5 |
| B2A | 2 | 1 |
| Y6 | 3 | 2 |
| G3 | 6 | 1 |
| N9 | 6 | 1 |
| M0 | 4 | 1 |
| M1 | 12 | 1 |
| C2 | 7 | 3 |
| C3 | 4 | 1 |
| Y2 | 10 | 2 |
| N1 | 6 | 1 |
| N2 | 2 | 1 |
- Invoice Number
- Shipment Method of Payment
- Date
- Net Amount Due
- Standard Carrier Alpha Code
- Transaction Set Purpose Code
- Authority
- Authorization Date
Find your trading partner for X12 310
4 partners, 5 channels. Choose a channel to inspect its listed document reference and implementation context.
Catalog breakdown
Where X12 310 Freight Receipt and Invoice (Ocean) appears in this catalog
The largest groups of classified 310 catalog entries are in logistics & transport and e-commerce & marketplaces.
By industry
- logistics & transport 4 channels
- e-commerce & marketplaces 1 channel
By network
- CTSI 1 channel
FAQ
EDI 310 questions
What is an EDI 310?
EDI 310 is the X12 Freight Receipt and Invoice (Ocean) transaction set. Trading partners use it when ocean shipment charges are ready to bill. It carries the data for the ocean-freight payable, and your system matches it on carrier invoice, bill of lading and container references.
Who sends an EDI 310 and who receives it?
The ocean carrier sends the 310 to interested parties to the shipment, typically the shipper or freight forwarder, and can also use it to pass manifest information to a terminal operator. Your trading partner agreement confirms the direction and version for your account.
When is an EDI 310 sent?
An ocean carrier receives cargo for a booked shipment and issues the combined receipt and freight invoice covering that movement. Your partner guide sets any deadline or schedule for the document.
What are the key segments in an EDI 310?
Across 5 partner document references listed here, the business segments that appear most often include B3 (Beginning Segment for Carrier's Invoice), N9 (Reference Identification), V1 (Vessel Identification), C3 (Currency), Y2 (Container Details), N1 (Name). Each partner guide sets which segments and elements your account must send.
What should I map for X12 310?
Start with carrier invoice, bill of lading and container references and the target ocean-freight payable. Define duplicate detection, allowed updates and response correlation before mapping individual fields. Use the partner guide to check required fields and their formats.
How should I test 310 error handling?
Reconcile charges for multiple containers to the bill total. Distinguish an additional charge from a replacement invoice for the same voyage. Also test a lost response after destination processing so that a retry cannot create an unintended duplicate or repeated adjustment.
Which partners list X12 310?
The directory on this page links 4 partner entries that list this message. Choose your partner and channel, then confirm which messages and versions your account requires.
How does 310 relate to other EDI messages?
Keep 310 business processing separate from transport receipt and technical validation. Agree which preceding record, response or reconciliation completes the ocean-freight payable workflow; confirm any required companion messages with your partner.
Connect EDI to your business systems
See how Stacksync can fit your enterprise EDI workflow. Bring one partner guide and a sample exchange to plan the system mapping, exception handling and production rollout.
