Cargo Smart
/
Freight Receipt and Invoice (Ocean)
  • Specification
  • EDI Inspector
Stedi maintains this guide based on public documentation from Cargo Smart. Contact Cargo Smart for official EDI specifications. To report any errors in this guide, please contact us.
Go to Stedi Network
Cargo Smart logo

X12 310 Freight Receipt and Invoice (Ocean)

X12 Release 4010
Delimiters
  • ~ Segment
  • * Element
  • > Component
EDI samples
  • None included
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/cargo-smart/freight-receipt-and-invoice-ocean/01H5N50YJ1MH9TP159Z10NDBZS
Powered by
Build EDI implementation guides at stedi.com
Overview
ISA
-
Interchange Control Header
Max use 1
Required
GS
-
Functional Group Header
Max use 1
Required
heading
ST
010
Transaction Set Header
Max use 1
Required
B3
020
Beginning Segment for Carrier's Invoice
Max use 1
Required
B2A
030
Set Purpose
Max use 1
Required
N9
060
Reference Identification
Max use 15
Optional
V1
070
Vessel Identification
Max use 2
Required
N1 Loop
G61
170
Contact
Max use 3
Optional
R2
200
Route Information
Max use 13
Optional
C8 Loop
GE
-
Functional Group Trailer
Max use 1
Required
IEA
-
Interchange Control Trailer
Max use 1
Required
ISA

Interchange Control Header

RequiredMax use 1
Example
ISA-01
I01
Authorization Information Qualifier
Required
Identifier (ID)
00
No Authorization Information Present (No Meaningful Information in I02)
ISA-02
I02
Authorization Information
Required
String (AN)
Min 10Max 10
ISA-03
I03
Security Information Qualifier
Required
Identifier (ID)
00
No Security Information Present (No Meaningful Information in I04)
ISA-04
I04
Security Information
Required
String (AN)
Min 10Max 10
ISA-05
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2
Codes
ISA-06
I06
Interchange Sender ID
Required
String (AN)
Min 15Max 15
ISA-07
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2
Codes
ISA-08
I07
Interchange Receiver ID
Required
String (AN)
Min 15Max 15
ISA-09
I08
Interchange Date
Required
Date (DT)
YYMMDD format
ISA-10
I09
Interchange Time
Required
Time (TM)
HHMM format
ISA-11
I10
Interchange Control Standards Identifier
Required
Identifier (ID)
U
U.S. EDI Community of ASC X12, TDCC, and UCS
ISA-12
I11
Interchange Control Version Number
Required
Identifier (ID)
00401
Draft Standards for Trial Use Approved for Publication by ASC X12 Procedures Review Board through October 1997
ISA-13
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9
ISA-14
I13
Acknowledgment Requested
Required
Identifier (ID)
Min 1Max 1
0
No Acknowledgment Requested
1
Interchange Acknowledgment Requested
ISA-15
I14
Usage Indicator
Required
Identifier (ID)
Min 1Max 1
I
Information
P
Production Data
T
Test Data
ISA-16
I15
Component Element Separator
Required
String (AN)
Min 1Max 1
>
Component Element Separator

Functional Group Header

RequiredMax use 1
Example
GS-01
479
Functional Identifier Code
Required
Identifier (ID)
IO
Ocean Shipment Billing Details (310, 312, 980)
GS-02
142
Application Sender's Code
Required
String (AN)
Min 2Max 15
GS-03
124
Application Receiver's Code
Required
String (AN)
Min 2Max 15
Required
Date (DT)
CCYYMMDD format
Required
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format
GS-06
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9
GS-07
455
Responsible Agency Code
Required
Identifier (ID)
Min 1Max 2
T
Transportation Data Coordinating Committee (TDCC)
X
Accredited Standards Committee X12
GS-08
480
Version / Release / Industry Identifier Code
Required
String (AN)
004010
Draft Standards Approved for Publication by ASC X12 Procedures Review Board through October 1997

Heading

ST
010
Heading > ST

Transaction Set Header

