CMA CGM
/
Confirmation (Ocean)
  • Specification
  • EDI Inspector
Import guide into your account
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
    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

    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

    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
    YYMMDD format

    Date of the interchange

    ISA-10
    I09
    Interchange Time
    Required
    HHMM format

    Time of the interchange

    ISA-11
    I10
    Interchange Control Standards Identifier
    Required

    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

    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

    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

    GS-04
    373
    Date
    Required
    CCYYMMDD format

    Date expressed as CCYYMMDD

    GS-05
    337
    Time
    Required
    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

    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

    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)

    B1-03
    373
    Date
    Optional
    CCYYMMDD format

    Date expressed as CCYYMMDD

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

    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

    Y3-03
    373
    Date
    Optional
    CCYYMMDD format

    Date expressed as CCYYMMDD

    • Y303 is the date of departure of the vessel.
    Y3-04
    373
    Date
    Optional
    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

    Y4-03
    373
    Date
    Optional
    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

    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

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

    CN
    Consignee
    CS
    CSR that took the booking
    FW
    Forwarder
    SH
    Shipper
    N1-02
    93
    Name
    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

    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

    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

    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.