v1

latestOpenAPI 3.0.12026-07-242073551.1 MB
Shipments

Update Status

Hold - Put the shipments on hold for up to 28 days. Shipments on hold for longer than 28 days will be cancelled. A shipment on hold will not be included in an closeouts/manifests, but instead will remain in its current state. You can only put shipments on hold that are in the 'LabelPrinted' status as only shipments with this status are included in manifests. <br />
<br />Cancel - Use to cancel/void one or more current shipments. This can only be used before a shipment has been confirmed by being manifested. <br />
<br />Release - Use to release shipments from hold and shipments cancelled for less than 24 hours. Once released, the shipment will be included in the next manifest. <br />
<br />Picked - Set the shipment to picked. This means this shipment will only be manifested if you choose to manifest 'Picked' shipments.

put/v4/shipments/status

Request body

Status'Hold' | 'Cancel' | 'Release' | 'Picked' required

Update Status Type <br /> <br />Hold - Put the shipments on hold for up to 28 days. Shipments on hold for longer than 28 days will be cancelled. A shipment on hold will not be included in an closeouts/manifests, but instead will remain in its current state. You can only put shipments on hold that are in the 'LabelPrinted' status as only shipments with this status are included in manifests. <br />Cancel - Use to cancel/void one or more current shipments. This can only be used before a shipment has been confirmed by being manifested. <br />Release - Use to release shipments from hold and shipments cancelled for less than 24 hours. Once released, the shipment will be included in the next manifest. <br />Picked - Set the shipment to picked. This means this shipment will only be manifested if you choose to manifest 'Picked' shipments.

Reasonstring nullable

Reason <br />The reason for this status update. <br />
<br />If the status you are updating to is 'Hold' the reason is required and must be one of the following values: <br />Awaiting Dispatch <br />Awaiting Payment <br />Awaiting Stock <br />Awaiting Customer Response <br />Held for Shipping Day <br />Weight Consolidation <br />Warehouse Processing <br />
<br />If the status you are updating to is 'Cancel', the reason is required and must be one of the following values: <br />Order Cancelled <br />Packed in Error <br />Repacked

ShipmentIdsstring[] required

Shipment Ids <br />The shipments to apply the change to. <br />There must be at least 1 shipment and a maximum of 99. <br />
<br />The Shipment Id may be an id or a tracking/barcode number. <br />For consignment shipments, only the consignment level tracking/barcode number can be used.

Response

All shipments were updated successfully.