Skip to main content
POST
/
2025-07
/
receiving
Create Warehouse Receiving Order 
curl --request POST \
  --url https://api.shipbob.com/2025-07/receiving \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "box_packaging_type": "EverythingInOneBox",
  "boxes": [
    {
      "box_items": [
        {
          "inventory_id": 0,
          "lot_date": "2019-08-24T14:15:22Z",
          "lot_number": "2222",
          "quantity": 1
        }
      ],
      "tracking_number": "860C8CDC8F0B4FC7AB69AC86C20539EC"
    }
  ],
  "expected_arrival_date": "2019-08-24T14:15:22Z",
  "fulfillment_center": {
    "id": 0
  },
  "package_type": "Package",
  "purchase_order_number": "string"
}'
{
  "box_labels_uri": "https://api.shipbob.com/1.0/receiving/1/labels",
  "box_packaging_type": "EverythingInOneBox",
  "expected_arrival_date": "2019-08-24T14:15:22Z",
  "external_sync_timestamp": "2019-08-24T14:15:22Z",
  "fulfillment_center": {
    "address1": "5900 W Ogden Ave",
    "address2": "Suite 100",
    "city": "Cicero",
    "country": "USA",
    "email": "example@example.com",
    "id": 0,
    "name": "Cicero (IL)",
    "phone_number": "555-555-5555",
    "state": "IL",
    "timezone": "Central Standard Time",
    "zip_code": "60804"
  },
  "id": 0,
  "insert_date": "2019-08-24T14:15:22Z",
  "inventory_quantities": [
    {
      "expected_quantity": 0,
      "inventory_id": 0,
      "received_quantity": 0,
      "sku": "string",
      "stowed_quantity": 0
    }
  ],
  "last_updated_date": "2019-08-24T14:15:22Z",
  "package_type": "Package",
  "purchase_order_number": "string",
  "status": "Awaiting",
  "status_history": [
    {
      "id": 0,
      "status": "Processing",
      "timestamp": "2019-08-24T14:15:22Z"
    }
  ]
}
Use the Receiving Resource to retrieve, create, and cancel Warehouse Receiving Orders (WROs). A WRO is a request form that tells ShipBob’s fulfillment centers what inventory should be received and stocked. Some other solutions call this an “ASN” or Advanced Ship Notice. WROs may include multiple inventory items with specific quantities. More details on creating a WRO can be found here. A WRO can only be canceled if it is in the Awaiting status. WROs in Awaiting status are considered to still be in transit to ShipBob FCs. WROs that have Partially Arrived, have been Processed, or are Completed, cannot be canceled.

Authorizations

​
Authorization
string
header
required

Authentication using Personal Access Token (PAT) token

Body

application/json

The receiving order to create

Information to create a new receiving order

​
box_packaging_type
enum<string>
required
Available options:
EverythingInOneBox,
OneSkuPerBox,
MultipleSkuPerBox
​
boxes
object[] | null
required

Box shipments to be added to this receiving order

​
expected_arrival_date
string<date-time>
required

Expected arrival date of all the box shipments in this receiving order

​
fulfillment_center
object
required

Model containing information that assigns a receiving order to a fulfillment center. If the fulfillment center provided is in a receiving hub region, then the response will be the receiving hub location.

​
package_type
enum<string>
required
Available options:
Package,
Pallet,
FloorLoadedContainer
​
purchase_order_number
string | null

Purchase order number for this receiving order

Response

Success

​
box_labels_uri
string | null

URL to the packing slip to be included in each box shipment for this receiving order

Example:

"https://api.shipbob.com/1.0/receiving/1/labels"

​
box_packaging_type
enum<string>
Available options:
EverythingInOneBox,
OneSkuPerBox,
MultipleSkuPerBox
​
expected_arrival_date
string<date-time>

Expected date that all packages will have arrived

​
external_sync_timestamp
string<date-time> | null

The timestamp in UTC when a 3rd party integrator has set in our system

​
fulfillment_center
object

Information about a fulfillment center

​
id
integer

Unique id of the warehouse receiving order

​
insert_date
string<date-time>

Insert date of the receiving order

​
inventory_quantities
object[] | null

Inventory items and quantities within the WRO

​
last_updated_date
string<date-time>

Last date the receiving order was updated

​
package_type
enum<string>
Available options:
Package,
Pallet,
FloorLoadedContainer
​
purchase_order_number
string | null

Purchase order number for a receiving order

​
status
enum<string>
Available options:
Awaiting,
Processing,
Completed,
Cancelled,
Incomplete,
Arrived,
PartiallyArrived,
PartiallyArrivedAtHub,
ArrivedAtHub,
ProcessingAtHub,
InternalTransfer
​
status_history
object[] | null

The history of status changes for this receiving order

⌘I