Ocean LCL Visibility
Ocean LCL Visibility is a service that provides real-time tracking and status updates for Less than Container Load (LCL) shipments. It allows shippers to monitor the movement of their cargo throughout the supply chain, ensuring transparency and efficiency.
Overview of Workflow
The workflows to create, get tracking information for, update, and delete an Ocean LCL shipment are the same as for any other Ocean shipment. Nuances specific to Ocean LCL Visibility are called out in the sections below.
Create a Shipment
Follow the steps to Create an Ocean Shipment for tracking.
Requirements
- Booking Number or Bill of Lading
- Supported Carrier SCAC.
Example Request
{ "identifiers": [ { "type": "BOOKING_NUMBER", "value": "string" }, { "type": "CARRIER_SCAC", "value": "string" } ] }
Fields and Objects
Please refer to our $.shipment.identifiers schema for information on the identifiers
object.
See Ocean LCL Carriers in the Appendix for a complete list of supported carrier scacs. The section describes supported carrier scacs according to the data provider.
Error
If there was a problem with your request, you will receive one of the following error codes
400 Invalid request
401 Invalid or missing credentials
403 User not authorized to perform this operation
See Error Response Codes in the Appendix for more information on the meaning of these error codes.
Get Tracking Updates
Follow the steps to Get Ocean Shipment Update.
Requirements
- Create a shipment. A shipment must have been created to retrieve Ocean LCL Visibility data.
- project44-generated Shipment ID (this is the
id
returned in the200 OK
response during shipment creation)
Expected System Response
The following is a sample response that is returned when using the /api/v4/shipments/{shipmentId}/tracking/history endpoint.
{ "shipment": { "id": "973281a1-97c8-4922-a02a-c77fa19053ee", "identifiers": [ { "type": "BILL_OF_LADING", "value": "string" }, { "type": "CARRIER_SCAC", "value": "string" }, { "type": "CARRIER_NAME", "value": "string" } ], "shipmentShareLink": "https://movement.project44.com/share/1234-5678-9012", "createdDateTime": "2023-04-06T17:02:25+0000", "lastModifiedDateTime": "2023-04-08T00:17:20+0000", "routeInfo": { "stops": [ { "id": "string", "type": "ORIGIN", "location": { "name": "string", "identifiers": [ { "type": "string", "value": "string" } ], "address": { "city": "string", "state": "string", "country": "string" }, "coordinates": { "latitude": 0, "longitude": 0 }, "timeZone": "Europe/Brussels" } }, { "id": "string", "type": "PORT_OF_LOADING", "location": { "name": "string", "identifiers": [ { "type": "string", "value": "string" } ], "address": { "city": "string", "state": "string-Natal", "country": "string" }, "coordinates": { "latitude": 0, "longitude": 0 }, "timeZone": "Europe/Brussels" } }, { "id": "string", "type": "PORT_OF_DISCHARGE", "location": { "name": "string", "identifiers": [ { "type": "string", "value": "string" } ], "address": { "city": "string", "state": "string", "country": "string" }, "coordinates": { "latitude": 0, "longitude": 0 }, "timeZone": "Africa/Johannesburg" } }, { "id": "string", "type": "DESTINATION", "location": { "name": "string", "identifiers": [ { "type": "string", "value": "string" } ], "address": { "city": "string", "state": "string-Natal", "country": "string" }, "coordinates": { "latitude": 0, "longitude": 0 }, "timeZone": "Africa/Johannesburg" } } ], "routeSegments": [ { "id": "string", "fromStopId": "string", "toStopId": "string", "transportationMode": "UNKNOWN" }, { "id": "string", "fromStopId": "string", "toStopId": "string", "transportationMode": "OCEAN", "identifiers": [ { "type": "VOYAGE_NUMBER", "value": "string" }, { "type": "VESSEL_NAME", "value": "string" }, { "type": "VESSEL_IMO", "value": "string" }, { "type": "CARRIER_NAME", "value": "string" } ] }, { "id": "string", "fromStopId": "string", "toStopId": "string", "transportationMode": "UNKNOWN" } ] }, "relatedShipments":[] }, "states": [ { "type": "IN_TRANSIT", "startDateTime": "2023-03-09T16:50:00+0000", "endDateTime": "2023-04-06T01:52:00+0000", "stopId": "string", "routeSegmentId": "string" }, { "type": "AT_STOP", "startDateTime": "2023-04-06T01:52:00+0000", "endDateTime": "2023-04-07T22:14:00+0000", "stopId": "string", "routeSegmentId": "stringa" }, { "type": "COMPLETED", "startDateTime": "string" } ], "events": [ { "dateTime": "2023-03-09T16:50:00+0000", "receivedDateTime": "2023-04-07T22:14:00+0000", "type": "INFO", "stopId": "string", "routeSegmentId": "string" }, { "dateTime": "2023-03-09T16:50:00+0000", "receivedDateTime": "2023-04-07T22:14:00+0000", "type": "DEPARTURE_FROM_STOP", "stopId": "string", "routeSegmentId": "string" }, { "dateTime": "2023-04-06T01:52:00+0000", "receivedDateTime": "2023-04-07T22:14:00+0000", "type": "ARRIVAL_AT_STOP", "stopId": "string", "routeSegmentId": "string", "estimateDateTime": "2023-04-06T01:52:00+0000", "estimateLastCalculatedDateTime": "2023-04-08T00:17:21+0000", "plannedDateTime": "2023-04-07T00:30:00+0000" }, { "dateTime": "2023-04-07T00:30:00+0000", "receivedDateTime": "2023-04-07T22:14:00+0000", "type": "DELIVERY", "stopId": "string" }, { "dateTime": "2023-04-07T22:14:00+0000", "receivedDateTime": "2023-04-07T22:14:00+0000", "type": "TRACKING_STOP" } ], "positions": [ { "dateTime": "2023-03-09T17:10:00+0000", "routeSegmentId": "string", "latitude": 0, "longitude": 0 } ] }
Error
If there was a problem with your request, you will receive one of the following error codes
400 Invalid request
401 Invalid or missing credentials
403 User not authorized to perform this operation
See Error Response Codes in the Appendix for more information on the meaning of these error codes.
Expected Event Types
With Ocean LCL Visibility, you can expect events like INFO
, DEPARTURE_FROM_STOP
, ARRIVAL_AT_STOP
, DELIVERY
, STRIP
etc. More information about these events can be found in the $.events section of the Ocean Shipment Schema.
Expected Stop Types
With Ocean LCL Visibility, you can expect stop types like ORIGIN
, PORT_OF_LOADING
, PORT_OF_DISCHARGE
, DESTINATION
, etc. More information about these stop types can be found in the $.shipment.routeInfo.stops section of the Ocean Shipment Schema.
Other Info
Route segments for Ocean LCL shipments may include OCEAN
transportation mode, which indicates that the shipment is being transported by sea. More information about the identifiers
for route segments can be found in the $.shipment.routeInfo.routeSegments[].identifiers[].type section of the Ocean Shipment Schema.