Status Reference

A common use case of ShipBob’s API includes filtering orders, shipments, returns, or WROs by status. Here you will find the valid statuses by resource.

Shipment Statuses

Shipment statuses reflect what is happening in the physical world with the package. There is an additional “status detail” section with more detailed information that is also available in our ShipBob Merchant Application.

• Exception: the shipment cannot be fulfilled due to an out of stock or inactive product.
• On Hold: the shipment is not ready for fulfillment, even if there is stock available. Common reasons are: merchant manually placed on hold, missing tarriff codes on international orders, or bad credit card information.
• Processing: the shipment is in the process of fulfillment.
• Completed: the shipment has been fulfilled, i.e. it has left ShipBob. This does not mean it has been delivered by the carrier.
• Cancelled: the shipment has been cancelled and will not be fulfilled.

The most important statuses and status details are listed here:

Shipment Status	Status Detail Name	Status Detail Description	Status Detail ID
Processing	Picked	Picking Completed	100
Processing	Packed	Packing Completed	101
Processing	Labeled	Label Generated	102
Completed	Processing	Waiting For Carrier Pickup	200
Completed	InTransit	Shipment In Transit	201
Completed	OutForDelivery	Shipment Out For Delivery	202
Completed	Delivered	Shipment Delivered	203
Completed	DeliveryException	OrderTracking contains CatchAll date	204
Exception	Bundle	Shipment Contains Bundle Item	300
Exception	MergedItem	Shipment Contains Merge Child	301
Exception	InactiveSku	Shipment Contains an inactive sku	302
Exception	OutOfStock	No Stock On Hand For Sku	303
Exception	UnknownSku	No Sku History (if there are no reasons)	304
Exception	InternalTransferInProgress	Stock Being Transferred Between FCs	305
Exception	BinTransferInProgress	Stock Being Transferred Between Bins	306
Exception	InventoryInNonPickableLocation	Stock In Non-pickable Location	307
Exception	InventoryPartiallyCommitted	Shipment is partially allocated	308
On Hold	PaymentDeclined	Payment Failure	400
On Hold	InvalidAddress	Invalid Address	401
On Hold	ReserveDateNotMet	Wait For Pick Date	402
On Hold	MissingTarriffInformation	Missing Customs Info	404
On Hold	Manual	Manual	405
On Hold	InternationalHazmat	Hazmat Inventory cannot be shipped internationally	406
On Hold	PackagePreferenceNotSet	No Package Preference Set For Inventory	407
On Hold	AutoProcessingPause	Automatic Processing Pause	408

Order Statuses

Orders can have 1 or many shipments (if the contents will not fit in 1 box, for example). Order statuses are imputed from the statuses of the underlying shipments.

Shipment 1 Status	Shipment n Status	Order Status
Processing		Processing
Exception		Exception
On Hold		On Hold
Completed		Completed
Cancelled		Cancelled
Processing	Processing	Processing
Processing	Exception	Processing
Processing	On Hold	Processing
Processing	Cancelled	Processing
Processing	Completed	Partially Fulfilled
Exception	Exception	Exception
Exception	On Hold	Exception
Exception	Completed	Partially Fulfilled
Exception	Cancelled	Exception
On Hold	On Hold	Exception
On Hold	Completed	Partially Fulfilled
On Hold	Cancelled	Exception
Completed	Completed	Fulfilled
Completed	Cancelled	Partially Fulfilled
Cancelled	Cancelled	Cancelled

Warehouse Receiving Order Statuses

Status	Description
Awaiting	WRO has been created and is waiting for the shipment to physically arrive at the destination warehouse.
Processing	Shipment has been checked in at the warehouse and receiving/unloading/quality check activities are in progress.
Arrived	Entire shipment has physically arrived at the destination warehouse and is ready for processing.
PartiallyArrived	Only part of the ordered items/quantities have arrived at the destination warehouse; the rest are still in transit or pending.
PartiallyArrivedAtHub	Part of the shipment has arrived at a hub/transfer point (not the final warehouse); remaining items are still en route.
ArrivedAtHub	Entire shipment has physically arrived at a hub or intermediate transfer facility, awaiting further transport to the final warehouse.
ProcessingAtHub	Shipment is currently being processed (sorted, consolidated, quality-checked, etc.) at a hub before onward transport.
InternalTransfer	Goods are being transferred between internal warehouses/facilities (e.g., from hub to final warehouse or between owned locations).
Completed	All items have been fully received, inspected, and put away in the warehouse inventory. The WRO is closed.
Cancelled	The Warehouse Receiving Order has been cancelled (no further receiving expected).

Return Statuses

Status	Description
AwaitingArrival	Return has been created and awaiting arrival to the warehouse.
Arrived	Return has arrived at the warehouse.
Processing	Return is processing at the warehouse.
Completed	Return has been processed and is completed.
Cancelled	Return has been cancelled.

FAQs

How to get warehouse receiving orders with a specific status?

Poll the Get Multiple Warehouse Receiving Orders endpoint and specify a status (i.e. /receiving?Statuses=Completed).

How to get returns with the Completed status?

You can subscribe to the return.completed webhook.

Another option is to poll the Get Return Orders endpoint and specify a status (i.e. /return?Status=Completed).