RequiredMax use 1
Example
ST-01
143
Transaction Set Identifier Code
Required
Identifier (ID)
310
Freight Receipt and Invoice (Ocean)
ST-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9
B3
020
Heading > B3

Beginning Segment for Carrier's Invoice

RequiredMax use 1
Usage notes
Example
If either Delivery Date (B3-09) or Date/Time Qualifier (B3-10) is present, then the other is required
B3-01
147
Shipment Qualifier
Optional
Identifier (ID)
2
Sea Waybill
B
Bill of Lading for Individual Shipment
B3-02
76
Invoice Number
Required
String (AN)
Min 1Max 22
Usage notes
B3-03
145
Shipment Identification Number
Optional
String (AN)
Min 1Max 30
B3-04
146
Shipment Method of Payment
Required
Identifier (ID)
CC
Collect
MX
Mixed
PP
Prepaid (by Seller)
Required
Date (DT)
CCYYMMDD format
Usage notes
B3-07
193
Net Amount Due
Required
Numeric (N2)
Min 1Max 12
Usage notes
B3-09
32
Delivery Date
Optional
Date (DT)
CCYYMMDD format
B3-10
374
Date/Time Qualifier
Optional
Identifier (ID)
139
Estimated
140
Actual
B3-11
140
Standard Carrier Alpha Code
Required
Identifier (ID)
Min 2Max 4
Usage notes
Required
Date (DT)
CCYYMMDD format
Usage notes
B3-13
375
Tariff Service Code
Optional
Identifier (ID)
DD
Door-to-Door
DP
Door-to-Pier
PD
Pier-to-Door
PP
Pier-to-Pier
B2A
030
Heading > B2A

Set Purpose

RequiredMax use 1
Usage notes
Example
B2A-01
353
Transaction Set Purpose Code
Required
Identifier (ID)
00
Original
01
Cancellation
05
Replace
N9
060
Heading > N9

Reference Identification

OptionalMax use 15
Usage notes
Example
N9-01
128
Reference Identification Qualifier
Required
Identifier (ID)
BM
Bill of Lading Number
BN
Booking Number
CR
Customer Reference Number
CT
Contract Number
FI
File Identifier
FN
Forwarder's/Agent's Reference Number
IK
Invoice Number
PO
Purchase Order Number
RF
Export Reference Number
SI
Shipper's Identifying Number for Shipment (SID)
N9-02
127
Reference Identification
Required
String (AN)
Min 1Max 30
V1
070
Heading > V1

Vessel Identification

RequiredMax use 2
Usage notes
Example
At least one of Vessel Code (V1-01) or Vessel Name (V1-02) is required
If Vessel Code Qualifier (V1-08) is present, then Vessel Code (V1-01) is required
V1-01
597
Vessel Code
Optional
Identifier (ID)
Min 1Max 8
V1-02
182
Vessel Name
Optional
String (AN)
Min 2Max 28
V1-04
55
Flight/Voyage Number
Optional
String (AN)
Min 2Max 10
V1-05
140
Standard Carrier Alpha Code
Optional
Identifier (ID)
Min 2Max 4
V1-08
897
Vessel Code Qualifier
Optional
Identifier (ID)
C
Ship's Radio Call Signal
L
Lloyd's Register of Shipping
N1 Loop
RequiredMax >1
N1
130
Heading > N1 Loop > N1

Name

RequiredMax use 1
Usage notes
Example
If either Identification Code Qualifier (N1-03) or Identification Code (N1-04) is present, then the other is required
N1-01
98
Entity Identifier Code
Required
Identifier (ID)
CA
Carrier
CN
Consignee
FW
Forwarder
N1
Notify Party no. 1
N2
Notify Party no. 2
SH
Shipper
Required
String (AN)
Min 1Max 60
Usage notes
N1-03
66
Identification Code Qualifier
Optional
Identifier (ID)
25
Carrier's Customer Code
N1-04
67
Identification Code
Optional
String (AN)
Min 2Max 80
N3
150
Heading > N1 Loop > N3

Address Information

