Appendix

Ocean Carrier Identifiers

Here, you can find SCAC information for Ocean carriers connected to project44's network.

Ocean Event Types

Ocean Shipment Event Types

Below are the available Event Types for Ocean shipments and the descriptions for each Event Type.

Ocean Container Event Types

Below are the available Event Types for Ocean containers and the descriptions for each Event Type.

WARNING Event Type

The WARNING event type is returned when the shipment has been successfully created with project44 but there is an issue preventing tracking. An explanation of this issue is included in the description field for the event. Potential values for the description field include:

• Carrier out of network
• Duplicate subscription
• Invalid identifier
• Tracking initialization failed

Sample JSON response code with the WARNING event type:

{
   "shipment":{
      "id":"1a060d95-b135-4cb1-9146-2a805a2ebf50",
      "identifiers":[
         {
            "type":"CARRIER_SCAC",
            "value":"MWHL"
         },
         {
            "type":"BILL_OF_LADING",
            "value":"WHLC031C588296"
         }
      ],
      "shipmentShareLink":"https://na12.voc.project44.com/portal/v2/public/ma/tracking-details?shipmentShareToken=fcfb2857-5210-4cc7-912d-e0156e189c3e",
      "createdDateTime":"2023-01-17T17:05:46+0000"
   },
   "events":[
      {
         "dateTime":"2023-01-17T17:05:47+0000",
         "receivedDateTime":"2023-01-17T17:05:47+0000",
         "type":"WARNING",
         "description":"Ocean carrier out of network"
      }
   ]
}

Ocean Shipment State Types

Below are the accepted State Type values for Ocean shipments and the Event Types that trigger a State Type start or stop.

Ocean Shipment Stop Types

Route Segment Identifiers

This table describes the route segment identifiers for Ocean shipments.

Error Response Codes

This Appendix describes the schema and fields of the standard project44 API Error Response.

Below, find the API Error Response Schema:

400 Invalid Request

{
  "httpStatusCode": 400,
  "httpMessage": "Invalid request",
  "errorMessage": "string",
  "errors": [
    {
      "severity": "ERROR",
      "message": "string",
      "diagnostic": "string",
      "source": "SYSTEM"
    }
  ],
  "supportReferenceId": "string"
}

401 Invalid or missing credentials

{
  "httpStatusCode": 401,
  "httpMessage": "Invalid or missing credentials",
  "errorMessage": "string",
  "errors": [
    {
      "severity": "ERROR",
      "message": "string",
      "diagnostic": "string",
      "source": "SYSTEM"
    }
  ],
  "supportReferenceId": "string"
}

403 User not authorized to perform this operation

{
  "httpStatusCode": 403,
  "httpMessage": "User not authorized to perform this operation",
  "errorMessage": "string",
  "errors": [
    {
      "severity": "ERROR",
      "message": "string",
      "diagnostic": "string",
      "source": "SYSTEM"
    }
  ],
  "supportReferenceId": "string"
}

404 Not Found

{
  "httpStatusCode": 404,
  "httpMessage": "Not Found",
  "errorMessage": "string",
  "errors": [
    {
      "severity": "ERROR",
      "message": "string",
      "diagnostic": "string",
      "source": "SYSTEM"
    }
  ],
  "supportReferenceId": "string"
}

The table below describes each field of the API Error Response:

Ocean LCL Visibility Supported Carrier Scacs

This table describes the supported carrier SCACs for Ocean LCL Visibility.

Ocean LCL Visibility Shipment Event Types

Data Provider: Vanguard Logistics

This table describes the events which Project44 obtains from the data provider.

Ocean LCL Visibility Shipment Stop Types

Data Provider: Vanguard Logistics

This table describes the stops which Project44 obtains from the data provider.

Ocean LCL Visibility Shipment Other Relevant Information

Data Provider: Vanguard Logistics

Project44 also provides other information as well - for example, vessel name, voyage number etc. This information can be found in the shipment.routeInfo.routeSegments.{route-segment-id-of-POL->POD} object of Get Full Tracking History response. This table describes the other relevant data points which Project44 obtains from the data provider.