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
- None included
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
Example: B1SCAC201401749020151016U~
Standard Carrier Alpha Code
- B101 is the Standard Carrier Alpha Code (SCAC) of the carrier sending the EDI transmission.
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)
Customer Shipment Identification Number will be the key / identifier and it will be sent if provided on the original customer booking request.
Date expressed as CCYYMMDD
- B103 is the booking date accepted by the carrier.
Booking Status Date.
Code identifying action on reservation or offering
- A
- Reservation Accepted
- D
- Reservation Cancelled
Booking cancel by customer.
- P
- Pending
- R
- Delete
Rejected/Declined.
- S
- No Show
Booking accepted, but no follow up action by customer.
- U
- Change
Space Confirmation
To specify confirmation information for space booking including numbers, dates, and load time
Example:
Y33028924760SCAC2015121120151223201512101200PD~
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'.
"DECLINE" will be provided when B104 = "R".
Date expressed as CCYYMMDD
- Y303 is the date of departure of the vessel.
Estimated Departure Date at Port of Loading.
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.
Place of Receipt Cut-off 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.
Place of Receipt Cut-off Time.
Code specifying the types of services for rating purposes
- DD
- Door-to-Door
- DP
- Door-to-Pier
- PD
- Pier-to-Door
- PP
- Pier-to-Pier
Container Release
To transmit information relative to containers available for release
Example: Y42015110214500****05~
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.
Date expressed as CCYYMMDD
- Y403 is the date of container availability for pickup.
Number of shipping containers
Optional when the booking is related to Awkward cargo. For other cargo types, this field is mandatory.
Code identifying equipment type
Optional when the booking is related to Awkward cargo. For other cargo types, this field is mandatory.
Please refer to the Appendix for the full list. For customized code list, please contact CargoSmart for more details.
Code specifying extent of transportation service requested
Optional when B104 = "D".
- 02
- LCL/LCL
- 03
- FCL/FCL
- 04
- FCL/LCL
- 05
- LCL/FCL
Equipment and Temperature
To relate equipment type and required temperatures
Example: W09CZ50FA*E1~
Code identifying type of equipment used for shipment
- CZ
- Refrigerated Container
Temperature
- W0902 is the minimum allowable temperature condition for shipment; (the qualifying temperature scale is specified in W0903).
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 describing the setting on the air vents on ocean-type containers
- A
- Vent 25% Open
- B
- Vent 50% Open
- C
- Vent 75% Open
- D
- Vent 100% Open
- E
- Closed
Percent expressed as 0 to 100
- W0908 is the humidity percentage.
Numeric value of quantity
- W0909 is the number of air exchanges per hour.
Reference Identification
To transmit identifying information as specified by the Reference Identification Qualifier
Example: N9BN540600071643~
Code qualifying the Reference Identification
- 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
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
Example: N1SHSHIPPER NAME2500012338~
Code identifying an organizational entity, a physical location, property or an individual
- BK
- Booking Party
Mandatory.
- CA
- Carrier
Mandatory.
- CN
- Consignee
- CR
- Container Return Company
Full Return.
Carrier should provide full return address for outbound customer haulage pier-to-pier(Y310 = "PP") or pier-to door (Y310 = "PD").
- FW
- Forwarder
- N1
- Notify Party no. 1
First Notify Party.
- N2
- Notify Party no. 2
Multiple N2 will be provided when more than 2 notify parties.
- PW
- Pick Up Address
Empty Pick Up.
Carrier should provide empty pick-up address for outbound customer haulage pier-to-pier (Y310= "PP") or pier-to-door (Y310 = "PD").
- SF
- Ship From
Carrier should provide Ship From (full container pickup) address for carrier haulage door-to-door (Y310 = "DD") or door-to-pier (Y310 = "DP").
- SH
- Shipper
- ST
- Ship To
Carrier should provide Ship To (full container delivery) address for carrier haulage door-to-door (Y310 = "DD") or pier-to-door (Y310 = "DP").
Code designating the system/method of code structure used for Identification Code (67)
- 25
- Carrier's Customer Code
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.
Address Information
To specify the location of the named party
Example: N3*11200 EAST FORTY-FIFTH AVE.*DENVER,CO12345, U.S.A.~
Geographic Location
To specify the geographic place of the named party
Example: N4HOUSTONTX**US~
Free-form text for city name
- A combination of either N401 through N404, or N405 and N406 may be adequate to specify a location.
Code (Standard State/Province) as defined by appropriate government agency
- N402 is required only if city name (N401) is in the U.S. or Canada.
Code defining international postal zone code excluding punctuation and blanks (zip code for United States)
Contact
To identify a person or office to whom communications should be directed
Example: G61ICHOLLYTE86-755-12345678~
Code identifying the major duty or responsibility of the person or group named
- IC
- Information Contact
Code identifying the type of communication number
- G6103 qualifies G6104.
- EM
- Electronic Mail
- FX
- Facsimile
- TE
- Telephone
Complete communications number including country or area code when applicable
Recommended phone number and fax number format: - -. For example: 86-755-12345678.
Port or Terminal
Contractual or operational port or point relevant to the movement of the cargo
Either location code or location name must be provided.
Example: R4DUNUSNYCNYC-NYC TERM*US~
Code defining function performed at the port or terminal with respect to a shipment
- D
- Port of Discharge (Operational)
- E
- Place of Delivery (Contractual)
- L
- Port of Loading (Operational)
- R
- Place of Receipt (Contractual)
Code identifying type of location
- UN
- United Nations Location Code (UNLOCODE)
Free-form name for the place at which an offshore carrier originates or terminates (by transshipment or otherwise) its actual ocean carriage of property
Code (Standard State/Province) as defined by appropriate government agency
Date/Time Reference
To specify pertinent dates and times
Example: DTM13920151129~
Code specifying type of date or time, or both date and time
- 139
- Estimated
- 140
- Actual
- 649
- Document Due
SI Document CutOff Date. This information will be provided under R401 = "L" when available.
- AAG
- Due Date
SOLAS VGM Cutoff Date. This information will be provided under R401 = "L" when available.
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)
Detail
Assigned Number
To reference a line number in a transaction set
Example: LX*1~
Number assigned for differentiation within a transaction set
Equipment Details
To identify the equipment
Example: N7OOLU0115221000G**********0BOX~
Prefix or alphabetic part of an equipment unit's identifying number
- N701 is mandatory for rail transactions.
Sequencing or serial part of an equipment unit's identifying number (pure numeric form for equipment number is preferred)
Code defining the type of weight
- G
- Gross Weight
- N
- Actual Net Weight
Code identifying the volume unit
- E
- Cubic Feet
- X
- Cubic Meters
Number which designates the check digit applied to a piece of equipment
Code identifying equipment type
Please refer to the Appendix for the full list. For customized code list, please contact CargoSmart for more details.
Line Item - Quantity and Weight
To specify quantity, weight, volume, and type of service for a line item including applicable "quantity/rate-as" data
Example: L021000G***L~
Sequential line number for a lading item
Code defining the type of weight
- G
- Gross Weight
- N
- Actual Net Weight
Code identifying the volume unit
- E
- Cubic Feet
- X
- Cubic Meters
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
Please refer to the Appendix for the full list. For customized code list, please contact CargoSmart for more details.
Code specifying the weight unit
- K
- Kilograms
- L
- Pounds
- T
- Long Ton
Description, Marks and Numbers
To specify the line item in terms of description, quantity, packaging, and marks and numbers
Example: L52MISCELLANEOUS, NOS~
Sequential line number for a lading item
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.
Code describing a commodity or group of commodities
Code identifying the commodity coding system used for Commodity Code
- A
- Harmonized Tariff Schedule of the United States Annotated
Marks and numbers used to identify a shipment or parts of a shipment
Measurement
To describe physical dimensions and quantities
Example: L4111E
Largest horizontal dimension of an object measured when the object is in the upright position
Shorter measurement of the two horizontal dimensions measured with the object in the upright position
Vertical dimension of an object measured when the object is in the upright position
Code specifying the linear dimensional unit
- E
- Feet
- X
- Meters
Hazardous Material
To specify information relative to hazardous material
Example: H116736.1IPHENYLENEDIAMINESCHEMTREC***III~
Code relating to hazardous material code qualifier for regulated hazardous materials
Code specifying the kind of hazard for a material
Code which qualifies the Hazardous Material Class Code (209)
- I
- Intergovernmental Maritime Organization (IMO) Code
Material name, special instructions, and phone number if any
Phone number and name of person or department to contact in case of emergency
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
Example: H2*PHENYLENEDIAMINES~
Vessel Identification
To provide vessel details and voyage number
Example: V11234529APL BEIJING*020E***L~
Name of ship as documented in "Lloyd's Register of Ships"
Identifying designator for the particular flight or voyage on which the cargo travels
Code specifying vessel code source
- L
- Lloyd's Register of Shipping
- Z
- Mutually Defined
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
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.