OptionalMax use 2
Usage notes
Example
N3-01
166
Address Information
Required
String (AN)
Min 1Max 55
N3-02
166
Address Information
Optional
String (AN)
Min 1Max 55
N4
160
Heading > N1 Loop > N4

Geographic Location

OptionalMax use 1
Usage notes
Example
If Location Identifier (N4-06) is present, then Location Qualifier (N4-05) is required
N4-01
19
City Name
Optional
String (AN)
Min 2Max 30
N4-02
156
State or Province Code
Optional
Identifier (ID)
Min 2Max 2
N4-03
116
Postal Code
Optional
Identifier (ID)
Min 3Max 15
N4-04
26
Country Code
Optional
Identifier (ID)
Min 2Max 3
N4-05
309
Location Qualifier
Optional
Identifier (ID)
UN
United Nations Location Code (UNLOCODE)
N4-06
310
Location Identifier
Optional
String (AN)
Min 1Max 30
N1 Loop end
G61
170
Heading > G61

Contact

OptionalMax use 3
Usage notes
Example
If either Communication Number Qualifier (G61-03) or Communication Number (G61-04) is present, then the other is required
G61-01
366
Contact Function Code
Required
Identifier (ID)
CA
Customer Contact Granting Appointment
CN
General Contact
FW
N1
N2
SH
Shipper Contact
Required
String (AN)
Min 1Max 60
G61-03
365
Communication Number Qualifier
Optional
Identifier (ID)
EM
Electronic Mail
TE
Telephone
G61-04
364
Communication Number
Optional
String (AN)
Min 1Max 80
R4 Loop
RequiredMax >1
R4
180
Heading > R4 Loop > R4

Port or Terminal

RequiredMax use 1
Usage notes
Example
If either Location Qualifier (R4-02) or Location Identifier (R4-03) is present, then the other is required
R4-01
115
Port or Terminal Function Code
Required
Identifier (ID)
D
Port of Discharge (Operational)
E
Place of Delivery (Contractual)
L
Port of Loading (Operational)
R
Place of Receipt (Contractual)
R4-02
309
Location Qualifier
Optional
Identifier (ID)
UN
United Nations Location Code (UNLOCODE)
R4-03
310
Location Identifier
Optional
String (AN)
Min 1Max 30
R4-04
114
Port Name
Optional
String (AN)
Min 2Max 24
R4-05
26
Country Code
Optional
Identifier (ID)
Min 2Max 3
R4-08
156
State or Province Code
Optional
Identifier (ID)
Min 2Max 2
DTM
190
Heading > R4 Loop > DTM

Actual

OptionalMax use 15
Usage notes
Example
Variants (all may be used)
DTMEstimated
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)
140
Actual
Required
Date (DT)
CCYYMMDD format
Required
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format
DTM
190
Heading > R4 Loop > DTM

Estimated

OptionalMax use 15
Usage notes
Example
Variants (all may be used)
DTMActual
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)
139
Estimated
Required
Date (DT)
CCYYMMDD format
Required
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format
R4 Loop end
R2
200
Heading > R2

Route Information

OptionalMax use 13
Usage notes
Example
R2-01
140
Standard Carrier Alpha Code
Required
Identifier (ID)
Min 2Max 4
Usage notes
R2-02
133
Routing Sequence Code
Required
Identifier (ID)
O
Origin Carrier (Air, Motor, or Ocean)
R2-12
56
Type of Service Code
Optional
Identifier (ID)
02
LCL/LCL
03
FCL/FCL
04
FCL/LCL
05
LCL/FCL
C8 Loop
OptionalMax >1
C8
240
Heading > C8 Loop > C8

Certifications and Clauses

RequiredMax use 1
Usage notes
Example
At least one of Certification/Clause Code (C8-02) or Certification/Clause Text (C8-03) is required
C8-02
246
Certification/Clause Code
Optional
Identifier (ID)
01
Shipper's Load and Count
02
Shipper's Load, Stowage and Count
03
Laden on Board
04
Laden on Board Vessel
11
Memo Bill of Lading Only
20
No Shipper's Export Declaration Required (Section 30.39)
22
On Board Rail
24
On Board Vessel
25
Received For Shipment
34
Laden on Board Named Vessel
C8-03
247
Certification/Clause Text
Optional
String (AN)
Min 2Max 60
C8C
250
Heading > C8 Loop > C8C

