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

X12 310 Freight Receipt and Invoice (Ocean)

X12 Release 4030
Delimiters
  • ~ Segment
  • * Element
  • > Component
  • ^ Repetition
EDI sample
  • Sample
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/crane-worldwide-logistics/freight-receipt-and-invoice-ocean/01GYCY64YP9Q2CTN97FCCK6321
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
0100
Transaction Set Header
Max use 1
Required
B3
0200
Beginning Segment for Carrier's Invoice
Max use 1
Required
N9
0600
Reference Identification
Max use 15
Optional
V1
0700
Vessel Identification
Max use 2
Required
C3
1100
Currency
Max use 1
Optional
Consignee
detail
LX Loop
LX
0100
Assigned Number
Max use 1
Required
N7 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
I65
Repetition Separator
Required
String (AN)
Min 1Max 1
^
Repetition Separator
ISA-12
I11
Interchange Control Version Number
Required
Identifier (ID)
00403
Draft Standards for Trial Use Approved for Publication by ASC X12 Procedures Review Board through October 1999
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)
004030
Draft Standards Approved for Publication by ASC X12 Procedures Review Board through October 1999

Heading

ST
0100
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
0200
Heading > B3

Beginning Segment for Carrier's Invoice

RequiredMax use 1
Example
If either Delivery Date (B3-09) or Date/Time Qualifier (B3-10) is present, then the other is required
B3-02
76
Invoice Number
Required
String (AN)
Min 1Max 22
B3-03
145
Shipment Identification Number
Optional
String (AN)
Min 1Max 30
B3-04
146
Shipment Method of Payment
Required
Identifier (ID)
CC
Collect
PP
Prepaid (by Seller)
TP
Third Party Pay
Required
Date (DT)
CCYYMMDD format
B3-07
193
Net Amount Due
Required
Numeric (N2)
Min 1Max 12
B3-09
32
Delivery Date
Optional
Date (DT)
CCYYMMDD format
B3-10
374
Date/Time Qualifier
Optional
Identifier (ID)
035
Delivered
B3-11
140
Standard Carrier Alpha Code
Required
Identifier (ID)
Min 2Max 4
Optional
Date (DT)
CCYYMMDD format
B3-13
375
Tariff Service Code
Optional
Identifier (ID)
DD
Door-to-Door
DO
Door-to-Terminal
DP
Door-to-Pier
OD
Terminal-to-Door
PD
Pier-to-Door
PP
Pier-to-Pier
B3-14
335
Transportation Terms Code
Optional
Identifier (ID)
Min 3Max 3
N9
0600
Heading > N9

Reference Identification

OptionalMax use 15
Example
N9-01
128
Reference Identification Qualifier
Required
Identifier (ID)
Min 2Max 3
N9-02
127
Reference Identification
Optional
String (AN)
Min 1Max 50
V1
0700
Heading > V1

Vessel Identification

RequiredMax use 2
Example
At least one of Vessel Code (V1-01) or Vessel Name (V1-02) 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
C3
1100
Heading > C3

Currency

OptionalMax use 1
Example
C3-01
100
Currency Code
Required
Identifier (ID)
Min 3Max 3
N1 Consignee
RequiredMax >1
Variants (all may be used)
CustomerShipper
N1
1300
Heading > Consignee > N1

Name

RequiredMax use 1
Example
N1-01
98
Entity Identifier Code
Required
Identifier (ID)
CN
Consignee
Optional
String (AN)
Min 1Max 60
N2
1400
Heading > Consignee > N2

Additional Name Information

OptionalMax use 1
Example
Required
String (AN)
Min 1Max 60
Optional
String (AN)
Min 1Max 60
N3
1500
Heading > Consignee > N3

Address Information

OptionalMax use 2
Example
N3-01
166
Address Information
Required
String (AN)
Min 1Max 55
N3-02
166
Address Information
Optional
String (AN)
Min 1Max 55
N4
1600
Heading > Consignee > N4

Geographic Location

OptionalMax use 1
Example
If Location Identifier (N4-06) is present, then Location Qualifier (N4-05) is required
Only one of State or Province Code (N4-02) or Country Subdivision Code (N4-07) may be present
If Country Subdivision Code (N4-07) is present, then Country Code (N4-04) 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)
Min 1Max 2
N4-06
310
Location Identifier
Optional
String (AN)
Min 1Max 30
N4-07
1715
Country Subdivision Code
Optional
Identifier (ID)
Min 1Max 3
N1 Consignee end
N1 Customer
RequiredMax >1
Variants (all may be used)
ConsigneeShipper
N1
1300
Heading > Customer > N1

Name

