Last updated

Delete a Shipment

Delete an Ocean shipment to stop tracking the shipment in project44's and delete its record in Movement.

Requirements

Have the following information:

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

Workflow

Complete these steps:

  1. Prepare a DELETE request to /api/v4/shipments/{shipmentId}/tracking.
  2. Add the Master Shipment ID.
  3. Submit the request.

Expected Response

The request is successfully submitted and confirmed when a 204 No Content response is received.

Errors

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
  • 404 Not Found
  • 409 Conflict - This error occurs when a BOOKING_NUMBER or BILL_OF_LADING shipment cannot be deleted due to the presence of related container shipments that must be deleted first. The Master Shipment ID of these related containers can be found as id in the relatedShipments array in the GET requests for the BOOKING_NUMBER or BILL_OF_LADING shipment at /api/v4/shipments/{shipmentId}/tracking.
    To resolve this, you need to delete the related container shipments first using the DELETE API, one by one, as outlined in the workflow steps. Once all related container shipments are deleted, you can proceed to delete the BOOKING_NUMBER or BILL_OF_LADING shipment.

See Error Response Codes in the Appendix for more information on the meaning of these error codes.