Create Warehouse Receiving Order | ShipBob Developer API

curl -X POST https://sandbox-api.shipbob.com/2.0/receiving \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "box_packaging_type": "EverythingInOneBox",
  "boxes": [
    {
      "box_items": [
        {
          "inventory_id": 0,
          "quantity": 1,
          "lot_date": "2019-08-24T14:15:22Z",
          "lot_number": "2222"
        }
      ],
      "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",
    "country": "USA",
    "id": 0,
    "name": "Cicero (IL)",
    "state": "IL",
    "zip_code": "60804",
    "address2": "Suite 100",
    "city": "Cicero",
    "email": "example@example.com",
    "phone_number": "555-555-5555",
    "timezone": "Central Standard Time"
  },
  "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"
}

Authentication

AuthorizationBearer

Authentication using Personal Access Token (PAT) token

AuthorizationBearer

OAuth2 authentication using JWT tokens

Request

The receiving order to create

box_packaging_typeenumRequired

EverythingInOneBox OneSkuPerBox MultipleSkuPerBox

Allowed values:

boxeslist of objects or nullRequired

Box shipments to be added to this receiving order

expected_arrival_datedatetimeRequired

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

fulfillment_centerobjectRequired

package_typeenumRequired

Package Pallet FloorLoadedContainer

Allowed values:

purchase_order_numberstring or nullOptional

Purchase order number for this receiving order

Response

Success

box_labels_uristring or null

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

box_packaging_typeenum

EverythingInOneBox OneSkuPerBox MultipleSkuPerBox

Allowed values:

expected_arrival_datedatetime

Expected date that all packages will have arrived

fulfillment_centerobject

idinteger

Unique id of the warehouse receiving order

insert_datedatetime

Insert date of the receiving order

inventory_quantitieslist of objects or null

Inventory items and quantities within the WRO

last_updated_datedatetime

Last date the receiving order was updated

package_typeenum

Package Pallet FloorLoadedContainer

Allowed values:

purchase_order_numberstring or null

Purchase order number for a receiving order

statusenum

Awaiting Processing Completed Cancelled Incomplete Arrived PartiallyArrived PartiallyArrivedAtHub ArrivedAtHub ProcessingAtHub InternalTransfer

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error