RequiredMax use 1
Example
N1-01
98
Entity Identifier Code
Required
Identifier (ID)
LW
Customer
Optional
String (AN)
Min 1Max 60
N2
1400
Heading > Customer > N2

Additional Name Information

OptionalMax use 1
Example
Required
String (AN)
Min 1Max 60
Optional
String (AN)
Min 1Max 60
N3
1500
Heading > Customer > N3

Address Information

OptionalMax use 2
Example
N3-01
166
Address Information
Required
String (AN)
Min 1Max 55
N3-02
166
Address Information
Optional
String (AN)
Min 1Max 55
N4
1600
Heading > Customer > N4

Geographic Location

OptionalMax use 1
Example
If Location Identifier (N4-06) is present, then Location Qualifier (N4-05) is required
Only one of State or Province Code (N4-02) or Country Subdivision Code (N4-07) may be present
If Country Subdivision Code (N4-07) is present, then Country Code (N4-04) 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)
Min 1Max 2
N4-06
310
Location Identifier
Optional
String (AN)
Min 1Max 30
N4-07
1715
Country Subdivision Code
Optional
Identifier (ID)
Min 1Max 3
N1 Customer end
N1 Shipper
RequiredMax >1
Variants (all may be used)
ConsigneeCustomer
N1
1300
Heading > Shipper > N1

Name

RequiredMax use 1
Example
N1-01
98
Entity Identifier Code
Required
Identifier (ID)
SH
Shipper
Optional
String (AN)
Min 1Max 60
N2
1400
Heading > Shipper > N2

Additional Name Information

OptionalMax use 1
Example
Required
String (AN)
Min 1Max 60
Optional
String (AN)
Min 1Max 60
N3
1500
Heading > Shipper > N3

Address Information

OptionalMax use 2
Example
N3-01
166
Address Information
Required
String (AN)
Min 1Max 55
N3-02
166
Address Information
Optional
String (AN)
Min 1Max 55
N4
1600
Heading > Shipper > N4

Geographic Location

OptionalMax use 1
Example
If Location Identifier (N4-06) is present, then Location Qualifier (N4-05) is required
Only one of State or Province Code (N4-02) or Country Subdivision Code (N4-07) may be present
If Country Subdivision Code (N4-07) is present, then Country Code (N4-04) 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)
Min 1Max 2
N4-06
310
Location Identifier
Optional
String (AN)
Min 1Max 30
N4-07
1715
Country Subdivision Code
Optional
Identifier (ID)
Min 1Max 3
N1 Shipper end
R4 Loop
RequiredMax >1
R4
1800
Heading > R4 Loop > R4

Port or Terminal

RequiredMax use 1
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)
ZZ
Mutually Defined
R4-03
310
Location Identifier
Optional
String (AN)
Min 1Max 30
DTM
1900
Heading > R4 Loop > DTM

Actual

OptionalMax use 15
Example
If Time Code (DTM-04) is present, then Time (DTM-03) is required
At least one of Date (DTM-02), Time (DTM-03) or Date Time Period Format Qualifier (DTM-05) is required
If either Date Time Period Format Qualifier (DTM-05) or Date Time Period (DTM-06) is present, then the other is required
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)
140
Actual
Optional
Date (DT)
CCYYMMDD format
Optional
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format
DTM-04
623
Time Code
Optional
Identifier (ID)
Min 2Max 2
DTM-05
1250
Date Time Period Format Qualifier
Optional
Identifier (ID)
Min 2Max 3
DTM-06
1251
Date Time Period
Optional
String (AN)
Min 1Max 35
DTM
1900
Heading > R4 Loop > DTM

Estimated

OptionalMax use 15
Example
Variants (all may be used)
DTMActual
If Time Code (DTM-04) is present, then Time (DTM-03) is required
At least one of Date (DTM-02), Time (DTM-03) or Date Time Period Format Qualifier (DTM-05) is required
If either Date Time Period Format Qualifier (DTM-05) or Date Time Period (DTM-06) is present, then the other is required
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)
139
Estimated
Optional
Date (DT)
CCYYMMDD format
Optional
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format
DTM-04
623
Time Code
Optional
Identifier (ID)
Min 2Max 2
DTM-05
1250
Date Time Period Format Qualifier
Optional
Identifier (ID)
Min 2Max 3
DTM-06
1251
Date Time Period
Optional
String (AN)
Min 1Max 35
R4 Loop end
Heading end

Detail

LX Loop
RequiredMax >1
LX
0100
Detail > LX Loop > LX

Assigned Number

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

Equipment Details

