CMA CGM
/
Confirmation (Ocean)
  • Specification
  • EDI Inspector
Stedi maintains this guide based on public documentation from CMA CGM. Contact CMA CGM for official EDI specifications. To report any errors in this guide, please contact us.
Go to Stedi Network
CMA CGM logo

X12 301 Confirmation (Ocean)

X12 Release 4010

This Draft Standard for Trial Use contains the format and establishes the data contents of the Confirmation (Ocean) Transaction Set (301) for use within the context of an Electronic Data Interchange (EDI) environment. The transaction set can be used to provide all the information necessary for an ocean carrier to confirm space, container, and equipment availability in response to the Reservation (Booking Request) (Ocean) Transaction Set (300); or to notify other parties such as terminal operators or other ocean carriers.

Delimiters
  • ~ Segment
  • * Element
  • > Component
EDI sample
  • 301 Sample
View the latest version of this implementation guide as an interactive webpage
https://www.stedi.com/app/guides/view/cma-cgm/confirmation-ocean/01HD99F5PB4YGV78F2P805S3E0
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
R4 Loop
W09
130
Equipment and Temperature
Max use 1
Optional
H3
140
Special Handling Instructions
Max use 6
Optional
GE
-
Functional Group Trailer
Max use 1
Required
IEA
-
Interchange Control Trailer
Max use 1
Required
ISA

Interchange Control Header

RequiredMax use 1

To start and identify an interchange of zero or more functional groups and interchange-related control segments

Example
ISA-01
I01
Authorization Information Qualifier
Required
Identifier (ID)

Code to identify the type of information in the Authorization Information

00
No Authorization Information Present (No Meaningful Information in I02)
ISA-02
I02
Authorization Information
Required
String (AN)
Min 10Max 10

Information used for additional identification or authorization of the interchange sender or the data in the interchange; the type of information is set by the Authorization Information Qualifier (I01)

ISA-03
I03
Security Information Qualifier
Required
Identifier (ID)

Code to identify the type of information in the Security Information

00
No Security Information Present (No Meaningful Information in I04)
ISA-04
I04
Security Information
Required
String (AN)
Min 10Max 10

This is used for identifying the security information about the interchange sender or the data in the interchange; the type of information is set by the Security Information Qualifier (I03)

ISA-05
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2

Qualifier to designate the system/method of code structure used to designate the sender or receiver ID element being qualified

Codes
ISA-06
I06
Interchange Sender ID
Required
String (AN)
Min 15Max 15

Identification code published by the sender for other parties to use as the receiver ID to route data to them; the sender always codes this value in the sender ID element

ISA-07
I05
Interchange ID Qualifier
Required
Identifier (ID)
Min 2Max 2

Qualifier to designate the system/method of code structure used to designate the sender or receiver ID element being qualified

Codes
ISA-08
I07
Interchange Receiver ID
Required
String (AN)
Min 15Max 15

Identification code published by the receiver of the data; When sending, it is used by the sender as their sending ID, thus other parties sending to them will use this as a receiving ID to route data to them

ISA-09
I08
Interchange Date
Required
Date (DT)
YYMMDD format

Date of the interchange

ISA-10
I09
Interchange Time
Required
Time (TM)
HHMM format

Time of the interchange

ISA-11
I10
Interchange Control Standards Identifier
Required
Identifier (ID)

Code to identify the agency responsible for the control standard used by the message that is enclosed by the interchange header and trailer

U
U.S. EDI Community of ASC X12, TDCC, and UCS
ISA-12
I11
Interchange Control Version Number
Required
Identifier (ID)

This version number covers the interchange control segments

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

A control number assigned by the interchange sender

ISA-14
I13
Acknowledgment Requested
Required
Identifier (ID)
Min 1Max 1

Code sent by the sender to request an interchange acknowledgment (TA1)

0
No Acknowledgment Requested
1
Interchange Acknowledgment Requested
ISA-15
I14
Usage Indicator
Required
Identifier (ID)
Min 1Max 1

Code to indicate whether data enclosed by this interchange envelope is test, production or information

I
Information
P
Production Data
T
Test Data
ISA-16
I15
Component Element Separator
Required
String (AN)
Min 1Max 1

Type is not applicable; the component element separator is a delimiter and not a data element; this field provides the delimiter used to separate component data elements within a composite data structure; this value must be different than the data element separator and the segment terminator

>
Component Element Separator

Functional Group Header

RequiredMax use 1

To indicate the beginning of a functional group and to provide control information

Example
GS-01
479
Functional Identifier Code
Required
Identifier (ID)

Code identifying a group of application related transaction sets

RO
Ocean Booking Information (300, 301,303)
GS-02
142
Application Sender's Code
Required
String (AN)
Min 2Max 15

