Tracking

​

Retrieving tracking and fulfillment details

There are two primary options for retrieving shipment details from ShipBob.

​

Option 1 – Webhooks

ShipBob has the ability to fire webhooks for certain shipment events. The topics that can be subscribed to are:

• Shipped event
• Delivery event
• Shipment exception event (such as a product being out of stock)
• Shipment On Hold event (such as an invalid address)
• Shipment cancelled event

A couple critical pieces to note:

• Each topic can be subscribed to in the ShipBob dashboard by going to Integrations > Webhooks > Add Subscription.
• You can also subscribe to webhooks via API. Request details can be found here.
• Learn more about ShipBob webhooks here.

​

Option 2 – Polling-based approach

This method allows you to fetch tracking details from ShipBob on demand using the GET Orders endpoint. There are several parameters to choose from depending on your use case, but the most common params used are:

• HasTracking – this will filter orders only where tracking information has been made available (i.e. the order has shipped).
• IsTrackingUploaded – this is a query parameter you can use as a ‘checker’ on your end. If false, you will know you have not synced to your system.

Here is a high level overview: You also can specify a shipbob_channel_id header parameter. It is advised to pass this parameter for the channel you have write access to, so you only retrieve order and shipment details from orders that were created from your integration. Excluding the channel id will be a global search across all channels for the Merchant, which has the possibility to retrieve order details from other sources/integrations a merchant has installed that you may not need. If your platform supports split orders/shipments, you will need to refer to the multiple shipment objects returned in the API response in the event that an order has been split. Within the order response, you will see an array of shipments. An order can have a one-to-many relationship to shipments if the order has been split. Each shipment associated with an order will have a unique tracking number and will detail which products have been packed and shipped as part of that individual shipment. Each shipment will also have a status. When a shipment has tracking details, the shipment status will be LabeledCreated. This status will quickly move to Completed. If you have a use-case that requires you to look at specific ShipBob statuses, it is recommended to use both statuses when checking for tracking details from ShipBob. To see more detail on other statuses you may encounter, please refer to our documentation here.

​

Supported carrier identifiers

If you need to setup carrier mapping to map carrier names from ShipBob to your system, here is a list of how each carrier shows up in the ShipBob API: