Skip to main content
POST
/
2.0
/
receiving
Create Warehouse Receiving Order 
curl --request POST \
  --url https://sandbox-api.shipbob.com/2.0/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",
  "fulfillment_center": {
    "address1": "5900 W Ogden Ave",
    "address2": "Suite 100",
    "city": "Cicero",
    "country": "USA",
    "email": "[email protected]",
    "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"
}
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

EverythingInOneBox

OneSkuPerBox

MultipleSkuPerBox

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
​
package_type
enum<string>
required

Package

Pallet

FloorLoadedContainer

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>

EverythingInOneBox

OneSkuPerBox

MultipleSkuPerBox

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

Expected date that all packages will have arrived

​
fulfillment_center
object
​
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>

Package

Pallet

FloorLoadedContainer

Available options:
Package,
Pallet,
FloorLoadedContainer
​
purchase_order_number
string | null

Purchase order number for a receiving order

​
status
enum<string>

Awaiting

Processing

Completed

Cancelled

Incomplete

Arrived

PartiallyArrived

PartiallyArrivedAtHub

ArrivedAtHub

ProcessingAtHub

InternalTransfer

Available options:
Awaiting,
Processing,
Completed,
Cancelled,
Incomplete,
Arrived,
PartiallyArrived,
PartiallyArrivedAtHub,
ArrivedAtHub,
ProcessingAtHub,
InternalTransfer