Expand description
While the Returns API is live, ShipBob’s end to end Returns process will not go live until the beginning of March. As a result, any returns arriving at ShipBob’s fulfillment centers prior to March 12st, 2020 will NOT be processed.
Use the Returns resource to retrieve, create, edit and cancel return records in ShipBob.
A return is a request for ShipBob to perform an action on inventory that is coming back into our fulfillment centers. Typically, the return is a result of an order being requested to be refunded or exchanged. ShipBob does not handle refunds or exchanges - we simply process the inventory according to the merchant specifications.
Returns can only be modified or cancelled when they are in the Awaiting Arrival status. Returns that are being Processed or have been Completed cannot be modified or cancelled.
Tips for creating return orders:
- Populate the referenceId with a unique and immutable return identifier from your upstream system. This field was created to allow you to tie back records in ShipBob with your upstream system.
*Include each inventoryId exactly once in the inventory object. If an inventoryId is included more than once, the call will return an error code
-
Provide a tracking # when submitting a return, while it is not a required field, it is the the most surefire way for ShipBob staff to properly and quickly identify the return package when it reaches our fulfillment center.
-
Only include inventory items to the return record that will be returned in the same box i.e. if InventoryId 12232 and InventoryId 12039 will be returned in two seperate boxes, two return orders should be created.
-
ShipBob does not process returns for digital items or bundle inventory items. Return calls that include digital inventory items (e.g. ebooks) or bundle inventory items (i.e. multipacks, combination of multiple inventory items) will return an error code.
-
If you choose to provide a requested action (it is an optional field), only provide one requested action per inventory item. So if you have more than 1 quantity of a given item being returned within the same box, all quantities of the item have to have the same action associated with them. If you don’t provide a requested action, it will default to the action the User set for that inventory item in the ShipBob Merchant portal.