Receiving

​

Warehouse Receiving Orders

A Warehouse Receiving Order (WRO) is how ShipBob manages inbound shipments into their warehouses. You can create a Warehouse Receiving Order using the ShipBob API.

​

Key API Endpoints

• Create Warehouse Receiving Order (POST)
• Get Warehouse Receiving Order (GET)
• Get Box Labels (GET)
• Create Product (POST)
• Get Product (GET)

---

​

How to Create a Warehouse Receiving Order

When creating a Warehouse Receiving Order, the following fields are important:

​

package_type

Accepted values:

• Pallet
  • Include the pallet’s tracking number.
  • Each pallet should be represented as a separate box in the boxes array.
• Package
  • Include the contents and tracking number for each package.
  • Maximum of 50 boxes per request.
• FloorLoadedContainer
  • Provide container contents as one box and include the container’s tracking number.

​

expected_arrival_date

• Must be a future date.
• If not, the API will return a 400 error: “Arrival date must be in the future.”

​

Product Inventory IDs

• Every product in the order must have a ShipBob inventory_id.
• Check if a product exists using the Get Product API:
  • If it exists, use its inventory_id.
  • If not, create it using the Create Product API and use the returned inventory_id.
• Alternatively, store the inventory_id when products are first created in your system.

​

purchase_order_number

• Use a unique identifier (e.g., PO number or shipment ID).

​

tracking_number (for each box or pallet)

• Include a scannable carton ID so ShipBob can scan items upon arrival.

---

​

Tracking Warehouse Receiving Order Status

Use the Get Warehouse Receiving Order API to check order status and progress.

​

Available Filters:

• statuses: Filter by status (e.g., Awaiting, Arrived, Processing, Completed)
• purchaseOrderNumbers: Filter by specific PO numbers

​

Status Flow:

1. Awaiting – Order created, waiting to arrive.
2. Arrived / PartiallyArrived – Shipment scanned at warehouse.
3. Processing – Stowing in progress. Monitor:
   • stowed_quantity in each product’s inventory
4. Completed – All items stowed, order is finalized.

You can also use the Get Warehouse Receiving Order Boxes API to:

• Get the status of each box
• View quantities received per box

---

​

Visual Overview of Status Updates