Stedi maintains this guide based on public documentation from Hapag Lloyd. Contact Hapag Lloyd for official EDI specifications. To report any errors in this guide, please contact us.

X12 301 Confirmation (Ocean)

X12 Release 4010

—

Delimiters

~ Segment
* Element
> Component

EDI sample

—

Sample 1

View the latest version of this implementation guide as an interactive webpage

https://www.stedi.com/app/guides/view/hapag-lloyd/confirmation-ocean/01HDSFEC5CDSPX6V5P0BCDFT5G

Build EDI implementation guides at stedi.com

ISA

Interchange Control Header

RequiredMax use 1

—

Example

ISA-01

I01

Authorization Information Qualifier

Required

Identifier (ID)

—

00: No Authorization Information Present (No Meaningful Information in I02)

ISA-02

I02

Authorization Information

Required

String (AN)

Min 10Max 10

—

ISA-03

I03

Security Information Qualifier

Required

Identifier (ID)

—

00: No Security Information Present (No Meaningful Information in I04)

ISA-04

I04

Security Information

Required

String (AN)

Min 10Max 10

—

ISA-05

I05

Interchange ID Qualifier

Required

Identifier (ID)

Min 2Max 2

—

Codes

01: Duns (Dun & Bradstreet)
02: SCAC (Standard Carrier Alpha Code)
03: FMC (Federal Maritime Commission)
04: IATA (International Air Transport Association)
08: UCC EDI Communications ID (Comm ID)
09: X.121 (CCITT)
10: Department of Defense (DoD) Activity Address Code
11: DEA (Drug Enforcement Administration)
12: Phone (Telephone Companies)
13: UCS Code (The UCS Code is a Code Used for UCS Transmissions; it includes the Area Code and Telephone Number of a Modem; it Does Not Include Punctuation, Blanks or Access Code)
14: Duns Plus Suffix
15: Petroleum Accountants Society of Canada Company Code
16: Duns Number With 4-Character Suffix
17: American Bankers Association (ABA) Transit Routing Number (Including Check Digit, 9 Digit)
18: Association of American Railroads (AAR) Standard Distribution Code
19: EDI Council of Australia (EDICA) Communications ID Number (COMM ID)
20: Health Industry Number (HIN)
21: Integrated Postsecondary Education Data System, or (IPEDS)
22: Federal Interagency Commission on Education, or FICE
23: National Center for Education Statistics Common Core of Data 12-Digit Number for Pre-K-Grade 12 Institutes, or NCES
24: The College Board's Admission Testing Program 4-Digit Code of Postsecondary Institutes, or ATP
25: American College Testing Program 4-Digit Code of Postsecondary Institutions, or ACT
26: Statistics of Canada List of Postsecondary Institutions
27: Carrier Identification Number as assigned by Health Care Financing Administration (HCFA)
28: Fiscal Intermediary Identification Number as assigned by Health Care Financing Administration (HCFA)
29: Medicare Provider and Supplier Identification Number as assigned by Health Care Financing Administration (HCFA)
30: U.S. Federal Tax Identification Number
31: Jurisdiction Identification Number Plus 4 as assigned by the International Association of Industrial Accident Boards and Commissions (IAIABC)
32: U.S. Federal Employer Identification Number (FEIN)
33: National Association of Insurance Commissioners Company Code (NAIC)
34: Medicaid Provider and Supplier Identification Number as assigned by individual State Medicaid Agencies in conjunction with Health Care Financing Administration (HCFA)
35: Statistics Canada Canadian College Student Information System Institution Codes
36: Statistics Canada University Student Information System Institution Codes
37: Society of Property Information Compilers and Analysts
AM: Association Mexicana del Codigo de Producto (AMECOP) Communication ID
NR: National Retail Merchants Association (NRMA) - Assigned
SN: Standard Address Number
ZZ: Mutually Defined

ISA-06

I06

Interchange Sender ID

Required

String (AN)

Min 15Max 15

—

ISA-07

I05

Interchange ID Qualifier

Required

Identifier (ID)

Min 2Max 2

—

Codes