Certifications Clauses Continuation

OptionalMax use 5
Usage notes
Example
C8C-01
247
Certification/Clause Text
Required
String (AN)
Min 2Max 60
C8C-02
247
Certification/Clause Text
Optional
String (AN)
Min 2Max 60
C8C-03
247
Certification/Clause Text
Optional
String (AN)
Min 2Max 60
C8 Loop end
Heading end

Detail

LX Loop
RequiredMax >1
LX
010
Detail > LX Loop > LX

Assigned Number

RequiredMax use 1
Usage notes
Example
LX-01
554
Assigned Number
Required
Numeric (N0)
Min 1Max 6
N7 Loop
OptionalMax >1
N7
020
Detail > LX Loop > N7 Loop > N7

Equipment Details

RequiredMax use 1
Usage notes
Example
If either Weight (N7-03) or Weight Qualifier (N7-04) is present, then the other is required
N7-01
206
Equipment Initial
Required
String (AN)
Min 1Max 4
N7-02
207
Equipment Number
Required
String (AN)
Min 1Max 10
N7-03
81
Weight
Optional
Decimal number (R)
Min 1Max 10
Usage notes
N7-04
187
Weight Qualifier
Optional
Identifier (ID)
G
Gross Weight
N7-17
188
Weight Unit Code
Optional
Identifier (ID)
K
Kilograms
L
Pounds
N7-18
761
Equipment Number Check Digit
Optional
Numeric (N0)
Min 1Max 1
N7-22
24
Equipment Type
Optional
Identifier (ID)
Min 4Max 4
Usage notes
QTY
025
Detail > LX Loop > N7 Loop > QTY

Quantity

OptionalMax use 1
Usage notes
Example
QTY-01
673
Quantity Qualifier
Required
Identifier (ID)
39
Shipped Quantity
QTY-02
380
Quantity
Optional
Decimal number (R)
Min 1Max 15
M7
050
Detail > LX Loop > N7 Loop > M7

Seal Numbers

OptionalMax use 5
Usage notes
Example
M7-01
225
Seal Number
Required
String (AN)
Min 2Max 15
M7-02
225
Seal Number
Optional
String (AN)
Min 2Max 15
M7-03
225
Seal Number
Optional
String (AN)
Min 2Max 15
M7-05
98
Entity Identifier Code
Optional
Identifier (ID)
Usage notes
CA
Carrier
SH
Shipper
W09
060
Detail > LX Loop > N7 Loop > W09

Equipment and Temperature

OptionalMax use 1
Usage notes
Example
If either Temperature (W09-02) or Unit or Basis for Measurement Code (W09-03) is present, then the other is required
W09-01
40
Equipment Description Code
Required
Identifier (ID)
CZ
Refrigerated Container
W09-02
408
Temperature
Optional
Decimal number (R)
Min 1Max 4
Usage notes
W09-03
355
Unit or Basis for Measurement Code
Optional
Identifier (ID)
CE
Centigrade, Celsius
FA
Fahrenheit
W09-07
1122
Vent Setting Code
Optional
Identifier (ID)
A
Vent 25% Open
B
Vent 50% Open
C
Vent 75% Open
D
Vent 100% Open
E
Closed
W09-08
488
Percent
Optional
Numeric (N0)
Min 1Max 3
W09-09
380
Quantity
Optional
Decimal number (R)
Min 1Max 15
L1 Loop
OptionalMax >1
L1
070
Detail > LX Loop > N7 Loop > L1 Loop > L1

Rate and Charges