Code identifying party sending transmission; codes agreed to by trading partners

GS-03
124
Application Receiver's Code
Required
String (AN)
Min 2Max 15

Code identifying party receiving transmission. Codes agreed to by trading partners

Required
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

Required
Time (TM)
HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format

Time expressed in 24-hour clock time as follows: HHMM, or HHMMSS, or HHMMSSD, or HHMMSSDD, where H = hours (00-23), M = minutes (00-59), S = integer seconds (00-59) and DD = decimal seconds; decimal seconds are expressed as follows: D = tenths (0-9) and DD = hundredths (00-99)

GS-06
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Assigned number originated and maintained by the sender

GS-07
455
Responsible Agency Code
Required
Identifier (ID)
Min 1Max 2

Code used in conjunction with Data Element 480 to identify the issuer of the standard

T
Transportation Data Coordinating Committee (TDCC)
X
Accredited Standards Committee X12
GS-08
480
Version / Release / Industry Identifier Code
Required
String (AN)

Code indicating the version, release, subrelease, and industry identifier of the EDI standard being used, including the GS and GE segments; if code in DE455 in GS segment is X, then in DE 480 positions 1-3 are the version number; positions 4-6 are the release and subrelease, level of the version; and positions 7-12 are the industry or trade association identifiers (optionally assigned by user); if code in DE455 in GS segment is T, then other formats are allowed

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

To indicate the start of a transaction set and to assign a control number

Example
ST-01
143
Transaction Set Identifier Code
Required
Identifier (ID)

Code uniquely identifying a Transaction Set

  • The transaction set identifier (ST01) used by the translation routines of the interchange partners to select the appropriate transaction set definition (e.g., 810 selects the Invoice Transaction Set).
301
Confirmation (Ocean)
ST-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9

Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set

B1
020
Heading > B1

Beginning Segment for Booking or Pick-up/Delivery

RequiredMax use 1

To transmit identifying numbers, dates, and other basic data relating to the transaction set

Example
B1-01
140
Standard Carrier Alpha Code
Optional
Identifier (ID)
Min 2Max 4

Standard Carrier Alpha Code

  • B101 is the Standard Carrier Alpha Code (SCAC) of the carrier sending the EDI transmission.
B1-02
145
Shipment Identification Number
Required
String (AN)
Min 1Max 30

Identification number assigned to the shipment by the shipper that uniquely identifies the shipment from origin to ultimate destination and is not subject to modification; (Does not contain blanks or special characters)

Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • B103 is the booking date accepted by the carrier.
B1-04
558
Reservation Action Code
Optional
Identifier (ID)

Code identifying action on reservation or offering

N
New
R
Delete
U
Change
Y3
040
Heading > Y3

Space Confirmation

RequiredMax use 1

To specify confirmation information for space booking including numbers, dates, and load time

Example
Y3-01
13
Booking Number
Required
String (AN)
Min 1Max 17

Number assigned by the carrier for space reservation

  • If space is available, all of the conditional data elements in segment Y3 are required. If the requested space is not available, Y301 is the booking number 'decline'.
Y3-02
140
Standard Carrier Alpha Code
Optional
Identifier (ID)
Min 2Max 4

Standard Carrier Alpha Code

Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • Y303 is the date of departure of the vessel.
Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • Y304 is the estimated arrival date at the port of discharge.
Y4 Loop
OptionalMax 10
Y4
050
Heading > Y4 Loop > Y4

Container Release

RequiredMax use 1

To transmit information relative to containers available for release

Example
Y4-02
13
Booking Number
Optional
String (AN)
Min 1Max 17

Number assigned by the carrier for space reservation

Optional
Date (DT)
CCYYMMDD format

Date expressed as CCYYMMDD

  • Y403 is the date of container availability for pickup.
Y4-05
95
Number of Containers
Optional
Numeric (N0)
Min 1Max 4

Number of shipping containers

Y4-06
24
Equipment Type
Optional
Identifier (ID)
Min 4Max 4

Code identifying equipment type

Y4-07
140
Standard Carrier Alpha Code
Optional
Identifier (ID)
Min 2Max 4

Standard Carrier Alpha Code

  • Y407 identifies the carrier to whom containers will be released, if known.
Y4-10
56
Type of Service Code
Optional
Identifier (ID)

Code specifying extent of transportation service requested

F
Full Container
H
Partial Load
L
Container Yard
P
Container freight Station
Y4 Loop end
N1 Loop
OptionalMax 4
N1
060
Heading > N1 Loop > N1

Name

RequiredMax use 1

To identify a party by type of organization, name, and code

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)

