Overview
The ShipperHQ SDK provides an end to end solution to help merchants, developers, and partners integrate with ShipperHQ for purposes and in places not currently available through the native ShipperHQ and eCommerce platform experience. This means being able to take advantage of ShipperHQ's advanced shipping functionality wherever it's needed without having to build a fully custom solution.
Existing Integrations
Our APIs are primarily intended for developers looking to integrate ShipperHQ with a platform where no integration yet exists. ShipperHQ has integrations with a number of major eCommerce platforms that don't require any custom integration or code. We recommend using our existing integrations whenever possible since these are maintained directly by our team.
Use Casesโ
To illustrate what can be achieved with ShipperHQ SDK, here are some examples of use cases that have been implemented using ShipperHQ's APIs.
CRMโ
Give customer service teams full visibility of the delivery option selected by a customer when they place an order. And, give the team shipping rates and options that respect complex business logic configured in ShipperHQ when placing or adjusting orders on behalf of customers. Shipping quotes can be live and accurate instead of estimated plus the sales person can see additional information like expected delivery date (if configured in ShipperHQ).
Relevant APIs
- Rates API to get shipping options and rates
- PlaceOrder Mutation to capture successful orders placed or updated via the CRM
- Insights API to display full shipping details
ERPโ
When creating draft-orders or manual orders, rates can be retrieved from ShipperHQ so that the order shipping costs can be accurately set. It enables multi-channel orders (online, offline, direct sale, etc.) to use the exact same logic, or variations of it, for shipping & delivery rates. The shipping rates returned by ShipperHQ can be overridden in your ERP following your own business rules and authorization system. Usually the ERP inform the rate engine of the various shipping-groups
for the products, present origin-locations with inventory and more to leverage key ShipperHQ functionalities like multi-origin or multi-shipment fulfillment as well as differentiate small-packages vs freight orders.
Relevant APIs
- Rates API to get rates
- PlaceOrder Mutation to capture successful orders
Optionally
- Insights API to fulfill efficiently based on the recommended shipment details from ShipperHQ
- Labels API (in beta) to print shipping labels
Order Management Systemโ
ShipperHQ customers uses various order management systems and the Insights API is a key to leverage the detailed shipment information produced by ShipperHQ during rating at time of fulfillment.
The Insights API enables order management systems to access information like ship-from locations (Origins), package sizes and types, label providers, service classes, and delivery and dispatch dates.
Relevant APIs
- Insights API to retrieve shipment information from ShipperHQ
Point of Saleโ
Integrating ShipperHQ into a POS system means being able to generate the specific delivery options available for a given product or order providing a cohesive customer experience between online and offline sales.
Relevant APIs
- Rates API to get shipping options and rates
eCommerce Platformโ
While ShipperHQ supports many major eCommerce platforms, the Rates API means developers can integrate ShipperHQ to provide rates at checkout in any eCommerce platform. This means being able to leverage the rich functionality of ShipperHQ's rules engine and advanced functions. For this use case, the Rates API can be called at any point where shipping rates are needed such as product pages, carts, and checkout.
Relevant APIs
- Rates API to get shipping options and rates
Optionally
- PlaceOrder Mutation to store ShipperHQ shipment information against orders
- Insights API to retrieve rich shipment information for display within the eCommerce platform admin
Headless Commerceโ
No need for an eCommerce platform. With the ShipperHQ SDK you can build your own experience using whichever tools and technologies that you select. The Rates API will enable you to focus on the user experience while all the business logic is configured in ShipperHQ. The Insights API will allow you to place orders and retrieve all the fulfillment information required to complete this order.
Relevant APIs
- Rates API to get shipping options and rates
- PlaceOrder Mutation to store ShipperHQ shipment information against orders
- Insights API to retrieve shipment information