RequiredMax use 1
Usage notes
Example
If either Freight Rate (L1-02) or Rate/Value Qualifier (L1-03) is present, then the other is required
L1-01
213
Lading Line Item Number
Optional
Numeric (N0)
Min 1Max 3
L1-02
60
Freight Rate
Optional
Decimal number (R)
Min 1Max 9
L1-03
122
Rate/Value Qualifier
Optional
Identifier (ID)
PA
Per Container
L1-04
58
Charge
Optional
Numeric (N2)
Min 1Max 12
Usage notes
L1-06
117
Prepaid Amount
Optional
Numeric (N2)
Min 1Max 9
Usage notes
L1-08
150
Special Charge or Allowance Code
Optional
Identifier (ID)
Min 3Max 3
L1-11
16
Charge Method of Payment
Optional
Identifier (ID)
E
Collect
P
Prepaid
L1-12
276
Special Charge Description
Optional
String (AN)
Min 2Max 25
C3
080
Detail > LX Loop > N7 Loop > L1 Loop > C3

Currency

OptionalMax use 1
Usage notes
Example
C3-01
100
Currency Code
Required
Identifier (ID)
Min 3Max 3
C3-02
280
Exchange Rate
Optional
Decimal number (R)
Min 4Max 10
L1 Loop end
N7 Loop end
L0 Loop
OptionalMax >1
L0
150
Detail > LX Loop > L0 Loop > L0

Line Item - Quantity and Weight

RequiredMax use 1
Usage notes
Example
If either Weight (L0-04) or Weight Qualifier (L0-05) is present, then the other is required
If either Volume (L0-06) or Volume Unit Qualifier (L0-07) is present, then the other is required
If either Lading Quantity (L0-08) or Packaging Form Code (L0-09) is present, then the other is required
If Weight Unit Code (L0-11) is present, then Weight (L0-04) is required
L0-01
213
Lading Line Item Number
Optional
Numeric (N0)
Min 1Max 3
L0-04
81
Weight
Optional
Decimal number (R)
Min 1Max 10
Usage notes
L0-05
187
Weight Qualifier
Optional
Identifier (ID)
G
Gross Weight
N
Actual Net Weight
L0-06
183
Volume
Optional
Decimal number (R)
Min 1Max 8
Usage notes
L0-07
184
Volume Unit Qualifier
Optional
Identifier (ID)
E
Cubic Feet
X
Cubic Meters
L0-08
80
Lading Quantity
Optional
Numeric (N0)
Min 1Max 7
L0-09
211
Packaging Form Code
Optional
Identifier (ID)
Min 3Max 3
Usage notes
L0-11
188
Weight Unit Code
Optional
Identifier (ID)
K
Kilograms
L
Pounds
L5
160
Detail > LX Loop > L0 Loop > L5

Description, Marks and Numbers

OptionalMax use 999
Usage notes
Example
L5-01
213
Lading Line Item Number
Optional
Numeric (N0)
Min 1Max 3
L5-02
79
Lading Description
Required
String (AN)
Min 1Max 50
L5-06
87
Marks and Numbers
Optional
String (AN)
Min 1Max 48
H1 Loop
OptionalMax >1
H1
230
Detail > LX Loop > L0 Loop > H1 Loop > H1

Hazardous Material

RequiredMax use 1
Usage notes
Example
If either Flashpoint Temperature (H1-07) or Unit or Basis for Measurement Code (H1-08) is present, then the other is required
H1-01
62
Hazardous Material Code
Required
String (AN)
Min 4Max 10
H1-02
209
Hazardous Material Class Code
Optional
String (AN)
Min 1Max 4
H1-03
208
Hazardous Material Code Qualifier
Optional
Identifier (ID)
I
Intergovernmental Maritime Organization (IMO) Code
H1-04
64
Hazardous Material Description
Optional
String (AN)
Min 2Max 30
H1-05
63
Hazardous Material Contact
Optional
String (AN)
Min 1Max 24
H1-07
77
Flashpoint Temperature
Optional
Numeric (N)
Min 1Max 3
H1-08
355
Unit or Basis for Measurement Code
Optional
Identifier (ID)
CE
Centigrade, Celsius
FA
Fahrenheit
H1-09
254
Packing Group Code
Optional
Identifier (ID)
Min 1Max 3
H2
240
Detail > LX Loop > L0 Loop > H1 Loop > H2

Additional Hazardous Material Description

