Roll-On/Roll-Off Quality Control (RoRo QC) Visibility

Project44's Roll-On/Roll-Off (RoRo) Quality Control Visibility solution is an add-on solution to the conventional RoRo visibility and provides shippers with real-time visibility into quality control events for vehicles before loading onto and after unloading from a RoRo vessel. This solution is designed to enhance the management and recall of vehicle shipments by surfacing critical quality control data, enabling proactive measures to address potential issues.

Data Providers

Project44 integrates with various quality control service providers to gather data on vehicle inspections, damage reports, and other quality control events.
The data is collected through APIs, EDI, and other data exchange methods, ensuring real-time updates on the status of vehicles before loading and after unloading.

Get Tracking Updates

Get tracking information about a shipment with RoRo Quality Control data. A RoRo shipment must be created and added to project44's network before we can return tracking information, and the RoRo QC providers must already be integrated and configured in your project44 account. To create a RoRo shipment, please Create a Shipment.

project44 offers four targeted endpoints for returning shipment tracking information, as mentioned in Tracking Updates guide. The same four endpoints are used for RoRo QC Visibility, allowing you to fetch the specific information.

Requirements

Have the following information available:

Master Shipment ID (this is the id returned in the 200 OK response during shipment creation).

Workflow

Complete the following steps.

Prepare a GET request to /api/v4/shipments/{shipmentId}/tracking/history using the Master Shipment ID. For example, GET /api/v4/shipments/93294f58-f87a-48e0-9f68-7d3f6e0aaa2f/tracking/history.
Send the request.

Expected System Response

You have successfully submitted the request when you receive a 200 OK response. Here is a sample of the response schema:

JSON

{
  "shipment": {
    "id": "string",
    "identifiers": [
      {
        "type": "BILL_OF_LADING",
        "value": "string"
      }
    ],
    "routeInfo": {
      "stops": [
        {
          "id": "string",
          "type": "UNKNOWN",
          "location": {
            "id": "string",
            "name": "string",
            "identifiers": [
              {
                "type": "PORT_UN_LOCODE",
                "value": "string"
              }
            ],
            "address": {
              "postalCode": "string",
              "addressLines": [
                "string"
              ],
              "city": "string",
              "state": "string",
              "country": "US"
            },
            "coordinates": {
              "latitude": 0,
              "longitude": 0
            },
            "timeZone": "string"
          }
        }
      ],
      "routeSegments": [
        {
          "id": "string",
          "fromStopId": "string",
          "toStopId": "string",
          "transportationMode": "AIR",
          "identifiers": [
            {
              "type": "VESSEL_NAME",
              "value": "string"
            }
          ]
        }
      ]
    },
    "attributes": [
      {
        "name": "string",
        "value": "string",
        "values": [
          "string"
        ]
      }
    ],
    "relatedShipments": [
      {
        "id": "string",
        "identifiers": [
          {
            "type": "VEHICLE_IDENTIFICATION_NUMBER",
            "value": "string"
          }
        ],
        "attributes": [
          {
            "name": "string",
            "value": "string",
            "values": [
              "string"
            ]
          }
        ],
        "shipmentShareLink": "string",
        "createdDateTime": "string",
        "lastModifiedDateTime": "string"
      }
    ],
    "shipmentShareLink": "string",
    "createdDateTime": "string",
    "lastModifiedDateTime": "string"
  },
  "states": [
    {
      "type": "UNKNOWN",
      "startDateTime": "string",
      "endDateTime": "string",
      "stopId": "string",
      "routeSegmentId": "string"
    }
  ],
  "events": [
    {
      "dateTime": "string",
      "receivedDateTime": "string",
      "type": "UNKNOWN",
      "description": "string",
      "stopId": "string",
      "routeSegmentId": "string",
      "estimateDateTime": "string",
      "estimateLastCalculatedDateTime": "string",
      "plannedDateTime": "string",
      "plannedEndDateTime": "string"
    }
  ],
  "positions": [
    {
      "dateTime": "string",
      "receivedDateTime": "string",
      "routeSegmentId": "string",
      "latitude": 0,
      "longitude": 0
    }
  ]
}

Expected Milestones

With RoRo QC Visibility, you can expect the events and codes mentioned in the $.events[].details.qualityControl.code section of the Ocean Shipment Schema.

Expected Identifiers

POL_QUALITY_CONTROL_PROVIDER and POD_QUALITY_CONTROL_PROVIDER identifiers are expected in the response. These identifiers indicate the quality control provider for the Port of Loading (POL) and Port of Discharge (POD) respectively. More information about these identifiers can be found in the $.shipment.identifiers section of the Ocean Shipment Schema.