Create an Ocean RoRo Shipment

Use the Project44 API to register an ocean Roll-On/Roll-Off (RoRo) shipment in the network and begin receiving tracking data. RoRo shipments are created through Electronic Data Interchange (EDI). Project44 maintains robust EDI connectivity with leading ocean carriers, enabling shipment creation and milestone tracking via standardized formats such as EDIFACT and ANSI X12. To set up EDI integration with project44, please contact our Support Team. This guide walks you through creating a shipment with or without additional metadata such as attributes or Vehicle Identification Number (VIN) OR Serial Number. You can then view and subscribe to the tracking data via APIs, Movement UI or Webhooks.

After a shipment is created, Project44 validates the shipment and initiates tracking as part of an asynchronous process. If the discovered ocean carrier is within project44’s network, the system automatically subscribes to the carrier using Ocean Carrier Tracking Capability.

Basic Shipment Creation

To initiate tracking of an ocean roro shipment in Project44's network, you must provide at least one shipment identifier along with exactly one Carrier SCAC.

Prerequisites

Ensure you have the following:

One shipment identifier: BILL_OF_LADING or BOOKING_NUMBER.
One valid CARRIER_SCAC. View SCACs for in-network Ocean carriers.

BILL_OF_LADING or BOOKING_NUMBER is a unique identifier given to you by the Ocean carrier. It often contains multiple VINs (each with their own VIN) allowing you to track multiple VIN with a single identifier.

Workflow

Complete these steps:

Send a POST request to /api/v4/shipments/tracking.
Include the identifiers in the request payload:

{
  "identifiers": [
    {
      "type": "BILL_OF_LADING",
      "value": "MEDUAB12345"
    },
    {
      "type": "CARRIER_SCAC",
      "value": "MSCU"
    }
  ]
}

This only shows the minimum required request schema. For the full request schema and descriptions for all fields and objects, please see our reference documentation.

Submit the request.

Successful Response

A successful response will return a 200 OK status with the following structure:

{
  "id": "93294f58-f87a-48e0-9f68-7d3f6e0aaa2f",
  "identifiers": [
    {
      "type": "BILL_OF_LADING",
      "value": "MEDUAB12345"
    },
    {
      "type": "CARRIER_SCAC",
      "value": "MSCU"
    }
  ]
}

The response includes the same identifiers provided in the request—such as BILL_OF_LADING, BOOKING_NUMBER, along with the CARRIER_SCAC. It also returns a unique shipment identifier (id) and any associated VINs and their corresponding IDs. Once the shipment is registered in project44’s system, related shipments are automatically identified. These will appear in the relatedShipments array when you retrieve shipment details via a GET request.

ℹ️ Note: This is a sample response. Fields with null values are omitted. For a complete list of fields and possible values, refer to the reference documentation.

Save the id. You’ll need it to retrieve tracking updates for this shipment.

Create RoRo Shipment with Attributes

Please refer to the guide on Managing Shipment Attributes for more details.