Create an Ocean Shipment with Detention and Demurrage Optimization
Detention and Demurrage Optimization provides enhanced visibility into import terminals with cost tracking capabilities. This optimization can be applied to any ocean shipment type, including:
- Ocean Port to Port shipments
- RoRo (Roll-on/Roll-off) shipments
- Extended Ocean shipments
Shipment Creation Process
To initiate tracking with Detention and Demurrage Optimization, follow the standard ocean shipment creation process based on your shipment type:
- For Port to Port Shipments: Follow Ocean Port to Port shipment creation
- For RoRo Shipments: Follow RoRo shipment creation
- For Extended Ocean: Follow Extended Ocean creation workflows
The Detention and Demurrage calculation will be automatically applied when applicable terminals are reached.
Prerequisites
Ensure you have the following:
- One shipment identifier:
BILL_OF_LADINGorBOOKING_NUMBER. - One valid
CARRIER_SCAC. View SCACs for in-network Ocean carriers.
Workflow
Complete these steps:
- Send a
POSTrequest to /api/v4/shipments/tracking. - Include the identifiers in the request payload:
{ "identifiers": [ { "type": "BILL_OF_LADING", "value": "MEDUAB12345" }, { "type": "CARRIER_SCAC", "value": "MSCU" } ] }
- Submit the request.
Successful Response
A successful response will return a 200 OK status with the standard ocean shipment structure. Enhanced D&D tracking data will appear in subsequent tracking updates when containers reach terminals with data connectivity.
Errors
Error handling follows the same pattern as standard ocean shipments:
400 Invalid request401 Invalid or missing credentials403 User not authorized to perform this operation
See Error Response Codes for more information.