OptionalMax use 10
Usage notes
Example
H2-01
64
Hazardous Material Description
Required
String (AN)
Min 2Max 30
H2-02
274
Hazardous Material Classification
Optional
String (AN)
Min 1Max 30
H1 Loop end
L0 Loop end
LX Loop end
Detail end

Summary

L3
010
Summary > L3

Total Weight and Charges

RequiredMax use 1
Usage notes
Example
If either Volume (L3-09) or Volume Unit Qualifier (L3-10) is present, then the other is required
If Weight Unit Code (L3-12) is present, then Weight (L3-01) is required
L3-01
81
Weight
Optional
Decimal number (R)
Min 1Max 10
L3-02
187
Weight Qualifier
Optional
Identifier (ID)
G
Gross Weight
N
Actual Net Weight
L3-05
58
Charge
Optional
Numeric (N2)
Min 1Max 12
Usage notes
L3-07
117
Prepaid Amount
Optional
Numeric (N2)
Min 1Max 9
Usage notes
L3-09
183
Volume
Optional
Decimal number (R)
Min 1Max 8
L3-10
184
Volume Unit Qualifier
Optional
Identifier (ID)
E
Cubic Feet
X
Cubic Meters
L3-11
80
Lading Quantity
Optional
Numeric (N0)
Min 1Max 7
L3-12
188
Weight Unit Code
Optional
Identifier (ID)
K
Kilograms
L
Pounds
L1 Loop
OptionalMax >1
L1
030
Summary > L1 Loop > L1

Rate and Charges

RequiredMax use 1
Usage notes
Example
If either Freight Rate (L1-02) or Rate/Value Qualifier (L1-03) is present, then the other is required
L1-01
213
Lading Line Item Number
Optional
Numeric (N0)
Min 1Max 3
L1-02
60
Freight Rate
Optional
Decimal number (R)
Min 1Max 9
L1-03
122
Rate/Value Qualifier
Optional
Identifier (ID)
LS
Lump Sum
PA
Per Container
L1-04
58
Charge
Optional
Numeric (N2)
Min 1Max 12
Usage notes
L1-06
117
Prepaid Amount
Optional
Numeric (N2)
Min 1Max 9
Usage notes
L1-08
150
Special Charge or Allowance Code
Optional
Identifier (ID)
Min 3Max 3
L1-11
16
Charge Method of Payment
Optional
Identifier (ID)
E
Collect
P
Prepaid
L1-12
276
Special Charge Description
Optional
String (AN)
Min 2Max 25
C3
040
Summary > L1 Loop > C3

Currency

OptionalMax use 1
Usage notes
Example
C3-01
100
Currency Code
Required
Identifier (ID)
Min 3Max 3
C3-02
280
Exchange Rate
Optional
Decimal number (R)
Min 4Max 10
L1 Loop end
K1
060
Summary > K1

Remarks

OptionalMax use 999
Usage notes
Example
K1-01
61
Free-Form Message
Required
String (AN)
Min 1Max 30
K1-02
61
Free-Form Message
Optional
String (AN)
Min 1Max 30
SE
080
Summary > SE

Transaction Set Trailer

RequiredMax use 1
Example
SE-01
96
Number of Included Segments
Required
Numeric (N0)
Min 1Max 10
SE-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9
Summary end

Functional Group Trailer

RequiredMax use 1
Example
GE-01
97
Number of Transaction Sets Included
Required
Numeric (N0)
Min 1Max 6
GE-02
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Interchange Control Trailer

RequiredMax use 1
Example
IEA-01
I16
Number of Included Functional Groups
Required
Numeric (N0)
Min 1Max 5
IEA-02
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9

Stedi is a registered trademark of Stedi, Inc. All names, logos, and brands of third parties listed on this page are trademarks of their respective owners (including “X12”, which is a trademark of X12 Incorporated). Stedi, Inc. and its products and services are not endorsed by, sponsored by, or affiliated with these third parties. Use of these names, logos, and brands is for identification purposes only, and does not imply any such endorsement, sponsorship, or affiliation.