01: Duns (Dun & Bradstreet)
02: SCAC (Standard Carrier Alpha Code)
03: FMC (Federal Maritime Commission)
04: IATA (International Air Transport Association)
08: UCC EDI Communications ID (Comm ID)
09: X.121 (CCITT)
10: Department of Defense (DoD) Activity Address Code
11: DEA (Drug Enforcement Administration)
12: Phone (Telephone Companies)
13: UCS Code (The UCS Code is a Code Used for UCS Transmissions; it includes the Area Code and Telephone Number of a Modem; it Does Not Include Punctuation, Blanks or Access Code)
14: Duns Plus Suffix
15: Petroleum Accountants Society of Canada Company Code
16: Duns Number With 4-Character Suffix
17: American Bankers Association (ABA) Transit Routing Number (Including Check Digit, 9 Digit)
18: Association of American Railroads (AAR) Standard Distribution Code
19: EDI Council of Australia (EDICA) Communications ID Number (COMM ID)
20: Health Industry Number (HIN)
21: Integrated Postsecondary Education Data System, or (IPEDS)
22: Federal Interagency Commission on Education, or FICE
23: National Center for Education Statistics Common Core of Data 12-Digit Number for Pre-K-Grade 12 Institutes, or NCES
24: The College Board's Admission Testing Program 4-Digit Code of Postsecondary Institutes, or ATP
25: American College Testing Program 4-Digit Code of Postsecondary Institutions, or ACT
26: Statistics of Canada List of Postsecondary Institutions
27: Carrier Identification Number as assigned by Health Care Financing Administration (HCFA)
28: Fiscal Intermediary Identification Number as assigned by Health Care Financing Administration (HCFA)
29: Medicare Provider and Supplier Identification Number as assigned by Health Care Financing Administration (HCFA)
30: U.S. Federal Tax Identification Number
31: Jurisdiction Identification Number Plus 4 as assigned by the International Association of Industrial Accident Boards and Commissions (IAIABC)
32: U.S. Federal Employer Identification Number (FEIN)
33: National Association of Insurance Commissioners Company Code (NAIC)
34: Medicaid Provider and Supplier Identification Number as assigned by individual State Medicaid Agencies in conjunction with Health Care Financing Administration (HCFA)
35: Statistics Canada Canadian College Student Information System Institution Codes
36: Statistics Canada University Student Information System Institution Codes
37: Society of Property Information Compilers and Analysts
AM: Association Mexicana del Codigo de Producto (AMECOP) Communication ID
NR: National Retail Merchants Association (NRMA) - Assigned
SN: Standard Address Number
ZZ: Mutually Defined

ISA-08

I07

Interchange Receiver ID

Required

String (AN)

Min 15Max 15

—

ISA-09

I08

Interchange Date

Required

Date (DT)

YYMMDD format

—

ISA-10

I09

Interchange Time

Required

Time (TM)

HHMM format

—

ISA-11

I10

Interchange Control Standards Identifier

Required

Identifier (ID)

—

U: U.S. EDI Community of ASC X12, TDCC, and UCS

ISA-12

I11

Interchange Control Version Number

Required

Identifier (ID)

—

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

—

ISA-14

I13

Acknowledgment Requested

Required

Identifier (ID)

Min 1Max 1

—

0: No Acknowledgment Requested
1: Interchange Acknowledgment Requested

ISA-15

I14

Usage Indicator

Required

Identifier (ID)

Min 1Max 1

—

I: Information
P: Production Data
T: Test Data

ISA-16

I15

Component Element Separator

Required

String (AN)

Min 1Max 1

—

>: Component Element Separator

Functional Group Header

RequiredMax use 1

—

Example

GS-01

479

Functional Identifier Code

Required

Identifier (ID)

—

RO: Ocean Booking Information (300, 301,303)

GS-02

142

Application Sender's Code

Required

String (AN)

Min 2Max 15

—

GS-03

124

Application Receiver's Code

Required

String (AN)

Min 2Max 15

—

GS-04

373

Date

Required

Date (DT)

CCYYMMDD format

—

GS-05

337

Time

Required

Time (TM)

HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format

—

GS-06

Group Control Number

Required

Numeric (N0)

Min 1Max 9

—

GS-07

455

Responsible Agency Code

Required

Identifier (ID)

Min 1Max 2

—

T: Transportation Data Coordinating Committee (TDCC)
X: Accredited Standards Committee X12

GS-08

480

Version / Release / Industry Identifier Code

Required

String (AN)

—

004010: Draft Standards Approved for Publication by ASC X12 Procedures Review Board through October 1997

Heading

010

Heading > ST

Transaction Set Header

RequiredMax use 1

—

Example

ST-01

143

Transaction Set Identifier Code

