🗑️ Delete/Cancel
Learn how to use the Carrier Connect API calls to programmatically DELETE or CANCEL existing shipments or pickups.
cancelShipment: Cancel a shipping order
With the cancelShipment call you can cancel a shipping order.
Please note, that once a shipping order has been completed (i.e.,
doCompletion = true
), it becomes immutable.Any data correction is not possible through the interface after completion. Therefore, to make changes, you must first cancel the completed shipping order using the
cancelShipment
call and subsequently retransmit the data with the createShipment call.
It's important to highlight, that the
cancelShipment
call sets the shipping order status to canceled; the order itself will not be deleted.This ensures proper record-keeping while effectively canceling the order.
{
...
"shipmentReference": {
"referenceNumber1": "1001"
}
}
...
<shipmentReference>
<referenceNumber1>1001</referenceNumber1>
</shipmentReference>
...
deleteItem: Delete an item
The deleteItem call allows you to effectively remove an existing item from a shipping order.
{
...
"shipmentItemReference": {
"shipmentReference": {
"referenceNumber1": "1001"
},
"itemTransactionId": "YOUR_TRANSACTION_ID"
}
}
...
<shipmentItemReference>
<shipmentReference>
<referenceNumber1>1001</referenceNumber1>
</shipmentReference>
<itemTransactionId>YOUR_TRANSACTION_ID</itemTransactionId>
</shipmentItemReference>
deletePackage: Delete a package
The deletePackage call provides a straightforward method to delete a package from your shipping order.
{
...
"packageReference": {
"shipmentReference": {
"referenceNumber1": "1001"
},
"packageTransactionId": "YOUR_TRANSACTION_ID"
}
}
...
<packageReference>
<shipmentReference>
<referenceNumber1>1001</referenceNumber1>
</shipmentReference>
<packageTransactionId>YOUR_TRANSACTION_ID</packageTransactionId>
</packageReference>
deletePickup: Delete a pickup
The deletePickup enables you to delete an existing pickup. When this call is made, all shipments associated with the pickup are removed, and they must be assigned to a new pickup using another createPickup
call.
It's important to note, that a pickup that has already been closed (i.e.,
doManifest = true
) cannot be deleted anymore.
{
...
"pickupReference": {
"referenceNumber1": "1001"
}
}
...
<pickupReference>
<referenceNumber1>1001</referenceNumber1>
</pickupReference>
Updated about 1 year ago