Code identifying an organizational entity, a physical location, property or an individual

CN
Consignee
CS
CSR that took the booking
FW
Forwarder
SH
Shipper
Optional
String (AN)
Min 1Max 60

Free-form name

N1-03
66
Identification Code Qualifier
Optional
Identifier (ID)
Min 1Max 2

Code designating the system/method of code structure used for Identification Code (67)

N1-04
67
Identification Code
Optional
String (AN)
Min 2Max 80

Code identifying a party or other code

  • This segment, used alone, provides the most efficient method of providing organizational identification. To obtain this efficiency the "ID Code" (N104) must provide a key to the table maintained by the transaction processing party.
N1 Loop end
R4 Loop
RequiredMax 20
R4
110
Heading > R4 Loop > R4

Port or Terminal

RequiredMax use 1

Contractual or operational port or point relevant to the movement of the cargo

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)

Code defining function performed at the port or terminal with respect to a shipment

B
Booking Office
D
Discharge
E
Place of Delivery
L
Load
R
Place of Receipt
T
Transship
R4-02
309
Location Qualifier
Optional
Identifier (ID)
Min 1Max 2

Code identifying type of location

R4-03
310
Location Identifier
Optional
String (AN)
Min 1Max 30

Code which identifies a specific location

R4-04
114
Port Name
Optional
String (AN)
Min 2Max 24

Free-form name for the place at which an offshore carrier originates or terminates (by transshipment or otherwise) its actual ocean carriage of property

R4-05
26
Country Code
Optional
Identifier (ID)
Min 2Max 3

Code identifying the country

R4 Loop end
W09
130
Heading > W09

Equipment and Temperature

OptionalMax use 1

To relate equipment type and required temperatures

Example
If either Temperature (W09-02) or Unit or Basis for Measurement Code (W09-03) is present, then the other is required
If either Temperature (W09-04) or Unit or Basis for Measurement Code (W09-05) is present, then the other is required
W09-01
40
Equipment Description Code
Required
Identifier (ID)
Min 2Max 2

Code identifying type of equipment used for shipment

W09-02
408
Temperature
Optional
Decimal number (R)
Min 1Max 4

Temperature

  • W0902 is the minimum allowable temperature condition for shipment; (the qualifying temperature scale is specified in W0903).
W09-03
355
Unit or Basis for Measurement Code
Optional
Identifier (ID)

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

CE
Centigrade, Celsius
FA
Fahrenheit
W09-04
408
Temperature
Optional
Decimal number (R)
Min 1Max 4

Temperature

  • W0904 is the maximum allowable temperature condition for shipment; (the qualifying temperature scale is specified in W0905).
W09-05
355
Unit or Basis for Measurement Code
Optional
Identifier (ID)

Code specifying the units in which a value is being expressed, or manner in which a measurement has been taken

CE
Centigrade, Celsius
FA
Fahrenheit
W09-09
380
Quantity
Optional
Decimal number (R)
Min 1Max 15

Numeric value of quantity

  • W0909 is the number of air exchanges per hour.
H3
140
Heading > H3

Special Handling Instructions

OptionalMax use 6

To specify special handling instructions in coded or free-form format

Example
Only one of Special Handling Code (H3-01) or Special Handling Description (H3-02) may be present
H3-01
152
Special Handling Code
Optional
Identifier (ID)
Min 2Max 3

Code specifying special transportation handling instructions

H3-02
153
Special Handling Description
Optional
String (AN)
Min 2Max 30

Free-form additional description of special handling instructions to appear on printed bill if special handling code is not adequate

Heading end

Detail

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

Assigned Number

RequiredMax use 1

To reference a line number in a transaction set

Example
LX-01
554
Assigned Number
Required
Numeric (N0)
Min 1Max 6

Number assigned for differentiation within a transaction set

L0
040
Detail > LX Loop > L0

Line Item - Quantity and Weight

OptionalMax use 1

To specify quantity, weight, volume, and type of service for a line item including applicable "quantity/rate-as" data

Example
If either Weight (L0-04) or Weight Qualifier (L0-05) is present, then the other is required
If Weight Unit Code (L0-11) is present, then Weight (L0-04) is required
If either Lading Quantity (L0-08) or Packaging Form Code (L0-09) is present, then the other is required
L0-01
213
Lading Line Item Number
Optional
Numeric (N0)
Min 1Max 3

Sequential line number for a lading item

L0-04
81
Weight
Optional
Decimal number (R)
Min 1Max 10

Numeric value of weight

L0-05
187
Weight Qualifier
Optional
Identifier (ID)
Min 1Max 2

Code defining the type of weight

L0-06
183
Volume
Optional
Decimal number (R)
Min 1Max 8