Required

Identifier (ID)

—

301: Confirmation (Ocean)

ST-02

329

Transaction Set Control Number

Required

Numeric (N)

Min 4Max 9

—

020

Heading > B1

Beginning Segment for Booking or Pick-up/Delivery

RequiredMax use 1

—

Usage notes

—

Example

B1-01

140

Standard Carrier Alpha Code

Optional

Identifier (ID)

Min 2Max 4

—

Usage notes

—

B1-02

145

Shipment Identification Number

Required

String (AN)

Min 1Max 30

—

Usage notes

—

B1-04

558

Reservation Action Code

Optional

Identifier (ID)

—

N: New
R: Delete
U: Change

040

Heading > Y3

Space Confirmation

RequiredMax use 1

—

Usage notes

—

Example

If Transportation Method/Type Code (Y3-09) is present, then Time (Y3-08) is required

Y3-01

Booking Number

Required

String (AN)

Min 1Max 17

—

Usage notes

—

Y3-02

140

Standard Carrier Alpha Code

Optional

Identifier (ID)

Min 2Max 4

—

Usage notes

—

Y3-03

373

Date

Optional

Date (DT)

CCYYMMDD format

—

Usage notes

—

Y3-04

373

Date

Optional

Date (DT)

CCYYMMDD format

—

Usage notes

—

Y3-08

337

Time

Optional

Time (TM)

HHMM, HHMMSS, HHMMSSD, or HHMMSSDD format

—

Usage notes

—

Y3-09

Transportation Method/Type Code

Optional

Identifier (ID)

—

SB: Shipper Agent
—
SC: Shipper Agent (Truck)
—
SD: Shipper Association
—

Y4 Loop

OptionalMax >1

050

Heading > Y4 Loop > Y4

Container Release

RequiredMax use 1

—

Usage notes

—

Example

Y4-01

Booking Number

Optional

String (AN)

Min 1Max 17

—

Usage notes

—

Y4-04

154

Standard Point Location Code

Optional

Identifier (ID)

Min 6Max 9

—

Usage notes

—

Y4-05

Number of Containers

Optional

Numeric (N0)

Min 1Max 4

—

Usage notes

—

Y4-06

Equipment Type

Optional

Identifier (ID)

Min 4Max 4

—

Usage notes

—

Y4-10

Type of Service Code

Optional

Identifier (ID)

Min 2Max 2

—

Y4 Loop end

N1 Loop

OptionalMax >1

060

Heading > N1 Loop > N1

Name

RequiredMax use 1

—

Example

N1-01

Entity Identifier Code

Required

Identifier (ID)

Min 2Max 3

—

N1-02

Name

Optional

String (AN)

Min 1Max 60

—

N1 Loop end

R4 Loop

RequiredMax >1

110

Heading > R4 Loop > R4

Port or Terminal

RequiredMax use 1

—

Usage notes

—

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)

—

L: Port of Loading (Operational)
—
P: Dispatching Pool (Operational)
—
R: Place of Receipt (Contractual)

R4-02

309

Location Qualifier

Optional

Identifier (ID)

—

D: Census Schedule D
K: Census Schedule K

R4-03

310

Location Identifier

Optional

String (AN)

Min 1Max 30

—

Usage notes

—

R4-04

114

Port Name

Optional

String (AN)

Min 2Max 24

—

Usage notes

—

R4-05

Country Code

Optional

Identifier (ID)

Min 2Max 3

—

Usage notes

—

R4-06

174

Terminal Name

Optional

String (AN)

Min 2Max 30

—

Usage notes

—

R4 Loop end

Heading end

Detail

LX Loop

RequiredMax >1

010

Detail > LX Loop > LX

Assigned Number

RequiredMax use 1

—

Usage notes

—

Example

LX-01

554

Assigned Number

Required

Numeric (N0)

Min 1Max 6

—

020

Detail > LX Loop > N7

Equipment Details

OptionalMax use 1

—

Usage notes

—

Example

N7-01

206

Equipment Initial

Optional

String (AN)

Min 1Max 4

—

Usage notes

—

N7-02

207

Equipment Number

Required

String (AN)

Min 1Max 10

—

Usage notes

—

N7-22

Equipment Type

Optional

Identifier (ID)

Min 4Max 4

—

Usage notes

—

W09

021

Detail > LX Loop > W09

Equipment and Temperature

OptionalMax use 1

—

Usage notes

—

