Zonos provides duties and tax calculation for international shipping that can be used with your ShipperHQ shipping rates to provide your customers with full landed costs at checkout. With ShipperHQ and Zonos you can either collect the expected duties, taxes, and fees along with shipping costs if you’ll be paying for these charges (Delivery Duty Paid or DDP) or give your customers visibility of the charges they’ll be responsible for paying on delivery (Delivery Duty Unpaid or DDU).

Currently Unavailable
Our integration with Zonos is currently unavailable for new merchants. If you already have Zonos installed on your ShipperHQ account you can continue to use it. For current support, please see this link for setting up Landed Costs with Flavor Cloud.


  • A Zonos account
  • A ShipperHQ account at the Standard, Advanced, or Enterprise plan level
  • ShipperHQ installed on a Shopify, BigCommerce, or Adobe Commerce/Magento 2 site
  • The ShipperHQ Landed Cost Engine Advanced Feature enabled
  • At least one Carrier in your ShipperHQ account offering international shipping

Connecting ShipperHQ to Zonos

To connect your ShipperHQ account to your Zonos account you’ll need to generate an API Key from within your Zonos dashboard to allow ShipperHQ to connect to Zonos on your behalf.

Retrieving your Zonos API Key

  1. Log into your Zonos dashboard and click Settings in the left-hand navbar
  2. Click on Integrations to view your API Key
  3. Copy your API Key to use when setting up Zonos within ShipperHQ

Installing Zonos in ShipperHQ

  1. In your ShipperHQ Dashboard click on Marketplace in the left-hand navbar
  2. Search for Zonos and click the “Install” button
  3. If you haven’t already enabled the Landed Cost Engine Advanced Feature you’ll be prompted to enable it now, then click “Continue”
  4. Click “Enter Credentials”
  5. Paste the API Key you retrieved from your Zonos account into the API Key field and click “Install”
  6. Your Zonos account is now connected to ShipperHQ and you can proceed to configure Zonos

Configuring Zonos in ShipperHQ

Zonos uses ShipperHQ’s Landed Cost Engine Advanced Feature to manage how Zonos-generated duties, taxes, and fees are applied to your international shipping rates.

  1. Click on “Advanced Features” in the left-hand navbar
  2. Click the Settings (gear) icon on the Landed Cost Engine Advanced Feature
  3. Under “Select Landed Cost Provider” choose “Zonos”
  4. Under “Duties And Taxes Display” choose how you want to show or charge duties & taxes to your customers
    • Combine the duties and taxes into your shipping rate will include the duties, taxes, and fees returned by Zonos in the total shipping rate charged for each shipping option you offer. Customers will be shown “X in taxes and duties included” along with your shipping method name. E.g. “$48.92 – UPS (Worldwide Express – $24.80 in taxes and duties included)”
    • Show the duties and taxes separate from the shipping rate will not include the duties, taxes, and fees returned by Zonos in the shipping rate charged but will show the customer the amount they can expect to pay on delivery. E.g. “$48.92 – UPS (Worldwide Express – $24.80 in duties and taxes will be payable on delivery)”
    • Record the duties and taxes on order comments only, don’t show to the customer will not include the duties, taxes, and fees returned by Zonos in the shipping rate charged or show the amount to customers. Instead, an order comment will be saved against the order in your eCommerce platform including this information. Note: This option is only available for the Magento eCommerce platform.
  5. Click the “Apply” button to save your settings

Based on the configuration you’ve chosen, ShipperHQ will start applying Zonos duties, taxes, and fees to the shipping options you offer your customers for international shipments.

Additional Information


Delivered Duties Paid (DDP) indicates that the seller pays for all duties, import clearance, and taxes. Delivered Duty Unpaid (DDU) indicates that the seller is responsible for all associated costs of transport, but when a product arrives at the destination the buyer becomes responsible for paying import duties and taxes. ShipperHQ’s integration with Zonos supports both DDU and DDP. See Configuring Zonos in ShipperHQ above for setup instructions.


Some carriers do not support DDP delivery (e.g. USPS). For carrier services supported by Zonos, these will be automatically determined and DDP results will not be shown for these services. For other services, you will need to ensure you have manually hidden them if offering DDP.

See Zonos Supported Carriers & Services for details.

Product Configuration

When ShipperHQ requests duties, taxes, and fees from Zonos we include the SKUs of the products defined on your eCommerce platform for each product in the order. Optionally, we can include HS Codes (Harmonized System codes of the Harmonized Tariff Schedule or HST used to classify imports and exports) set on your products.

Assigning HS Codes

While Zonos does not require HS Codes to be explicitly set for items, doing so can improve the accuracy of the duties & taxes Zonos provides. HS Codes can be assigned to products using the instructions below within your eCommerce platform catalog.

If you do not have HS Codes for your products or wish to have your existing values reviewed, contact Zonos. Product classifications may be available though an additional cost may be required.

Once you have your product HS Codes, you can update your products with these codes to ensure ShipperHQ can retrieve them when generating shipping rates.

Adobe Commerce/Magento 2

When the ShipperHQ extension is installed, it adds a new HS Code product attribute. If this attribute is not available, ensure you’re running the latest version of the ShipperHQ extension and that the attribute has been added to the attribute set you’re using.

More about ShipperHQ Attributes for Adobe Commerce/Magento 2


HS Codes can be set on products or product variants using the “Edit Shipping Properties” option when editing a product within Shopify or via any other Shopify Metafields editor. Learn More


HS Codes can be set as values of the Shipping Group field on products and product options in BigCommerce by prefixing the HS Code with “^HS:”. For example, “^HS:03.07.40” for HS Code 03.07.40. Learn More

Country of Origin

We do not currently support setting a Country of Origin on products. However, for scenarios in which this is required, a default country of origin can be set within Zonos which will be used when ShipperHQ requests Duties & Taxes. Additionally, a list of products can be provided to Zonos with the Country of Origin for each for products which differ from your default. Contact Zonos to discuss the best way to handle this for your needs.

Compatible Carriers

Zonos Supported Carriers & Services

For carriers and services supported by Zonos, Zonos is able to return carrier surcharges and fees (e.g. customs clearance fees) in addition to duties & taxes. Additionally, for these carriers and services, if the service does not provide a DDP option, Zonos will not return DDP results for those specific services.

A list of carriers and services supported by Zonos is available in the Zonos Docs.

If you are using carriers and services that Zonos does not support in ShipperHQ, you will still be able to get DDP and DDU results from Zonos via ShipperHQ. However, these results will not include any carrier- or service-specific surcharges or fees. Additionally, if you are offering DDP, you will need to ensure that you are not displaying any carriers or services which do not support DDP. This can be done by setting a Carrier Zone restriction on the carrier or using Shipping Rules to hide a carrier or specific services.

For guidance on which carriers support and do not support DDP, contact Zonos.

Carrier Compatibility in ShipperHQ

Zonos in ShipperHQ is compatible with any carrier which provides international services except those carriers which support duties & tax calculations themselves within ShipperHQ. For these carriers, duties & taxes will not be requested from Zonos since these rates already include duties & taxes.

Was this doc helpful?