301 – Confirmation (Ocean)

What is an EDI 301?

An EDI 301 Booking Confirmation (Ocean) is used to confirm space, container and equipment availability for shipment or to notify other parties such as other ocean carriers.

Specifications and Key Data Elements:

  • Equipment to be transported through an ocean vessel
  • Space in an ocean vessel
  • Containers

M = Mandatory, O = Optional, X = Not Needed

ElementRefDescriptionElement IDTypeReqFixed ValuesSample SegmentComments
ST    Transaction Set HeaderST01Transaction Set ID Code143IDM301ST*301*942620001~

(Maximum Use = 1 )
ST02Transaction Set Control Number329ANM
B1    Beginning Segment for Booking or Pick-up/DeliveryB101Standard carrier alpha code


B101 is the Standard Carrier Alpha Code (SCAC) of either the carrier receiving the booking request or the carrier sending the booking confirmation.		140ANOB1*KHNN*7657*20230119*A~

(Maximum Use = 1 )		Standard Carrier Alpha Code (SCAC) of the carrier sending the EDI transmission (Booking Agent / Forwarder)
B102Shipment identification number


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)		145ANMLFL’s TM System’s Booking Number
(Sent in the EDI 300 in the B102 element)
B103Date

Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year.
373DTODate the booking was accepted by the carrier
YYYYMMDD

Date of Booking Confirmation
B104Reservation Action Code

Code identifying action on reservation or offering		558IDOA
= Reservation Accepted

D
= Reservation Cancelled

U
= Change
G61  ContactG6101Contact Function Code366IDO(Maximum Use = 3)
G6102Name93ANO
G6103Communication Number Qualifier365IDO
G6104Communication Number  364ANO
Y6 AuthenticationY601Authority Identifier Code313IDOY6***~

(Maximum Use = 2)
Y602Authority  151ANM
Y603Authorization Date275DTM
Y3 Space Confirmation
Y301Booking Number


Number assigned by the carrier for space reservation.

If space is available, all of the conditional data elements in segment Y3 are required. 		13ANMY3*KH8849303*CMDU*20230309*20230325***20230228*140000*O*PP~

(Maximum Use = 1)		Ocean Booking Number assigned by Ocean carrier for space reservation.

If the requested space is not available, Y301 should contain the word ‘DECLINE’ instead of the Booking Number.
Y302SCAC

Code identifying the Standard Carrier Alpha Code		140IDOSCAC of actual Ocean Carrier.
Y303Date

Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year.
373DTO/ZCCYYMMDD
Estimated Vessel Departure Date at Port of Loading

If actual date is unknown, provide estimated date
Y304Date

Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year.		373DTO/ZCCYYMMDD
Estimated Arrival Date at Place of Delivery

This may be a Port or Railhead.
Y305Standard Point Location Code

Code specifying the Standard Point Location code defined by National Motor Freight Tariff Association (NMFTA) or the Canadian Transportation Agency (CTA) point development group as the official code assigned to a city or point (for ratemaking purposes) within a city		154IDO
Y306Pier Name

Free-form name of the pier		112ANO
Y307Date

Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year.
373DTO/ZCCYYMMDD
Place of Receipt Cut-off Date
.

The latest date cargo can be delivered to place of receipt to make vessel/voyage for which cargo was booked.

If actual date is unknown, provide estimated date
Y308Time

Time expressed in 24-hour clock time as follows: HHMMSS, where H = hours (00-23), M = minutes (00-59), S = integer seconds (00-59)		337TMX/ZLoad Time

Formatted as: HHMMSS
Y309Transportation Method/Type Code

Code specifying the method or type of transportation for the shipment		91IDOO – Containerized Ocean
Y310Tariff Service Code

Code specifying the types of services for rating purposes		375IDODD – Door to Door
DP – Door to Port
PD – Port to Door
PP – Port to Port
PR – Port to Ramp
Y311Time Code

Code identifying the time. Y311 is the time zone which the time reflects.
 
If Y3-11 is present, then Y3-08 is required.
623IDO/ZLT
– Local Time
Y4  Container ReleaseY401Booking Number

Number assigned by the carrier for space reservation.             		13ANO/ZY4***20230203**2*45G1~

(Maximum Use = 1)
Y402Booking Number13ANO
Y403Date


Date expressed as CCYYMMDD where CC represents the first two digits of the calendar year.		373DTO/ZDate of Container Availability for Pick-up / Local Cargo Pickup Date

CCYYMMDD
Y404Standard Point Location Code

Y404 is the Standard Point Location Code (SPLC) of the container pickup location.		154IDO/Z
Y405Number of Containers

Number of shipping containers		95N0ONumber of Containers
Y406Equipment Type