Example

If either Temperature (W09-02) or Unit or Basis for Measurement Code (W09-03) is present, then the other is required

W09-01

Equipment Description Code

Required

Identifier (ID)

—

CN: Container
CZ: Refrigerated Container
—

W09-02

408

Temperature

Optional

Decimal number (R)

Min 1Max 4

—

Usage notes

—

W09-03

355

Unit or Basis for Measurement Code

Optional

Identifier (ID)

—

CE: Centigrade, Celsius

W09-06

Free Form Message

Optional

String (AN)

Min 1Max 60

—

Usage notes

—

W09-07

1122

Vent Setting Code

Optional

Identifier (ID)

—

A: Vent 25% Open
B: Vent 50% Open
C: Vent 75% Open
D: Vent 100% Open
E: Closed
F: Vent 10% Open
Z: Carrier to Set Based on Commodity Type
—

W09-08

488

Percent

Optional

Numeric (N0)

Min 1Max 3

—

Usage notes

—

W09-09

380

Quantity

Optional

Decimal number (R)

Min 1Max 15

—

030

Detail > LX Loop > K1

Remarks

OptionalMax use 10

—

Usage notes

—

Example

K1-01

Free-Form Message

Required

String (AN)

Min 1Max 30

—

Usage notes

—

K1-02

Free-Form Message

Optional

String (AN)

Min 1Max 30

—

LX Loop end

080

Detail > V1

Vessel Identification

OptionalMax use 2

—

Usage notes

—

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

—

Usage notes

—

V1-02

182

Vessel Name

Optional

String (AN)

Min 2Max 28

—

Usage notes

—

V1-03

Country Code

Optional

Identifier (ID)

Min 2Max 3

—

V1-04

Flight/Voyage Number

Optional

String (AN)

Min 2Max 10

—

Usage notes

—

V1-05

140

Standard Carrier Alpha Code

Optional

Identifier (ID)

Min 2Max 4

—

V1-08

897

Vessel Code Qualifier

Optional

Identifier (ID)

—

L: Lloyd's Register of Shipping

Detail end

Summary

010

Summary > SE

Transaction Set Trailer

RequiredMax use 1

—

Example

SE-01

Number of Included Segments

Required

Numeric (N0)

Min 1Max 10

—

SE-02

329

Transaction Set Control Number

Required

Numeric (N)

Min 4Max 9

—

Summary end

Functional Group Trailer

RequiredMax use 1

—

Example

GE-01

Number of Transaction Sets Included

Required

Numeric (N0)

Min 1Max 6

—

GE-02

Group Control Number

Required

Numeric (N0)

Min 1Max 9

—

IEA

Interchange Control Trailer

RequiredMax use 1

—

Example

IEA-01

I16

Number of Included Functional Groups

Required

Numeric (N0)

Min 1Max 5

—

IEA-02

I12

Interchange Control Number

Required

Numeric (N0)

Min 9Max 9

—

EDI Samples

Sample 1

ISA*00* *00* *ZZ*SENDER *ZZ*RECEIVER *231027*2252*U*00401*000000001*0*T*>~
GS*RO*SENDERGS*RECEIVERGS*20231027*225230*000000001*X*004010~
ST*301*0001~
B1*HLCU*40113992**N~
Y3*40113992*HLCU*20130412*20130507****1200*SB~
Y4*40113992***MTR011*1*2232****PP~
Y4*40113992***MTR011*1*2200****PP~
Y4*40113992***MTR011*1*4500****PP~
R4*R*D*4601*NEW YORK, NY*US*TERMIN425~
R4*L*D*4601*NEW YORK, NY*US*HOWLAN001~
LX*1~
N7*UNKN*0000001********************2232~
W09*CZ*-6.6*CE*****70*10~
K1*CARBON DIOXYD IN PCT*020~
K1*OXYGEN IN PCT*010~
K1*NITROGEN IN PCT*030~
K1*SPECIAL-ATMOSPHERE*CONTROLLED ATMOSPHERE~
K1*REMARKS1*REMARKS2~
K1*REMARKS3*REMARKS4~
LX*2~
N7*GATU*8084352********************4500~
LX*3~
N7*UNKN*0000001********************2232~
K1*SPECIAL-ATMOSPHERE*NONE~
K1*NON OPERATING REEFER~
V1*8406274*ROME EXPRESS*BM*96E16*HLCU***L~
SE*25*0001~
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.