RequiredMax use 1
Example
If either Weight (N7-03) or Weight Qualifier (N7-04) is present, then the other is required
If either Volume (N7-08) or Volume Unit Qualifier (N7-09) is present, then the other is required
N7-01
206
Equipment Initial
Optional
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
N7-04
187
Weight Qualifier
Optional
Identifier (ID)
G
Gross Weight
N7-08
183
Volume
Optional
Decimal number (R)
Min 1Max 8
N7-09
184
Volume Unit Qualifier
Optional
Identifier (ID)
E
Cubic Feet
X
Cubic Meters
N7-22
24
Equipment Type
Optional
Identifier (ID)
Min 4Max 4
M7
0500
Detail > LX Loop > N7 Loop > M7

Seal Numbers

OptionalMax use 5
Example
M7-01
225
Seal Number
Required
String (AN)
Min 2Max 15
N7 Loop end
L0 Loop
OptionalMax >1
L0
1500
Detail > LX Loop > L0 Loop > L0

Line Item - Quantity and Weight

RequiredMax use 1
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
If either Quantity (L0-13) or Yes/No Condition or Response Code (L0-15) is present, then the other 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
L0-05
187
Weight Qualifier
Optional
Identifier (ID)
G
Gross Weight
L0-06
183
Volume
Optional
Decimal number (R)
Min 1Max 8
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
L0-11
188
Weight Unit Code
Optional
Identifier (ID)
E
Metric Ton
K
Kilograms
L
Pounds
T
Long Ton
L0-12
56
Type of Service Code
Optional
Identifier (ID)
Min 2Max 2
L0-13
380
Quantity
Optional
Decimal number (R)
Min 1Max 15
L0-14
211
Packaging Form Code
Optional
Identifier (ID)
Min 3Max 3
L0-15
1073
Yes/No Condition or Response Code
Optional
Identifier (ID)
Min 1Max 1
L5
1600
Detail > LX Loop > L0 Loop > L5

Description, Marks and Numbers

OptionalMax use 999
Example
L5-01
213
Lading Line Item Number
Optional
Numeric (N0)
Min 1Max 3
L5-02
79
Lading Description
Optional
String (AN)
Min 1Max 50
L1 Loop
OptionalMax >1
L1
1700
Detail > LX Loop > L0 Loop > L1 Loop > L1

Rate and Charges

RequiredMax use 1
Example
L1-01
213
Lading Line Item Number
Optional
Numeric (N0)
Min 1Max 3
L1-04
58
Charge
Optional
Numeric (N2)
Min 1Max 12
L1-08
150
Special Charge or Allowance Code
Optional
Identifier (ID)
Min 3Max 3
L1-12
276
Special Charge Description
Optional
String (AN)
Min 2Max 25
C3
1800
Detail > LX Loop > L0 Loop > L1 Loop > C3

Currency

OptionalMax use 1
Example
C3-01
100
Currency Code
Required
Identifier (ID)
Min 3Max 3
L1 Loop end
L0 Loop end
LX Loop end
Detail end

Summary

L3
0100
Summary > L3

Total Weight and Charges

RequiredMax use 1
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
L3-05
58
Charge
Optional
Numeric (N2)
Min 1Max 12
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
SE
0800
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
EDI Samples

Sample

ST*310*0001~
B3**ISEIAH220200003*TEST1234*PP**20220209*182000**20220312*035*MLCW**DD*CFR~
N9*BM*TEST1234~
N9*BN*TEST1234~
N9*PO*123456798~
V1**DANIEL K. INOUYE**056E~
V1**DANIEL K. INOUYE**056E~
C3*USD~
N1*CN*Consignee Name~
N3*AL-BADRANI, AL QATIF*WESTERN SECTOR PLOT NO. 17~
N4*DAMMAM***SA~
N1*LW*Customer Name~
N3*P O Box 671048*Attn A P Special~
N4*HOUSTON*TX*77267*US~
N1*SH*Shipper Name~
N3*By its representative,*ABC International, Inc.~
N4*HOUSTON*TX*77067*US~
R4*L*UN*HOU~
DTM*139*20220301~
R4*D*UN*DMM~
R4*R*UN*HOU~
R4*E*UN*DAMMAM~
LX*1~
N7*MATU*5143400*10000*G****20*X*************40HC~
M7*1029855~
L0*1***10000*G*20*X*2*CTN**K~
L5*1*General Cargo~
L1*1***20000****STF****Container Stuffing~
C3*USD~
L1*2***10000****DRC****Container Drayage~
C3*USD~
L1*3***2000****URC****Transload Fee~
C3*USD~
L1*4***150000****TRF****Transfer Fee~
C3*USD~
L3*10000*G***182000****20*X*2*K~
SE*37*0001~

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.