Value of volumetric measure

L0-08
80
Lading Quantity
Optional
Numeric (N0)
Min 1Max 7

Number of units (pieces) of the lading commodity

  • L008 is the number of handling units of the line item tendered to the carrier.
L0-09
211
Packaging Form Code
Optional
Identifier (ID)
Min 3Max 3

Code for packaging form of the lading quantity

L0-11
188
Weight Unit Code
Optional
Identifier (ID)
Min 1Max 1

Code specifying the weight unit

L5
050
Detail > LX Loop > L5

Description, Marks and Numbers

OptionalMax use 1

To specify the line item in terms of description, quantity, packaging, and marks and numbers

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

Sequential line number for a lading item

L5-02
79
Lading Description
Optional
String (AN)
Min 1Max 50

Description of an item as required for rating and billing purposes

  • L502 may be used to send quantity information as part of the product description.
L5-03
22
Commodity Code
Optional
String (AN)
Min 1Max 30

Code describing a commodity or group of commodities

L5-04
23
Commodity Code Qualifier
Optional
Identifier (ID)
Min 1Max 1

Code identifying the commodity coding system used for Commodity Code

H1 Loop
OptionalMax 10
H1
060
Detail > LX Loop > H1 Loop > H1

Hazardous Material

RequiredMax use 1

To specify information relative to hazardous material

Example
H1-01
62
Hazardous Material Code
Required
String (AN)
Min 4Max 10

Code relating to hazardous material code qualifier for regulated hazardous materials

H1 Loop end
LX Loop end
V1
080
Detail > V1

Vessel Identification

OptionalMax use 2

To provide vessel details and voyage number

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

Code identifying vessel

V1-02
182
Vessel Name
Optional
String (AN)
Min 2Max 28

Name of ship as documented in "Lloyd's Register of Ships"

V1-04
55
Flight/Voyage Number
Optional
String (AN)
Min 2Max 10

Identifying designator for the particular flight or voyage on which the cargo travels

V1-08
897
Vessel Code Qualifier
Optional
Identifier (ID)
Min 1Max 1

Code specifying vessel code source

Detail end

Summary

SE
010
Summary > SE

Transaction Set Trailer

RequiredMax use 1

To indicate the end of the transaction set and provide the count of the transmitted segments (including the beginning (ST) and ending (SE) segments)

Example
SE-01
96
Number of Included Segments
Required
Numeric (N0)
Min 1Max 10

Total number of segments included in a transaction set including ST and SE segments

SE-02
329
Transaction Set Control Number
Required
Numeric (N)
Min 4Max 9

Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set

Summary end

Functional Group Trailer

RequiredMax use 1

To indicate the end of a functional group and to provide control information

Example
GE-01
97
Number of Transaction Sets Included
Required
Numeric (N0)
Min 1Max 6

Total number of transaction sets included in the functional group or interchange (transmission) group terminated by the trailer containing this data element

GE-02
28
Group Control Number
Required
Numeric (N0)
Min 1Max 9

Assigned number originated and maintained by the sender

Interchange Control Trailer

RequiredMax use 1

To define the end of an interchange of zero or more functional groups and interchange-related control segments

Example
IEA-01
I16
Number of Included Functional Groups
Required
Numeric (N0)
Min 1Max 5

A count of the number of functional groups included in an interchange

IEA-02
I12
Interchange Control Number
Required
Numeric (N0)
Min 9Max 9

A control number assigned by the interchange sender

EDI Samples

301 Sample

ISA*00* *00* *ZZ*SENDER *ZZ*RECEIVER *231030*0159*U*00401*000000001*0*T*>
GS*RO*SENDERGS*RECEIVERGS*20231030*015927*000000001*X*004010
ST*301*3950008
B1*CMDU*NAM0793017*20091120*U
Y3*NAM0793017*CMDU*20091214*20091231
Y4**NAM0793017*20091123**10*4200*CMDU
N1*SH*DIRECT CONTAINER LINE*ZZ*CMADCL
R4*B*ZZ*USMIA*MIAMI, FL*US
R4*R*ZZ*USMIA*MIAMI, FL*US
R4*L*ZZ*USMIA*MIAMI, FL*US
R4*D*ZZ*CNHKG*HONG KONG*CN
R4*E*ZZ*CNHKG*HONG KONG*CN
R4*T*ZZ*KRBUS*BUSAN*KR
W09*CZ*99*FA*99*FA****0
H3**GENSET YES
LX*1
L0*1***55924*G***70*PCS**K
L5*1*1X40 CONTAINER STC*9699999*H
V1*9327592*CONRAD S**UA395S****L
SE*18*3950008
GE*1*000000001
IEA*1*000000001

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.