Code identifying equipment type		24IDOEquipment ISO Code
Y407SCAC

Identifies the carrier to whom containers will be released, if known.		140IDO/Z
Y408Location Qualifier

If either Y4-08 or Y4-09 is present, then the other is required		309IDX
Y409Location Identifier

Code which identifies a specific location		310ANX
Y410Type of Service Code

Code specifying extent of transportation service requested		56IDO
W09 Equipment and TemperatureW0901Equipment Description Code40IDM(Maximum Use = 1)When possible, all N9 reference numbers sent on the 300 should be returned on the 301. At minimum, any reference numbers noted as ‘Required’, must be included on the 301.

SI
– Shipper’s Identifying Number for Shipment (SID)

A unique number assigned by LFL’s TM system to identify the Load (Container). Numeric only – No special characters or spaces
This reference number can repeat depending on the number of Ocean Containers assigned to the Booking.
Should contain all instances of N902 (N901 = “SI”) from 300.


FN
= Forwarder’s Reference

(REQUIRED)
  (Booking)


MB
= Ocean Carrier’s BOL (MBOL)

BM
= Bill of Lading (Booking level) – House BOL


OPTIONAL:


P8
= Pick up Number (Booking Confirmation #)
W0902Temperature408RX/ZDepending on the value of the N9-02:

Transportation System Load ID number (SI)
Forwarder’s Reference 
(FN)


VICS MBOL # (MB)


House Bill of Lading Number
Consignee’s Order Number
Pick up Number
W0903Unit or Basis for Measurement Code355IDXWhen N9-01 = SI
and carrier is listing Transportation System Load ID number (in N9-02), this element must contain the corresponding Ocean Equipment number if known.  If Equipment number is not available please enter PENDING

For all other N9-01 values, this element is optional.  
W0904Temperature408RX/Z
W0905Unit or Basis for Measurement Code355IDX
W0906Free-form Description 3ANO/Z
W0907Vent Setting Code1122IDO
W0908Percent488N0O/Z
W0909Quantity380RO/Z
Reference Identification Qualifier

Code identifying the Reference Identification		N901Reference Identification Qualifier128IDMN9*SI*1259~

N9*SI*1260~

N9*FN*PR38464~

N9*MB*18384649854123654~

N9*BM*SGN3865157~

(Maximum Use = 100)		When possible, all N9 reference numbers sent on the 300 should be returned on the 301. At minimum, any reference numbers noted as ‘Required’, must be included on the 301.

SI
– Shipper’s Identifying Number for Shipment (SID)

A unique number assigned by LFL’s TM system to identify the Load (Container). Numeric only – No special characters or spaces
This reference number can repeat depending on the number of Ocean Containers assigned to the Booking.
Should contain all instances of N902 (N901 = “SI”) from 300.

FN
= Forwarder’s Reference

(REQUIRED)
  (Booking)

MB
= Ocean Carrier’s BOL (MBOL)

BM
= Bill of Lading (Booking level) – House BOL

K+N: What numbers

OPTIONAL:
P8
= Pick up Number (Booking Confirmation #)
N902Reference Identification

Reference information as defined for a particular Transaction Set or as specified by the Reference Identification Qualifier.

At least one of N9-02 or N9-03 is required. 		127ANXDepending on the value of the N9-01

If multiple PO Numbers, separator TBD.
N903Free-form Description

Free-form descriptive text 		369ANXDepending on the value of the N9-01

If multiple PO Numbers, separator TBD.
N904Date373DTO
N905Time337TMX
N906Time Code623IDO/Z
N907Reference IdentifierC040O/Z
R2A Route information with Preference
R2A01Routing Sequence Code133IDM(Maximum Use = 25)
R2A02Preference1431IDM
R2A03Transportation Method/Type Code91IDO
R2A04Standard Carrier Alpha Code140IDO
R2A05Location Qualifier309IDO/Z
R2A06Location Identifier310ANX
R2A07Type of Service Code56IDO
N1 NameN101Entity Identifier Code98MID(Maximum Use = 1)
N102Name93XAN
N103Identification Code Qualifier66XID
N104Identification Code67XAN
N2 NameN201Name93MAN(Maximum Use = 1)
N202Name93OAN
N3 Address Information    N301Address Information166MAN(Maximum Use = 2)
N302Address Information166OAN
N4 Geographic LocationN401City name19OAN(Maximum Use = 1)
N402State of Province Code156OID
N403Postal Code116OID
G61  ContactG6101Contact Function Code366OID(Maximum Use = 3)
G6102Name93OAN
G6103Communication Number Qualifier365OID
G6104Communication Number  364OAN
R4  Port or Terminal
R401Port or Terminal Function Code115MIDR4*R*94*CNSHA*PORT OF SHANGHAI*CN~

R4*E*94*CAEDM*EDMONTON*CA***AB~

R4*D*UN*CAVAN*PORT OF  VANCOUVER*CA***BC~

(Maximum Use = 1)		The 300 contains all recommended route stops (R4 loops). The 301 should include all recommended route stops (unless changed) and any additional route stops related to booking (ie. – “T” (Transshipment port))


R
= Place of Receipt (Contractual) – REQUIRED

L
= Port of Loading(Operational)

D
= Port of Discharge (Operational)

7
= Destination Rail Intermodal Terminal

E
= Place of Delivery (Contractual) – REQUIRED
R402Location Qualifier

Code identifying type of location		309XID94
= Receiver’s Location Code


UN
= United Nations Location Code (UNLOCODE)
R403Location Identifier

Code which identifies a specific location		310XANLFL TM Location ID based on the R402 value
R404Port Name


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


R405Country Code26OIDTwo Character code in ISO 3166 
R406Terminal Name174OAN
R407Pier Number113OAN
R408State or Province Code156OIDUse postal abbreviations
DTM Date/Time ReferenceDTM01Date/Time Qualifier374MID(Maximum Use = 15)At least one of DTM02, DTM03 or DTM05 is required.
DTM02Date 373XDT
DTM03Time337XTM
DTM04Time Code623OID
DTM05Date Time Period Format Qualifier1250XID
DTM06Date Time Period1251XAN
W09 Equipment and TemperatureW0901Equipment Description Code40MID(Maximum Use = 1)
W0902Temperature408X/ZR
W0903Unit or Basis for Measurement Code355XID
W0904Temperature408X/ZR
W0905Unit or Basis for Measurement Code355XID
W0906Free-form Description 3O/ZAN
W0907Vent Setting Code1122OID
W0908Percent488O/ZN0
W0909Quantity380O/ZR
H3 Special Handling InstructionsH301Special Handling Code152XID(Maximum Use = 6)
H302Special Handling Description153XAN
H303Protective Service Code241OID
H304Vent Instruction Code242OID
H305Tariff Application Code257OID
EA Equipment AttributesEA01Equipment Attribute Code1402MID(Maximum Use = 5 )
EA02Composite Unit of MeasureC001X
EA03Quantity380XR
LX Assigned NumberLX01Assigned Number554MN0LX*1~

(Maximum Use = 1)
N7 Equipment DetailsN701Equipment Initial206OAN(Maximum Use = 1)
N702Equipment number207MAN
N703Weight81OR
N704Weight Qualifier187OID
N705Tare Weight167ON0
N706Weight Allowance232ON0
N707Dunnage205ON0
N708Volume183OR
N709Volume Unit Qualifier184OID
N710Ownership Code102OID
N711Equipment description code40OID
N712Standard Carrier Alpha Code140OID
N713Temperature Control319OAN
N714Position219OAN
N715Equipment Length567ON0
N716Tare Qualifier Code571OID
N717Weight Unit Code188OID
N718Equipment Number Check Digit761ON0
N719Type of Service Code56OID
N720Height65OR
N721Width189OR
N722Equipment Type24OID
N723Standard Carrier Alpha Code140OID
N724Car Type Code301OID
K1 RemarksK101Free-Form Message61MAN(Maximum Use = 10)
K102Free-Form Message61OAN
L0 Line Item – Quantity and WeightL01Lading Line Item Number213ON0
L02Billed/Rated-as Quantity220XR
L03Billed/Rated-as Qualifier221XID
L04Weight81XR
L05Weight Qualifier187XIDGG
= Gross Weight
L06Volume183XR
L07Volume Unit Qualifier184XIDE
= Cubic Feet

X
= Cubic Meters
L08Lading Quantity80X/ZN0
L09Packaging Form Code211XIDPCS
= Pieces
CTN = Cartons
L10Dunnage Description458OAN
L11Weight Unit Code188OIDK
= Kilograms

L
= Pounds
L5 Description, Marks and NumbersL501Lading Line Item Number213ON0(Maximum Use = 1)
L502Lading Description79OANDescription of an item as required for rating and billing purposes (commodity description)
L503Commodity Code22XANCode describing a commodity or group of commodities (harmonized code)
L504Commodity Code Qualifier23XIDAA
= Harmonized Tariff Schedule of the United States Annotated
L505Packaging Code103OAN
L506Marks and Numbers87XAN
L507Marks and Numbers Qualifier88OID
L508Commodity Code Qualifier23XID
L509Commodity Code22XAN
L510Compartment ID Code595OID
L4 MeasurementL401Length82MR(Maximum Use = 1)Largest horizontal dimension of an object measured when the object is in the upright position
L402Width189MRShorter measurement of the two horizontal dimensions measured with the object in the upright position
L403Height65MRVertical dimension of an object measured when the object is in the upright position
L404Measurement Unit Qualifier90MIDE
= Feet

X
= Meters
L405Quantity380OR
L406Industry Code1271O/ZAN
L1 Rate and ChargesL101Lading Line item number213OR(Maximum Use = 1)
L102Freight rate60MR
L103Rate/value qualifier122MPU
L104Charge58MN2
L105Advances191XN2
L106Prepaid Amount (Discount)117NN2
L107Rate Combination Point Code120OAN
L108Special Charge or Allowance Code150MID
L109Rate Class code121OID
L110Entitlement Code39OID
L111Charge Method of Payment16MAN
L112Special Charge Description276OAN
L113Tariff Application Code257OID
L114Declared Value75XN2
L115Rate/Value Qualifier122XID
L116Lading Liability Code372OID
L117Billed/Rated-as Quantity220MR
L118Billed/Rated-as Qualifier221MIDNU
L119Percent954O/ZR
L120Currency Code 100O/ZID
L121Amount610O/ZN2
H1 Hazardous MaterialH101Hazardous Material Code62MAN(Maximum Use = 1)Code relating to hazardous material code qualifier for regulated hazardous materials

Hazardous UN Number
H102Hazardous Material Class Code209OANCode specifying the kind of hazard for a material

Hazardous IMO Class
H103Hazardous Material Code Qualifier208OIDI
= Intergovernmental Maritime Organization (IMO) Code
H104Hazardous Material Description 64OANMaterial name, special instructions, and phone number if any
H105Hazardous Material Contact63OANPhone number and name of person or department to contact in case of emergency
H106Hazardous Materials Page200OAN
H107Flashpoint Temperature77XNThe flashpoint temperature for hazardous material
H108Unit or Basis for Measurement Code355XIDCode specifying the units in which a value is being expressed, or manner in which a measurement has been taken

CE = Centigrade – Celsius
FA = Fahrenheit
H109Packaging Group Code254OIDCode indicating degree of danger in terms of Roman number I, II or III
H2 Additional Hazardous Material DescriptionH201Hazardous Material Description 64MAN(Maximum Use = 1)Material name, special instructions, and phone number if any
H202Hazardous Material Classification274OANFree-form description of hazardous material classification or division or label requirements
V1 Vessel IdentificationV101Vessel Code


Code identifying vessel – IMO number

At least one of V1-01 or V1-02 is required

If V1-08 is present, then V1-01 is required		597XIDV1**DISCOVERY**C890*CAMN**GC~

(Maximum Use = 2)		Lloyd’s / IMO… three letters followed by a seven-digit number
V102Vessel Name


At least one of V1-01 or V1-02 is required		182XANLloyd’s of London Vessel Name
V103Country Code


code identifying the country in which the ship (vessel) is registered.		26O/ZID
V104Flight/Voyage Number


Identifying designator for the particular flight or voyage on which the cargo travels		55O/ZIDVoyage Number
V105SCAC


V105 identifies the ocean carrier.		140O/ZIDOcean Carrier SCAC
V106Vessel Requirement Code


Code specifying options for satisfying vessel requirements		249OID
V107Vessel Type Code


Code to determine type of vessel		854OIDGC = Main Vessel
SP = Supply Ship (Feeder Ship)
V108Vessel Code Qualifier


Code specifying vessel code source		897OIDIf V1-08 is present, then V1-01 is required

L = Lloyd’s Register of Shipping
V109Transportation Method/Type Code91OID
V9 Event DetailV901Event Code304MIDACA = SI – Cut Off
TRN = CY – Closing 
V902Event Code106OAN
V903Date373O/ZDTFormatted to:
CCYYMMDD
V904Time337X/ZTMFormatted to:
HHMMSS
V905City Name19OAN
V906State or Province Code156OID
V907Country Code26OID
V908Status Reason Code641OID
V909Standard Point Location Code154X/ZID
V910Quantity380X/ZR
V911Train Delay Reason Code1274XAN
V912Free-Form Message61OAN
V913Time Code623O/ZIDLT = Local Time
V914Quantity380O/ZR
V915Standard Point Location Code154O/ZID
V916Total Equipment86O/ZN0
V917Total Equipment86O/ZN0
V918Total Equipment86O/ZN0
V919Weight 81O/ZR
V920Length82O/ZR
SE  Transaction Set TrailerSE01Number of Included Sets96M N0SE*18*942620001~

(Maximum Use = 1)
SE02Transaction Set Control #329M AN