Skip to main content

How Advanced Shipment Details Work

ShipperHQ generates a significant amount of detail about each shipment for which it generates shipping rates and options each time an application calls the Rates API. Once the ShipperHQ account associated with the rating call has the Advanced Shipment Details Advanced Feature enabled, ShipperHQ stores these shipment details for later retrieval with the Advanced Shipment Details API.

When using the ShipperHQ native integrations with Magento 2, BigCommerce, or Shopify, enabling the Advanced Shipment Details Advanced Feature will automatically store shipment information when a customer completes a checkout. For other platforms or custom integrations, you have to use the PlaceOrder mutation of the Labels API to capture a successful checkout and store shipment information. In either case, the Order Number is attached to the shipment information when stored and is used to look up for this shipment information using the Advanced Shipment Details API.

Workflow​

Advanced Shipment Details API workflow

  1. The Rates API receive a rate request
  2. ShipperHQ generates rates and options and returns them
  3. When the customer completes checkout, a call to PlaceOrder causes ShipperHQ to capture this quote as an order with a unique identifier (Order Number)
  4. Order and shipment details are then available via the Advanced Shipment Details API

Key queries​

The Advanced Shipment Details API is a read-only API that returns shipment details for shipments rated with the Rates API.

QueryDescription
viewOrderGiven an order number, retrieves shipment information for that order.
PlaceOrder mutation

Implementation of the related PlaceOrder mutation of the Labels API may be required to use Advanced Shipment Details. However, this is only the case if you are not using the native ShipperHQ apps/plugins/extensions on Magento/Adobe Commerce, BigCommerce, Shopify, SalesForce B2C Commerce Cloud, WooCommerce, Zoey - complete list here). When using the native ShipperHQ integration with any of these platforms, the PlaceOrder function occurs automatically, so you can use the Advanced Shipment Details API without implementing PlaceOrder yourself.