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.
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
-
| 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.
| 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.
| 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.
| ^ | ||||
| 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 | ||||
| ISA15 | 1…1 | 1/1 | Required. Indicates whether the interchange is for production, test, or information purposes. Valid values:
| 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:
| 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.
| 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.
| 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.
| 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.
| 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).
| 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.
| 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 | ||||
| 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 | ||||
| Q216 | 0…1 | 1/1 | Weight unit of measure. Valid values:
| E | ||||
| SG | 0…15 | – | Shipment wise status details. | – | ||||
| SG01 | 0…1 | 1/2 | Shipment status code
| AC | ||||
| SG02 | 0…1 | 3/3 | Reason indicating why a shipment status code was transmitted.
| 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.
| O | ||||
| R402 | 0…1 | 1/2 | Port Location qualifier, indicating type of location.
| 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 | ||||
| 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.
| 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.
| 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 | ||||
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
Review TraceLink's API: Terms of Use