Cargo Smart
/
Confirmation (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 301 Confirmation (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/confirmation-ocean/01H5N4ZQMKNZ60994DBHAFMCF3
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
B1
020
Beginning Segment for Booking or Pick-up/Delivery
Max use 1
Required
Y3
040
Space Confirmation
Max use 1
Required
Y4 Loop
N9
054
Reference Identification
Max use 100
Optional
R4 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)
RO
Ocean Booking Information (300, 301,303)
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)
301
Confirmation (Ocean)
ST-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9
B1
020
Heading > B1

Beginning Segment for Booking or Pick-up/Delivery

RequiredMax use 1
Usage notes
Example
B1-01
140
Standard Carrier Alpha Code
Required
Identifier (ID)
Min 2Max 4
B1-02
145
Shipment Identification Number
Required
String (AN)
Min 1Max 30
Usage notes
Required
Date (DT)
CCYYMMDD format
Usage notes
B1-04
558
Reservation Action Code
Required
Identifier (ID)
A
Reservation Accepted
D
Reservation Cancelled
P
Pending
R
Delete
S
No Show
U
Change
Y3
040
Heading > Y3

Space Confirmation

RequiredMax use 1
Usage notes
Example
Y3-01
13
Booking Number
Required
String (AN)
Min 1Max 17
Usage notes
Y3-02
140
Standard Carrier Alpha Code
Optional
Identifier (ID)
Min 2Max 4
Optional
Date (DT)
CCYYMMDD format
Usage notes
Optional
Date (DT)
CCYYMMDD format
Optional
Date (DT)
CCYYMMDD format
Usage notes
Optional
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format
Usage notes
Y3-10
375
Tariff Service Code
Optional
Identifier (ID)
DD
Door-to-Door
DP
Door-to-Pier
PD
Pier-to-Door
PP
Pier-to-Pier
Y4 Loop
OptionalMax >1
Y4
050
Heading > Y4 Loop > Y4

Container Release

RequiredMax use 1
Usage notes
Example
Y4-01
13
Booking Number
Optional
String (AN)
Min 1Max 17
Optional
Date (DT)
CCYYMMDD format
Y4-05
95
Number of Containers
Optional
Numeric (N0)
Min 1Max 4
Usage notes
Y4-06
24
Equipment Type
Optional
Identifier (ID)
Min 4Max 4
Usage notes
Y4-10
56
Type of Service Code
Optional
Identifier (ID)
Usage notes
02
LCL/LCL
03
FCL/FCL
04
FCL/LCL
05
LCL/FCL
W09
051
Heading > Y4 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
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
Y4 Loop end
N9
054
Heading > N9

Reference Identification

OptionalMax use 100
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
FN
Forwarder's/Agent's Reference Number
IK
Invoice Number
PO
Purchase Order Number
SI
Shipper's Identifying Number for Shipment (SID)
TS
Tariff Number
ZZ
Mutually Defined
N9-02
127
Reference Identification
Required
String (AN)
Min 1Max 30
N1 Loop
OptionalMax >1
N1
060
Heading > N1 Loop > N1

Name

RequiredMax use 1
Usage notes
Example
At least one of Name (N1-02) or Identification Code Qualifier (N1-03) is required
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)
BK
Booking Party
CA
Carrier
CN
Consignee
CR
Container Return Company
FW
Forwarder
N1
Notify Party no. 1
N2
Notify Party no. 2
PW
Pick Up Address
SF
Ship From
SH
Shipper
ST
Ship To
Optional
String (AN)
Min 1Max 60
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
080
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
090
Heading > N1 Loop > N4

Geographic Location

OptionalMax use 1
Usage notes
Example
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
G61
100
Heading > N1 Loop > 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)
IC
Information Contact
Required
String (AN)
Min 1Max 60
G61-03
365
Communication Number Qualifier
Optional
Identifier (ID)
EM
Electronic Mail
FX
Facsimile
TE
Telephone
G61-04
364
Communication Number
Optional
String (AN)
Min 1Max 80
Usage notes
N1 Loop end
R4 Loop
RequiredMax >1
R4
110
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
120
Heading > R4 Loop > DTM

Date/Time Reference

OptionalMax use 15
Usage notes
Example
DTM-01
374
Date/Time Qualifier
Required
Identifier (ID)
139
Estimated
140
Actual
649
Document Due
AAG
Due Date
Required
Date (DT)
CCYYMMDD format
Optional
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format
R4 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
020
Detail > LX Loop > N7

Equipment Details

OptionalMax use 1
Usage notes
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
N
Actual Net 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-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
L0
040
Detail > LX 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
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
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
T
Long Ton
L5
050
Detail > LX Loop > L5

Description, Marks and Numbers

RequiredMax use 1
Usage notes
Example
If either Commodity Code (L5-03) or Commodity Code Qualifier (L5-04) is present, then the other is required
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-03
22
Commodity Code
Optional
String (AN)
Min 1Max 30
L5-04
23
Commodity Code Qualifier
Optional
Identifier (ID)
A
Harmonized Tariff Schedule of the United States Annotated
L5-06
87
Marks and Numbers
Optional
String (AN)
Min 1Max 48
L4
055
Detail > LX Loop > L4

Measurement

OptionalMax use 1
Usage notes
Example
L4-01
82
Length
Required
Decimal number (R)
Min 1Max 8
Required
Decimal number (R)
Min 1Max 8
L4-03
65
Height
Required
Decimal number (R)
Min 1Max 8
L4-04
90
Measurement Unit Qualifier
Required
Identifier (ID)
E
Feet
X
Meters
H1 Loop
OptionalMax >1
H1
060
Detail > LX 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)
I
Great Danger
II
Medium Danger
III
Minor Danger
H2
070
Detail > LX 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
LX Loop end
V1
080
Detail > 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-08
897
Vessel Code Qualifier
Optional
Identifier (ID)
L
Lloyd's Register of Shipping
Z
Mutually Defined
Detail end

Summary

SE
010
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.