Tracelink University ## Breadcrumb 1. [Home](/) 2. [Resources](/resources/resource-center) 3. [TraceLink University](/resources/tracelink-university) # Ocean shipment status (X12) - [Download PDF](/node/627646/pdf) - [Share](#) - [ LinkedIn ](https://www.linkedin.com/shareArticle?mini=true&url=https://www.tracelink.com/resources/tracelink-university/ocean-shipment-status-x12&title=Ocean shipment status (X12)&summary=Ocean Shipment Status is an electronic message used by ocean carriers to provide shipment updates on the movement and handling of ocean freight shipments. &source=TraceLink "LinkedIn") - [ Facebook ](https://www.facebook.com/share.php?u=https://www.tracelink.com/resources/tracelink-university/ocean-shipment-status-x12&t=Ocean shipment status (X12) "Facebook") - [ Mail ](mailto:?subject=Ocean shipment status (X12)+|+TraceLink&body=https://www.tracelink.com/resources/tracelink-university/ocean-shipment-status-x12 "Mail") - [ Twitter ](https://twitter.com/intent/tweet?text=Ocean shipment status (X12) https://www.tracelink.com/resources/tracelink-university/ocean-shipment-status-x12&via=TraceLink "Twitter") #### Table of contents Ocean Shipment Status is an electronic message used by ocean carriers to provide shipment updates on the movement and handling of ocean freight shipments. It delivers visibility into key events from the moment a container is loaded at the port of origin through transshipment to its arrival at the destination port. These updates function much like package tracking for ocean freight, keeping stakeholders informed throughout the shipment’s journey. An Ocean Shipment Status message can provide updates on container loading and vessel departures, port arrivals and transshipment movements, the status of customs clearance, notifications of delays with their reasons, and confirmation of delivery or hand off at the final port. The Ocean Shipment Status X12 message enables proactive supply chain management by alerting stakeholders to key events like vessel departures, port arrivals, customs updates, and potential disruptions. ![](/sites/default/files/tech_comms/mpl/Content/Resources/Images/global_images/note_tip_24x24.png) Contact your TraceLink Services representative for more information about integrating with this message. - **Message Type** : MPC\_OCEAN\_SHIPMENT\_STATUS - **X12 Format**: OCEANSHIPMENTSTATUS - **Transform Names**: - B2B\_EDI\_X12\_315\_OceanShipmentStatus\_IB\_V2 - B2B\_EDI\_X12\_315\_OceanShipmentStatus\_OB\_V1 [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Guidelines](#) Input Element Occurs Length Description Examples 315 1…1 – **Required.** X12 315 Ocean shipment status. – ISA 1…1 – **Required.** ISA interchange envelope. – ISA01 1…1 2/2 **Required.** Qualifier for authorization control number in ISA02. 00 ISA02 1…1 10/10 **Required.** Information used for additional identification or authorization of the interchange sender or the data in the interchange/ 10 spaces a valid entry. – ISA03 1…1 2/2 **Required.** Qualifier for security information in ISA04. 00 ISA04 1…1 10/10 **Required.** Identifies security information about the interchange sender or data. ISA05 1…1 2/2 **Required.** Interchange sender partner ID qualifier. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `01` – Duns (Dun & Bradstreet). - `02` – Standard Carrier Alpha Code. - `03` – Federal Maritime Commission. - `04` – International Air Transport Association. - `07` – Global Location Number (GLN). - `08` – UCC EDI Communications ID (Comm ID). - `09` – X.121 (CCITT). - `10` – Department of Defense (DoD) Activity Address Code. - `11` – Drug Enforcement Administration identifier. - `12` – Telephone Companies. - `13` – Used for UCS Transmissions. Includes Area Code and Telephone Number of a Modem. - `14` – Duns Plus Suffix. - `15` – Petroleum Accountants Society of Canada Company Code. - `16` – DINS 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. - `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. - `24` – The College Board's Admission Testing Program 4-Digit Code of Postsecondary Institutes, or ATP. - `25` – 4-Digit Code of Postsecondary Institutions. - `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 assigned by Health Care Financing Administration (HCFA). - `30` – U.S. Federal Tax Identification Number. - `31` – Jurisdiction Identification Number Plus 4 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 (SPICA). - `38` – The College Board and ACT, Inc. 6-Digit Code List of Secondary Institutions. - `AM` – Association Mexicana del Codigo de Producto (AMECOP) Communication ID. - `NR` – National Retail Merchants Association (NRMA) - Assigned. - `SA` – User Identification Number as assigned by the Safety and the Fitness Electronic Records (SAFER) System. - `SN` – Standard Address Number. - `ZZ` – Mutually Defined. 07 ISA06 1…1 15/15 **Required.** Interchange sender identification mapping to fileSenderNumber with party type defined in ISA05. 7777776067344 ISA07 1…1 2/2 **Required.** Interchange receiver partner ID qualifier. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `01` – Duns (Dun & Bradstreet). - `02` – Standard Carrier Alpha Code. - `03` – Federal Maritime Commission. - `04` – International Air Transport Association. - `07` – Global Location Number (GLN). - `08` – UCC EDI Communications ID (Comm ID). - `09` – X.121 (CCITT). - `10` – Department of Defense (DoD) Activity Address Code. - `11` – Drug Enforcement Administration identifier. - `12` – Telephone Companies. - `13` – Used for UCS Transmissions. Includes Area Code and Telephone Number of a Modem. - `14` – Duns Plus Suffix. - `15` – Petroleum Accountants Society of Canada Company Code. - `16` – DINS 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. - `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. - `24` – The College Board's Admission Testing Program 4-Digit Code of Postsecondary Institutes, or ATP. - `25` – 4-Digit Code of Postsecondary Institutions. - `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 assigned by Health Care Financing Administration (HCFA). - `30` – U.S. Federal Tax Identification Number. - `31` – Jurisdiction Identification Number Plus 4 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 (SPICA). - `38` – The College Board and ACT, Inc. 6-Digit Code List of Secondary Institutions. - `AM` – Association Mexicana del Codigo de Producto (AMECOP) Communication ID. - `NR` – National Retail Merchants Association (NRMA) - Assigned. - `SA` – User Identification Number as assigned by the Safety and the Fitness Electronic Records (SAFER) System. - `SN` – Standard Address Number. - `ZZ` – Mutually Defined. 01 ISA08 1…1 15/15 **Required.** EDI receiver ID mapping to file control header and to ServiceLinkId. 888888404358877 ISA09 1…1 6/6 **Required.** Interchange date in 6 char YYMMDD format. 231020 ISA10 1…1 4/4 **Required.** Interchange time in 4 char HHMM format. 1420 ISA11 1…1 1/1 **Required.** This value is dependent on X12 version. - `Version 4012 and earlier` – Interchange control standards identifier. The valid value is `U`. - `Version 004020 and later` – Repetition separator, a delimiter that separates repeated occurrences of a data element or composite data structure, which must be different from the data element separator, component separator, and segment terminator. ^ ISA12 1…1 5/5 **Required.** Interchange control version number. This could be any X12 version. 00501 ISA13 1…1 9/9 **Required.** Interchange Control Number mapping to file control header 0000000000619827 ISA14 1…1 1/1 **Required.** Interchange level acknowledgment requested. Valid values: - `0`- No acknowledgment requested - `1` - Interchange level acknowledgment requested 0 ISA15 1…1 1/1 **Required.** Indicates whether the interchange is for production, test, or information purposes. Valid values: - `I` - Information - `P` - Production data - `T`- Test data P ISA16 1…1 1/1 **Required.** Component element separator. Delimiter that separates data elements within a composite data structure. Must be different than the data element separator and segment terminator. > GS 1…\* – GS group functional envelope. Child of ISA. Only one GS group expected per interchange. – GS01 1…1 2/2 **Required.** GS group function code. The valid value is `IO` – Ocean shipment arrival notice Information. QO GS02 1…1 2/15 **Required.** Application Sender's Code. 2222224043588 GS03 1…1 2/15 **Required.** Application Receiver's Code. TRACELINK GS04 1…1 8/8 **Required.** Current date stamp in 8 char X12 date format YYYYMMDD. 20241020 GS05 1…1 4/8 **Required.** Current time stamp in 6 char X12 time format HHMMSS. 142000 GS06 1…1 1/9 **Required.** Group Control ID Number. 619827 GS07 1…1 1/2 **Required.** Responsible Agency Code. Valid values: - `T` – Transportation Data Coordinating Committee (TDCC) - `X` – Accredited Standards Committee X12 X GS08 1…1 1/12 **Required.** X12 message version code. This could be any X12 version. 005010 ST 1…\* – ST transaction set envelope. Child of GS group. Only one ST transaction expected. – ST01 1…1 3/3 **Required.** Transaction set identifier code. 312 ST02 1…1 4/9 **Required.** Transaction set ID number. Counter for each ST segment beginning with 1. 0001 B4 1…1 – **Required.** Ocean Shipment Status beginning segment for Inquiry or Reply. – B402 0…1 1/3 Inquirer assigned identifying number. 1 B403 0…1 1/2 Shipment status code. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values ](#)- `1` – Shipment was delivered with missing piece or pieces - `2` – Returned to carrier terminal - `3` – Returned to shipper - `4` – Shipment delivered with damage noted by carrier or consignee - `A` – Shipment has arrived at the location specified - `AA` – Pick-up appointment date and time - `AC` – Awaiting clearance - `AD` – Delivery appointment date and time - `AE` – Loaded on vessel - `AF` – Carrier departed pickup location with shipment - `AG` – Estimated delivery - `AH` – Attempted delivery - `AI` – Shipment has been reconsigned - `AJ` – Tendered for delivery - `AL` – Loaded on rail - `AM` – Loaded on truck - `AN` – Delivered to air carrier - `AO` – Loaded on barge - `AP` – Loaded on feeder vessel - `AR` – Rail arrival at destination intermodal ramp - `AU` – Shipment available for pick-up - `AV` – Available for delivery - `AW` – Awaiting for export - `B` – Shipment was inoperative, equipment failed - `BC` – Storage in transit - `BR` – Bill of lading released - `C` – Estimated to depart terminal location - `CD` – Received at origin - `CH` – Customs hold - `CR` – Carrier release - `CS` – Container sealed - `CT` – Customs released - `CU` – Carrier and customs released - `D` – Shipment was delivered to the consignee or receiver - `DO` – Destination stop-off - `E` – Estimated to arrive (en route) - `EE` – Empty equipment dispatched - `HR` – Carrier un-release (hold released) - `I` – In-gate - `IB` – U.S. Customs, in-bond movement authorized - `J` – Delivered to connecting line - `K` – Arrived at customs - `K3` – Complete customs paperwork has been provided - `L` – Loading - `N` – No paperwork received with shipment or equipment - `O` – Paperwork received – did not receive shipment or equipment - `OA` – Out gate - `OP` – All paperwork has been provided to consignee - `P` – Departed terminal location, shipment has left the carrier's terminal or other control point - `PA` – U.S. Customs hold, intensive examination - `PB` – U.S. Customs hold, insufficient paperwork - `PC` – U.S. Customs hold, discrepancy paperwork - `PD` – U.S. Customs hold, discrepancy piece count - `PE` – U.S. Customs and Border Protection (CBP) hold, hold by Coast Guard - `PF` – U.S. Customs and Border Protection (CBP) hold, hold by F.B.I. - `PI` – U.S. Customs and Border Protection (CBP) hold, hold by Food and Drug - `PK` – U.S. Customs and Border Protection (CBP) hold, hold by Drug Enforcement - `NH` – Awaiting for hazardous material document - `NR` – Awaiting for shipment information - `NS` – No seal on load - `RB` – Delivery appointment requested - `RD` – Return container - `RL` – Rail departure from origin intermodal ramp - `SD` – Shipment delayed - `T` – At terminal, intra-terminal movement - `U` – Unloading - `UC` – Shipment container unloaded from chassis - `UO` – Unloaded from barge - `UR` – Shipment conveyance unloaded from rail car - `UV` – Unloaded from vessel - `VA` – Vessel scheduled to arrive or has arrived - `VD` – Vessel scheduled to depart or has departed - `W` – Released by customer - `X1` – Arrived at delivery location - `X2` – Estimated date/time of arrival at consignee's location - `X3` – Arrived at pickup location - `X4` – Arrived at terminal location - `X5` – Arrived at delivery location delivery dock - `X6` – Enroute to delivery location - `X7` – Enroute to pickup location - `X8` – Arrived at pickup location loading dock - `X9` – Arrived at carrier's warehouse - `XB` – Shipment acknowledged - `ZZ` – Custom status code AE B404 0…1 8/8 Date of last reported status of cargo in YYYYMMDD format. 20070609 B405 0…1 '4/8 Transaction time in hhmmss format. 131204 B406 0…1 3/5 Airport code in case of air shipment or carrier terminal code in case of ground transportation, status location. – B407 0…1 1/4 Prefix or alphabetic part of an equipment unit's identifying number. If either B4-07 or B4-08 is present, then the other is required. HASU B408 0…1 1/15 Serial number part of an equipment unit's identifying number. 483190 B409 0…1 1/2 Carrier status code. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values ](#)- `AA` – Empty and Available at Pool - `AB` – Out Empty to Pick Up Cargo from the Shipper - `AC` – Loaded en route to port of loading or baseport - `AG` – Received at port of discharge or baseport - `AH` – Loaded en route to consignee - `AI` – Stripped and en route to pool from a consignee - `AJ` – Empty Positioning - `AK` – Out of Service - `AL` – Empty Non-hazardous Last Contained - `D` – Deadhead Locomotive or Caboose - `E` – Empty - `HR` – Held for Reload - `L` – Load - `LI` – Loaded Inbound - `LO` – Loaded Outbound - `O` – Operating Locomotive or Caboose - `RJ` – Rejected/Unusable - `W` – Revenue Empty L B410 0…1 4/4 A 4-character ISO 6346 equipment type code, represents type of equipment. 22G1 B411 0…1 1/30 Location Identifier. If either B4-11 or B4-12 is present, then the other is required. USLGB B412 0…1 1/2 Location qualifier, indicating type of location. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values ](#)- `18` – Marker identifier location. - `CI` – City code. - `D` – Domestic U.S. ports (Schedule D). - `L` – Local address. - `K` – Foreign ports (Schedule K), and international. - `UN` – United Nations Location Code. - `OV` – On Vessel (Free On Board \[FOB\] point) - `CY` – Container Yard - Area designated for container storage. - `DC` – Distribution Center Number. - `DE` – Destination - Shipping. - `DO` – District Office. - `FR` – U.S. Customs Facilities Information and Resource Management Systems (FIRMS) — Identifies U.S. Customs facilities related to the shipment. - `FT` – Foreign Trade Zone - A designated area where goods can be stored without being subject to customs duties. - `KE` – Port of Embarkation - The port where the cargo is loaded onto the vessel. - `KL` – Port of Loading - Another term for the port where the cargo is loaded. - `LO` – Local Office. - `OR` – Origin (Shipping Point). - `PA` – Port of Arrival - The port where the cargo arrives in the destination country. - `PB` –Port of Discharge - The port where the cargo is unloaded from the vessel. - `PD` – Place of Delivery. - `PE` – Port of Entry - The port where customs clearance is performed. - `PL` – Plant - Facility where goods are manufactured or processed. - `TL` – Terminal Cargo Location - The specific terminal within a port where the cargo is handled. - `TM` – Terminal - Specific terminal facility within a port. - `WF` – Wharf - The dock or quay where the vessel is moored. - `ZZ` – Mutually Defined - Custom qualifier defined by trading partners. CI B413 0…1 1/1 Equipment check digit number. 1 N9 0…30 – Reference segment for mapping to the transaction references. – N901 1…1 2/3 **Required.** Reference identification qualifier for the contract class. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values ](#)- `FN` – Freight forwarder reference identifier - `ZZ` – Mutually defined number - `OC` – Ocean container number - `8X` – Transaction Type - `BN` – Booking number - `SE` – Serial number - `EQ` – Equipment number - `SCA` – SCAC code - `P8` – Pickup reference number - `1J` – Facility ID Number - `4F` – Carrier-assigned Shipper Number - `CT` – Contract number - `BM` – Bill of Lading Number - `PO` – Purchase Order Number - `VN` – Vendor order number - `IV` – Seller invoice number - `MB` – Master BOL - `SN` – Seal number - `AG` – Agent shipment number - `CN` – Carrier reference number - `CG` – Conginees order number - `PR` – Price quote number CT N902 0…1 1/80 **Required.** Reference identifier value. 123456 Q2 0…1 – Vessel details. – Q201 0…1 1/8 Vessel unique identifier. 9399193 Q202 0…1 2/3 Vessel registered country code. UK Q203 0…1 8/8 Required Pier date / loading cut off date. 20250803 Q204 0…1 8/8 Vessel departure date. 20250804 Q205 0…1 8/8 Shipment unloaded date. 20250902 Q206 0…1 1/7 Lading quantity. 12 Q207 0…1 1/10 Weight for qualifier. If either Q2-07, Q2-08 or Q2-16 are present, then the others are required. 10 Q208 0…1 1/2 Total cargo weight for bill of lading events or total cargo weight for container (if available). [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values:](#)- `A5` - Average weight - `A4` - Average weight per load - `B` - Billed weight - `CE` - Certified weight of cargo - `A` - Consolidated weight - `F` - Deficit weight - `E` - Estimated net weight - `O` - Excess weight over maximum - `FR` - Freight weight - `G` - Gross weight - `L` - Legal weight - `LC` - Maximum lading capacity - `M` - Minimum weight for rate - `N` - Actual net weight - `ND` - Non-chargeable dunnage - `V` - Non transit weight - transit bills only - `PA` - Pallet weight - `U` - Weight per unit - `A3` - Shipper's weight - `SK` - Skid weight - `T` - Tare weight - `W` - Transit weight - transit bills only - `SO` - Storage in transit out FR Q209 0…1 2/30 Voyage identifier on which the cargo travels. 073E Q210 0…1 2/3 Transaction reference type for X12 segments REF and N9 and EDIFACT RFF for general reference data that is not a transaction document identifier. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values ](#)- `FN` – Freight forwarder reference identifier - `ZZ` – Mutually defined number - `OC` – Ocean container number - `8X` – Transaction Type - `BN` – Booking number - `SE` – Serial number - `EQ` – Equipment number - `SCA` – SCAC code - `P8` – Pickup reference number - `1J` – Facility ID Number - `4F` – Carrier-assigned Shipper Number - `CT` – Contract number - `BM` – Bill of Lading Number - `PO` – Purchase Order Number - `VN` – Vendor order number - `IV` – Seller invoice number - `MB` – Master BOL - `SN` – Seal number - `AG` – Agent shipment number - `CN` – Carrier reference number - `CG` – Conginees order number - `PR` – Price quote number SCA Q211 0…1 1/80 Reference identification. If Q2-10 is present, then Q2-11 is required. SCA2324 Q212 0…1 1/1 Vessel code qualifier, organization provides vessel unique identifier. Valid values: - `B` – U.S. Bureau of Census - `C` – Ship's Radio Call Signal - `L` – Lloyd's Register of Shipping - `Z` – Mutually defined number B Q213 0…1 2/28 Vessel name. CMA CGM LIBRA Q214 0…1 1/8 vessel volume value. If either Q2-14 or Q2-15 is present, then the other is required. 10 Q215 0…1 1/1 Type of volume recorded. Valid values: - `B` – Volume of barge - `T` – Volume of container - `C` – Cubic centimeters - `M` – Cubic decimeters - `E` – Cubic feet - `N` – Cubic inches - `X` – Cubic meters - `G` – Gallons - `V` – Liter - `L` – Total volume of load B Q216 0…1 1/1 Weight unit of measure. Valid values: - `E` – Metric ton - `G` – Grams - `K` – Kilograms - `L` – Pounds - `M` – Measurement ton - `O` – Ounces - `S` – Short ton - `T` – Long ton E SG 0…15 – Shipment wise status details. – SG01 0…1 1/2 Shipment status code [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values ](#)- `1` – Shipment was delivered with missing piece or pieces - `2` – Returned to carrier terminal - `3` – Returned to shipper - `4` – Shipment delivered with damage noted by carrier or consignee - `A` – Shipment has arrived at the location specified - `AA` – Pick-up appointment date and time - `AC` – Awaiting clearance - `AD` – Delivery appointment date and time - `AE` – Loaded on vessel - `AF` – Carrier departed pickup location with shipment - `AG` – Estimated delivery - `AH` – Attempted delivery - `AI` – Shipment has been reconsigned - `AJ` – Tendered for delivery - `AL` – Loaded on rail - `AM` – Loaded on truck - `AN` – Delivered to air carrier - `AO` – Loaded on barge - `AP` – Loaded on feeder vessel - `AR` – Rail arrival at destination intermodal ramp - `AU` – Shipment available for pick-up - `AV` – Available for delivery - `AW` – Awaiting for export - `B` – Shipment was inoperative, equipment failed - `BC` – Storage in transit - `BR` – Bill of lading released - `C` – Estimated to depart terminal location - `CD` – Received at origin - `CH` – Customs hold - `CR` – Carrier release - `CS` – Container sealed - `CT` – Customs released - `CU` – Carrier and customs released - `D` – Shipment was delivered to the consignee or receiver - `DO` – Destination stop-off - `E` – Estimated to arrive (en route) - `EE` – Empty equipment dispatched - `HR` – Carrier un-release (hold released) - `I` – In-gate - `IB` – U.S. Customs, in-bond movement authorized - `J` – Delivered to connecting line - `K` – Arrived at customs - `K3` – Complete customs paperwork has been provided - `L` – Loading - `N` – No paperwork received with shipment or equipment - `O` – Paperwork received – did not receive shipment or equipment - `OA` – Out gate - `OP` – All paperwork has been provided to consignee - `P` – Departed terminal location, shipment has left the carrier's terminal or other control point - `PA` – U.S. Customs hold, intensive examination - `PB` – U.S. Customs hold, insufficient paperwork - `PC` – U.S. Customs hold, discrepancy paperwork - `PD` – U.S. Customs hold, discrepancy piece count - `PE` – U.S. Customs and Border Protection (CBP) hold, hold by Coast Guard - `PF` – U.S. Customs and Border Protection (CBP) hold, hold by F.B.I. - `PI` – U.S. Customs and Border Protection (CBP) hold, hold by Food and Drug - `PK` – U.S. Customs and Border Protection (CBP) hold, hold by Drug Enforcement - `NH` – Awaiting for hazardous material document - `NR` – Awaiting for shipment information - `NS` – No seal on load - `RB` – Delivery appointment requested - `RD` – Return container - `RL` – Rail departure from origin intermodal ramp - `SD` – Shipment delayed - `T` – At terminal, intra-terminal movement - `U` – Unloading - `UC` – Shipment container unloaded from chassis - `UO` – Unloaded from barge - `UR` – Shipment conveyance unloaded from rail car - `UV` – Unloaded from vessel - `VA` – Vessel scheduled to arrive or has arrived - `VD` – Vessel scheduled to depart or has departed - `W` – Released by customer - `X1` – Arrived at delivery location - `X2` – Estimated date/time of arrival at consignee's location - `X3` – Arrived at pickup location - `X4` – Arrived at terminal location - `X5` – Arrived at delivery location delivery dock - `X6` – Enroute to delivery location - `X7` – Enroute to pickup location - `X8` – Arrived at pickup location loading dock - `X9` – Arrived at carrier's warehouse - `XB` – Shipment acknowledged - `ZZ` – Custom status code AC SG02 0…1 3/3 Reason indicating why a shipment status code was transmitted. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values ](#)- `029` –Transfer of ownership is pending. - `049` – The merchandise was damaged or destroyed. - `052` – Import container delay - `A01` – An unsuccessful attempt has been made to deliver the shipment - `A03` – The address for the shipment is incorrect. - `A04` – Indirect Delivery - `A05` – The transportation carrier cannot find the customer location - `A06` – The address for the shipment is incorrect or an additional address is required before the delivery can be completed. - `A07` – Shipment refused by consignee or delivery party. - `A09` – Goods damaged delivery has been completed - `A10` – Goods damaged delivery has not been completed - `A11` – The shipment could not be delivered because the business was closed. - `A12` – Delay caused by carrier sorting the shipment incorrectly. - `A13` – Other undefined reason - `A14` – Returned to shipper - `A15` – Business on strike. The action was frustrated by an industrial dispute. - `A17` – Delay in delivery due to a customer or consignee's request. - `A18` – Missort - `A19` – Restricted articles are incompatible - `A20` – Restricted articles are unacceptable - `A24` – Delay in the shipment because of an accident. - `A26` – An unspecified delay caused by consignee - `A27` – The driver returned the shipment to the terminal - `A29` – Hold changed to delivery package - `A30` – A mechanical breakdown in the means of transport or equipment that were moving the goods. - `A31` – Arrived in station after courier dispatch - `A33` – Delivery delay caused by a non-specified carrier related reason. - `A34` – Package shipped from overgoods - `A36` – Holding in overgoods - `A37` – Damaged rewrapped In hub - `A39` – The customer previous to this stop caused a delay - `A40` – Unspecified delay caused by shipper. - `A42` – Delivery party facilities closed for holiday. - `A43` – Shipment is delayed by severe weather or natural disasters. - `A45` – Delivery not completed - `A46` – Recipient Unavailable -- Delivery Delayed. No information available concerning the responsible at the delivery address. - `A49` – Out of Delivery Area (ODA) cartage agent - `A50` – Improper international paperwork - `A55` – The shipment is on hold or has not been refused because customs and/or documentation issues. - `A59` – Further instructions are required. Hold at location. - `A65` – Customs release - `A95` – Past cutoff time. Delivery of the goods/consignments/equipment has been scheduled past or later than the cut-off time. - `A96` – Insufficient pickup time - `B01` – Anticipated delay caused by contractor - `B08` – Shipment is on hold pending contract unloading facility or equipment - `B14` – Shipment is being held because of missing documents. Complete and correct documentation is required. - `B15` – Shipment is being held pending clearance at a border point. - `D01` – The shipment has been delayed for delivery because of a carrier dispatch error. - `D50` – Further action on the delivery is delayed or postponed. - `P02` – Relevant authorities have ordered the goods/consisgnments/equipment be held for inspection. - `T07` – Insufficient delivery time at the delivery location prevented the carrier from completing delivery of the goods. - `THT` – A consignment or goods have been stolen. - `W15` – Wrong equipment A03 SG03 0…1 2/3 Code indicating the effective action taken on bill of lading, X12 pass through. – SG04 0…1 8/8 Date of reported status of shipment in YYYYMMDD format. 20070609 SG05 0…1 '4/8 Time of reported status of shipment in hhmmss format. 131204 SG06 0…1 2/2 Time zone. CT R4 1…20 – **Required.** Port or terminal details. – R401 1…1 1/1 **Required.** Port or Terminal function codes. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values: ](#)- `1` – Final Port of Discharge (Operational) - Last port at which cargo is unloaded from vessel. - `5` – Activity Location (Operational) - Place at which the activity being reported is occurring. - `B` – Reconsolidation Point (Operational). - `C` – De-Consolidation Point (Operational). - `D` – Port of Discharge (Operational) - Port at which cargo is unloaded from vessel. - `E` – Place of Delivery (Contractual) - Place at which cargo leaves its care and custody of carrier. - `I` – Interim Point (Operational) - Place at which cargo is transferred from one inland means of transport to another. - `L` – Port of Loading (Operational) - Port at which cargo is loaded on vessel. - `R` – Place of Receipt (Contractual) - Place at which cargo enters the care and custody of carrier. - `T` – Transshipment Port (Contractual) - Place at which cargo is transferred to another carrier. - `M` – Destination (Operational) - Place at which carrier actually turns cargo to consignee or his agent. - `S` – Return Pool (Operational) - Place at which equipment is returned. - `Y` – Relay Port (Operational). - `N` – Final Destination (Operational) - Consignee's facility at which shipment ends its movement at cargo's expense. - `G` – Port of Entry (Operational) - Place at which cargo actually enters a country where the cargo is not part of its commerce. - `O` – Origin (Operational) - Shipper's facility at which shipment begins its movement at cargo's expense. - `H` – Port of exit. O R402 0…1 1/2 Port Location qualifier, indicating type of location. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values ](#)- `18` – Marker identifier location. - `CI` – City code. - `D` – Domestic U.S. ports (Schedule D). - `L` – Local address. - `K` – Foreign ports (Schedule K), and international. - `UN` – United Nations Location Code. - `OV` – On Vessel (Free On Board \[FOB\] point) - `CY` – Container Yard - Area designated for container storage. - `DC` – Distribution Center Number. - `DE` – Destination - Shipping. - `DO` – District Office. - `FR` – U.S. Customs Facilities Information and Resource Management Systems (FIRMS) — Identifies U.S. Customs facilities related to the shipment. - `FT` – Foreign Trade Zone - A designated area where goods can be stored without being subject to customs duties. - `KE` – Port of Embarkation - The port where the cargo is loaded onto the vessel. - `KL` – Port of Loading - Another term for the port where the cargo is loaded. - `LO` – Local Office. - `OR` – Origin (Shipping Point). - `PA` – Port of Arrival - The port where the cargo arrives in the destination country. - `PB` –Port of Discharge - The port where the cargo is unloaded from the vessel. - `PD` – Place of Delivery. - `PE` – Port of Entry - The port where customs clearance is performed. - `PL` – Plant - Facility where goods are manufactured or processed. - `TL` – Terminal Cargo Location - The specific terminal within a port where the cargo is handled. - `TM` – Terminal - Specific terminal facility within a port. - `WF` – Wharf - The dock or quay where the vessel is moored. - `ZZ` – Mutually Defined - Custom qualifier defined by trading partners. CI R403 0…1 1/30 Port Location Identifier. If either R4-02 or R4-03 is present, then the other is required. USLGB R404 0…1 2/24 Port name. USPort R405 0…1 2/3 Port located country code. US R406 0…1 2/20 Terminal name. Terminal R408 0…1 2/2 State or Province code. TX DTM 0…15 – Dates relevant to shipments events at port. – DTM01 1…1 3/3 **Required.** Date type qualifier for shipment events in R4-DTM loop. Valid values: - `139` – Estimated - `140` – Actual date - `369` – Estimated Departure Date - `370` – Actual Departure date - `371`– Estimated Arrival date - `372` – Actual arrival date - `058` – Customs Clearance date - `161`– Loaded on vessel date - `813` – Customs entry date - `510` – Date packed 139 DTM02 0…1 8/8 **Required.** Contract date in date format YYYYMMDD. 20240628 DTM03 0…1 4/8 Contract time in time format HHMMSS. 123422 DTM04 0…1 2/2 Time zone code. CT V9 0…10 – Shipment event details. – V901 1…1 3/3 **Required.** Shipment event code. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values ](#)- `ALV` – Cargo has been loaded onto the vessel. - `ARR` – Shipment has arrived at the final destination. - `APU` – Expected date and time for pickup. - `ARD` – Actual date and time of arrival at the final destination. - `ETA` – Estimated time of arrival at the destination. - `EAD` – Estimated date of arrival at the destination. - `ERD` – Estimated date of arrival at the final destination. - `VAR` – Vessel has arrived at port. - `VDP` – Vessel has departed from port. - `UFV` – Cargo has been unloaded from the vessel. - `CTD` – Customs paperwork has been submitted. - `CLR` – Shipment has cleared customs. - `ICD` – Container dispatched from an inland location. - `RCV` – Cargo has been received at the port or terminal. - `GIT` – Shipment is currently en route to destination. - `HLD` – Shipment is currently on hold. - `DOC` – All shipment documentation is completed. - `CUS` – Shipment is currently at customs. - `ARI` – Shipment arrived at intermediate location - `ZZZ` – Custom event code APU V902 0…1 1/25 Shipment Event descriptive information. Vessel arrived V903 0…1 8/8 Shipment event time stampin YYYYMMDD format. 20070609 V904 0…1 '4/8 Time of reported status of shipment in hhmmss format. 131204 V905 0…1 2/30 Event occurred city name. Texas V906 0…1 2/2 Event occurred state or province code. TX V907 0…1 2/3 Event occurred country code. UK V908 0…1 3/3 Reason indicating why a shipment status code was transmitted. [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Valid values ](#)- `029` –Transfer of ownership is pending. - `049` – The merchandise was damaged or destroyed. - `052` – Import container delay - `A01` – An unsuccessful attempt has been made to deliver the shipment - `A03` – The address for the shipment is incorrect. - `A04` – Indirect Delivery - `A05` – The transportation carrier cannot find the customer location - `A06` – The address for the shipment is incorrect or an additional address is required before the delivery can be completed. - `A07` – Shipment refused by consignee or delivery party. - `A09` – Goods damaged delivery has been completed - `A10` – Goods damaged delivery has not been completed - `A11` – The shipment could not be delivered because the business was closed. - `A12` – Delay caused by carrier sorting the shipment incorrectly. - `A13` – Other undefined reason - `A14` – Returned to shipper - `A15` – Business on strike. The action was frustrated by an industrial dispute. - `A17` – Delay in delivery due to a customer or consignee's request. - `A18` – Missort - `A19` – Restricted articles are incompatible - `A20` – Restricted articles are unacceptable - `A24` – Delay in the shipment because of an accident. - `A26` – An unspecified delay caused by consignee - `A27` – The driver returned the shipment to the terminal - `A29` – Hold changed to delivery package - `A30` – A mechanical breakdown in the means of transport or equipment that were moving the goods. - `A31` – Arrived in station after courier dispatch - `A33` – Delivery delay caused by a non-specified carrier related reason. - `A34` – Package shipped from overgoods - `A36` – Holding in overgoods - `A37` – Damaged rewrapped In hub - `A39` – The customer previous to this stop caused a delay - `A40` – Unspecified delay caused by shipper. - `A42` – Delivery party facilities closed for holiday. - `A43` – Shipment is delayed by severe weather or natural disasters. - `A45` – Delivery not completed - `A46` – Recipient Unavailable -- Delivery Delayed. No information available concerning the responsible at the delivery address. - `A49` – Out of Delivery Area (ODA) cartage agent - `A50` – Improper international paperwork - `A55` – The shipment is on hold or has not been refused because customs and/or documentation issues. - `A59` – Further instructions are required. Hold at location. - `A65` – Customs release - `A95` – Past cutoff time. Delivery of the goods/consignments/equipment has been scheduled past or later than the cut-off time. - `A96` – Insufficient pickup time - `B01` – Anticipated delay caused by contractor - `B08` – Shipment is on hold pending contract unloading facility or equipment - `B14` – Shipment is being held because of missing documents. Complete and correct documentation is required. - `B15` – Shipment is being held pending clearance at a border point. - `D01` – The shipment has been delayed for delivery because of a carrier dispatch error. - `D50` – Further action on the delivery is delayed or postponed. - `P02` – Relevant authorities have ordered the goods/consisgnments/equipment be held for inspection. - `T07` – Insufficient delivery time at the delivery location prevented the carrier from completing delivery of the goods. - `THT` – A consignment or goods have been stolen. - `W15` – Wrong equipment A03 V9013 0…1 2/2 Time zone code. CT SE 1…1 – **Required.** ST … SE transaction set trailer envelope. Child of GS group. Only one ST transaction expected. – SE01 1…1 1/10 **Required.** Total count of segments in ST … SE transaction set including ST and SE segments. 10 SE02 1…1 4/9 **Required.** Transaction set control number. 0001 GE 1…1 – **Required.** GS … GE functional group trailer envelope. Child of ISA interchange. Only one GS group expected. – GE01 1…1 1/6 **Required.** Number of transaction sets in functional group. 5 GE02 1…1 1/9 **Required.** Functional group control number. 619827 IEA 1…1 – **Required.** ISA … IEA interchange control trailer envelope. Only one interchange expected per transmission. – IEA01 1…1 1/5 **Required.** Number of functional groups in interchange. 1 IEA02 1…1 9/9 **Required.** Interchange control number. 0000000000619827 [![Closed](/sites/default/files/tech_comms/mpl/Skins/Default/Stylesheets/Images/transparent.gif)Example](#)```xml ISA*00* *00* *20*Sender *ZZ*Receiver *240129*1250*^*00501*11 *0*T*: GS*s1*s16*s17*20240129*1050*12345*X*005010 ST*315*485400001 B4**1*AE*20200123*210622*INMUN*CAIU*608277*L*2210*INMUN*UN*5 N9*BN*100050007510 N9*BM*EGLV100050007510 N9*EQ*CAIU6082775 N9*SCA*CA17875452 Q2*9290426*CY*20250701*20200123*20200115*1*22060**890E*9X*EGLV*L*CSL SANTA MARIA*25**K SG*XB*A18*122*20250325*23552015*ET R4*5*18*INMUN*MUNDRA*IN DTM*140*20200117*0330*LT R4*R*CI*INMUN*MUNDRA*IN DTM*140*20200118*0331*LT R4*L*D*INMUN*MUNDRA*IN DTM*140*20200123*1648*LT R4*D*L*CNTXG*XINGANG*CN DTM*140*20200214*0700*LT R4*M*K*CNTXG*XINGANG*CN DTM*140*20200214*0700*LT V9*ALV*3455*20250710*11301122*City*MA*US*W15*****CT SE*16*485400001 GE*29*30 IEA*11*321111112 ``` ![](/sites/default/files/tech_comms/mpl/Content/Resources/Images/global_images/note_tip_24x24.png) Review TraceLink's [API: Terms of Use](https://www.tracelink.com/legal-and-trust/api-terms-of-use) #### Table of contents ##### Related Content [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-idoc) ##### Forecast plan (IDoc) Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with upstream supply chain Partners without giving these Partners access to their serialization system of record. [View More](/resources/tracelink-university/forecast-plan-idoc) [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-x12) ##### Forecast plan (X12) Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with upstream supply chain Partners without giving these Partners access to their serialization system of record. [View More](/resources/tracelink-university/forecast-plan-x12) [ ![Related content](https://www.tracelink.com/sites/default/files/2024-09/cloud.svg) ](/resources/tracelink-university/forecast-plan-response-idoc) ##### Forecast plan response (IDoc) Forecasting APIs allow companies to exchange data about anticipated product demand and supply availability with downstream supply chain Partners without giving these Partners access to their serialization system of record. [View More](/resources/tracelink-university/forecast-plan-response-idoc)