X12 301 Confirmation (Ocean)
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.
- ~ Segment
- * Element
- > Component
Interchange Control Header
To start and identify an interchange of zero or more functional groups and interchange-related control segments
Code to identify the type of information in the Authorization Information
- 00
- No Authorization Information Present (No Meaningful Information in I02)
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)
Code to identify the type of information in the Security Information
- 00
- No Security Information Present (No Meaningful Information in I04)
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)
Qualifier to designate the system/method of code structure used to designate the sender or receiver ID element being qualified
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
Qualifier to designate the system/method of code structure used to designate the sender or receiver ID element being qualified
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
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
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
A control number assigned by the interchange sender
Code sent by the sender to request an interchange acknowledgment (TA1)
- 0
- No Acknowledgment Requested
- 1
- Interchange Acknowledgment Requested
Code to indicate whether data enclosed by this interchange envelope is test, production or information
- I
- Information
- P
- Production Data
- T
- Test Data
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
To indicate the beginning of a functional group and to provide control information
Code identifying a group of application related transaction sets
- RO
- Ocean Booking Information (300, 301,303)
Code identifying party sending transmission; codes agreed to by trading partners
Code identifying party receiving transmission. Codes agreed to by trading partners
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)
Assigned number originated and maintained by the sender
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
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
Transaction Set Header
To indicate the start of a transaction set and to assign a control number
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)
Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set
Beginning Segment for Booking or Pick-up/Delivery
To transmit identifying numbers, dates, and other basic data relating to the transaction set
Standard Carrier Alpha Code
- B101 is the Standard Carrier Alpha Code (SCAC) of the carrier sending the EDI transmission.
- OOLU
- OOCL Carrier Code (SCAC)
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)
Booking requester's unique reference to the booking. Has one to one relationship with this booking; not necessarily the booking #.
Date expressed as CCYYMMDD
- B103 is the booking date accepted by the carrier.
Code identifying action on reservation or offering
- N
- New
- R
- Delete
- U
- Change
Space Confirmation
To specify confirmation information for space booking including numbers, dates, and load time
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'.
Date expressed as CCYYMMDD
- Y303 is the date of departure of the vessel.
Date expressed as CCYYMMDD
- Y304 is the estimated arrival date at the port of discharge.
Date expressed as CCYYMMDD
- Y307 is the required pier date.
The latest date cargo can be delivered to place of receipt to make the vessel/voyage for which cargo was booked; cut-off or close date.
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)
- Y308 is the load time.
Cut-off time at place of receipt
Container Release
To transmit information relative to containers available for release
Number assigned by the carrier for space reservation
- Y401 is used for the first booking number and Y402 for the last booking number in a range of numbers. If only one booking number is used, Y402 is omitted.
Number assigned by the carrier for space reservation
Date expressed as CCYYMMDD
- Y403 is the date of container availability for pickup.
Date equipment available for pick-up; open date. Will default to current date or create date if not otherwise provided.
Code (Standard Point Location) defined by NMFTA point development group as the official code assigned to a city or point (for ratemaking purposes) within a city
- Y404 is the Standard Point Location Code (SPLC) of the container pick-up location.
Number of containers made available for pick-up and loading. If more than one size and type are included in booking, the Y4 will repeat for each type and size.
Number of empty containers to be picked-up. If more than one size and type are included in the booking, the Y4 will repeat once per size and type.
Code identifying equipment type
ISO code of size and type of container to be made available for pick-up
Standard Carrier Alpha Code
- Y407 identifies the carrier to whom containers will be released, if known.
Consignee's Order Number
To transmit identifying information as specified by the Reference Identification Qualifier
Code qualifying the Reference Identification
- CG
- Consignee's Order Number
Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier
Forwarder's/Agent's Reference Number
To transmit identifying information as specified by the Reference Identification Qualifier
Code qualifying the Reference Identification
- FN
- Forwarder's/Agent's Reference Number
Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier
Shipper's Identifying Number for Shipment (SID)
To transmit identifying information as specified by the Reference Identification Qualifier
Code qualifying the Reference Identification
- SI
- Shipper's Identifying Number for Shipment (SID)
A unique number (to the shipper) assigned by the shipper to identify the shipment
Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier
Name
To identify a party by type of organization, name, and code
Code identifying an organizational entity, a physical location, property or an individual
- CN
- Consignee
- MC
- Motor Carrier
- RR
- Railroad
- SH
- Shipper
Code designating the system/method of code structure used for Identification Code (67)
- ZZ
- Mutually Defined
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.
Contact
To identify a person or office to whom communications should be directed
Code identifying the major duty or responsibility of the person or group named
- EM
- Emergency Contact
Code identifying the type of communication number
- G6103 qualifies G6104.
- TE
- Telephone
Complete communications number including country or area code when applicable
In the case of telephone or fax numbers do not use hyphens or spaces between the various elements of those numbers.
Do not use 800 numbers since they are not accessible from anywhere in the world, for that matter not even from one area in North America to another.
Additional reference number or description to clarify a contact number
Any reference other than shipment id
Port or Terminal
Contractual or operational port or point relevant to the movement of the cargo
Code defining function performed at the port or terminal with respect to a shipment
- D
- Port of Discharge (Operational)
Port at which cargo is unloaded from vessel
- I
- Interim Point (Operational)
- L
- Port of Loading (Operational)
Port at which cargo is loaded on vessel
- P
- Dispatching Pool (Operational)
Place from which equipment is dispatched, picked-up or released empty
- R
- Place of Receipt (Contractual)
Place at which cargo enters the care and custody of the rail carrier
- U
Code identifying type of location
- CI
- City
- CS
- Canadian SPLC
- D
- Census Schedule D
- K
- Census Schedule K
- SL
- U.S. SPLC
- UN
- United Nations Location Code (UNLOCODE)
- ZZ
- Mutually Defined
Free-form name for the place at which an offshore carrier originates or terminates (by transshipment or otherwise) its actual ocean carriage of property
Free-form name for the location described above. Default Port of Discharge value if Schedule K or UNCODE conversion look-up fails when R401 value is equal to “D”.
Use official postal spellings of locations.
Date/Time Reference
To specify pertinent dates and times
Code specifying type of date or time, or both date and time
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)
Code identifying the time. In accordance with International Standards Organization standard 8601, time can be specified by a + or - and an indication in hours in relation to Universal Time Coordinate (UTC) time; since + is a restricted character, + and - are substituted by P and M in the codes that follow
Equipment and Temperature
To relate equipment type and required temperatures
Code identifying type of equipment used for shipment
- CJ
- Container, Insulated/Ventilated
- CZ
- Refrigerated Container
Temperature
- W0902 is the minimum allowable temperature condition for shipment; (the qualifying temperature scale is specified in W0903).
Minimum temperature at which container is to be maintained
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
Temperature
- W0904 is the maximum allowable temperature condition for shipment; (the qualifying temperature scale is specified in W0905).
Maximum temperature at which the container is to be maintained.
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
Numeric value of quantity
- W0909 is the number of air exchanges per hour.
Special Handling Instructions
To specify special handling instructions in coded or free-form format
Code specifying special transportation handling instructions
- GSN
- GENSET Not Required
- GSY
- GENSET Required
Free-form additional description of special handling instructions to appear on printed bill if special handling code is not adequate
Example;
GENSET NOT REQUIRE
GENSET REQUIRE
Code specifying perishable protective service- rail carriers only
Code specifying vent instructions
Standard codes applicable.
Code indicating to which traffic a tariff applies
Detail
Assigned Number
To reference a line number in a transaction set
Number assigned for differentiation within a transaction set
Equipment Details
To identify the equipment
Prefix or alphabetic part of an equipment unit's identifying number
- N701 is mandatory for rail transactions.
Container prefix
Equipment prefix. This prefix is required for ISO equipment
Sequencing or serial part of an equipment unit's identifying number (pure numeric form for equipment number is preferred)
Container number
Equipment number
If N718 is blank, check digit is assumed to be included within N702.
If N718 is populated, the check digit is assumed to not be included within the N702.
Numeric value of weight
Weight of container and cargo.
Code defining the type of weight
- A6
- Verified Gross Mass
- CE
- Certified Weight of Cargo
- G
- Gross Weight
Standard Carrier Alpha Code
- N712 is the owner of the equipment.
SCAC code of equipment owner.
Number which designates the check digit applied to a piece of equipment
Code identifying equipment type
ISO Code
Remarks
To transmit information in a free-form format for comment or special instruction
Line Item - Quantity and Weight
To specify quantity, weight, volume, and type of service for a line item including applicable "quantity/rate-as" data
Sequential line number for a lading item
Number of units (pieces) of the lading commodity
- L008 is the number of handling units of the line item tendered to the carrier.
Code for packaging form of the lading quantity
Code specifying extent of transportation service requested
- BB
- Breakbulk
- HH
- House-to-house
- HP
- House-to-pier
- MD
- Mixed Delivery
- NC
- Non-containerized cargo
- PH
- Pier-to-house
- PP
- Pier-to-pier
- RR
- Roll-on Roll-off
Description, Marks and Numbers
To specify the line item in terms of description, quantity, packaging, and marks and numbers
Sequential line number for a lading item
Line index
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.
Commodity description. Maximum 50 characters including proper spaces. Use no special characters.
Code describing a commodity or group of commodities
Schedule B code or Harmonized code.
Code identifying the commodity coding system used for Commodity Code
- Z
- Mutually defined
Marks and numbers used to identify a shipment or parts of a shipment
Code identifying the commodity coding system used for Commodity Code
Code describing a commodity or group of commodities
Hazardous Material
To specify information relative to hazardous material
Code relating to hazardous material code qualifier for regulated hazardous materials
UNDG number
Code specifying the kind of hazard for a material
IMDG class
Code which qualifies the Hazardous Material Class Code (209)
- U
- United Nations
Material name, special instructions, and phone number if any
Proper shipping name.
Phone number and name of person or department to contact in case of emergency
In the case of telephone or fax numbers do not use hyphens or spaces between the various elements of those numbers.
Do not use 800 numbers since they are not dialable from anywhere in the world, for that matter not even from one area in North America to another.
The United Nations page number as required for the international transport of hazardous materials
IMDG page number.
The flashpoint temperature for hazardous material
- H107 is the lowest temperature for hazardous materials.
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
Code indicating degree of danger in terms of Roman number I, II or III
- I
- Great Danger
- II
- Medium Danger
- III
- Minor Danger
Additional Hazardous Material Description
To specify free-form hazardous material descriptive data in addition to the information provided in the H1 segment
Material name, special instructions, and phone number if any
Proper shipping name continued.
Free-form description of hazardous material classification or division or label requirements
label of material (flammable, explosive, etc.)
Vessel Identification
To provide vessel details and voyage number
Name of ship as documented in "Lloyd's Register of Ships"
For the spelling of the vessel name.
Identifying designator for the particular flight or voyage on which the cargo travels
TRUNCATED TO MAX 4 CHARACTERS
Standard Carrier Alpha Code
- V105 identifies the ocean carrier.
SCAC code of carrier (vessel operator).
Code specifying vessel code source
- L
- Lloyd's Register of Shipping
Summary
Transaction Set Trailer
To indicate the end of the transaction set and provide the count of the transmitted segments (including the beginning (ST) and ending (SE) segments)
Total number of segments included in a transaction set including ST and SE segments
Identifying control number that must be unique within the transaction set functional group assigned by the originator for a transaction set
Functional Group Trailer
To indicate the end of a functional group and to provide control information
Total number of transaction sets included in the functional group or interchange (transmission) group terminated by the trailer containing this data element
Assigned number originated and maintained by the sender
Interchange Control Trailer
To define the end of an interchange of zero or more functional groups and interchange-related control segments
Sample 301
GS*RO*OOCLIES*DEPSYS*20231013*0540*87553*X*004010
ST*301*875530001
B1*OOLU*2143407930*20231012*U
Y3*2143407930*OOLU*20231107*20231202***20231018*1600
Y4*2143407930**20231017**38*4510
R4*R*D*4501*KANSAS CITY
DTM*172*20231012*1630*LT
R4*L*D*2709*LONG BEACH
R4*D*K*57069*XIAMEN
R4*U*K*57069*XIAMEN
R4*I*ZZ*KCK11
LX*1
N7*OOLU*8814778********************4510
L0****30260*G******K
L5**BULK SORGHUM*BULK SORGHUM*Z
V1*9645865*CSCL SUMMER**056W****L
SE*16*875530001
ST*301*875530002
B1*OOLU*2725460472*20231012*N
Y3*2725460472*OOLU*20231020*20231117***20231013*1200
Y4*2725460472**20230921**2*4530
R4*R*D*3901*CHICAGO
DTM*135*20231012*1536*LT
R4*L*K*01822*MONTREAL
R4*D*K*LVRIX*RIGA
R4*U*CI*LVRIX*RIGA
R4*I*ZZ*JOL15
W09*CZ*16*CE*16*CE****0
H3**GENSET REQUIRE
LX*1
N7*FSCU*5340430********************4532
L0****22680*G******K
L5**VITAMINS*VITAMINS*Z
V1*9253741*MONTREAL EXPRESS**354E****L
SE*18*875530002
ST*301*875530003
B1*OOLU*2726871060*20231012*N
Y3*2726871060*OOLU*20231108*20231124***20231027*1600
Y4*2726871060**20231026**3*4510
R4*R*D*5301*HOUSTON
DTM*135*20231012*1432*LT
R4*L*D*2704*LOS ANGELES
R4*D*K*58857*NAGOYA
R4*U*K*58857*NAGOYA
R4*I*ZZ*HOU08
LX*1
L0****11900*G******K
L5**PLASTIC ARTICLE, PACKING SECURING P*PLASTIC ARTICLE, PACKING SECUR*Z
V1*9302140*ONE HUMBER**094W****L
SE*15*875530003
GE*3*87553
IEA*1*000087553
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.