Updates an existing warehouse receiving order. Only the fields included in the request body are changed; omit a field to leave it as it is. The fulfillment center, expected arrival date and boxes can only be changed while the order is awaiting arrival and none of its boxes have started processing, and not once ShipBob shipping labels have been purchased or generated for it. The purchase order number can be changed in any status except complete. Supplying boxes replaces the entire set of boxes and their contents, so send the complete set rather than only the ones that changed.
Request
The changes to apply. Omit a field to leave it unchanged.
boxeslist of objects or nullOptional
Replaces every box on this receiving order and their contents — boxes that are not included are removed, so send the complete set. Only editable while the receiving order is awaiting arrival and none of its boxes have started processing.
expected_arrival_datedatetime or nullOptional
Expected arrival date of all the box shipments in this receiving order. Must be in the future, and only editable while the receiving order is awaiting arrival and none of its boxes have started processing.
fulfillment_centerobject or nullOptional
Fulfillment center this receiving order is being shipped to. Only editable while the receiving order is awaiting arrival and none of its boxes have started processing. Wrapped in allOf so the nullability applies: in OpenAPI 3.0 a keyword alongside $ref is ignored.
purchase_order_numberstring or nullOptional
Purchase order number for this receiving order. Send an empty or blank string to clear it. Surrounding whitespace is trimmed. Editable in any status except complete.
Response
Success
box_labels_uristring or nullOptional
URL to the packing slip to be included in each box shipment for this receiving order
box_packaging_typeenumOptional
expected_arrival_datedatetimeOptional
Expected date that all packages will have arrived. Returned as a full RFC 3339 date-time, for example 2026-08-05T00:00:00Z.
external_sync_timestampdatetime or nullOptional
The timestamp in UTC when a 3rd party integrator has set in our system
fulfillment_centerobjectOptional
Information about a fulfillment center
idintegerOptional
Unique id of the warehouse receiving order
insert_datedatetimeOptional
Insert date of the receiving order. Returned as a full RFC 3339 date-time, for example 2026-08-05T00:00:00Z.
inventory_quantitieslist of objects or nullOptional
Inventory items and quantities within the WRO
last_updated_datedatetimeOptional
Last date the receiving order was updated. Returned as a full RFC 3339 date-time, for example 2026-08-05T00:00:00Z.
purchase_order_numberstring or nullOptional
Purchase order number for a receiving order
status_historylist of objects or nullOptional
The history of status changes for this receiving order
