Zonos logo

Shipperhq bigcommerce app


Zonos Landed Cost for the ShipperHQ BigCommerce app

Integrate Zonos Landed Cost into your ShipperHQ app in BigCommerce to provide your international customers with a total landed cost at checkout, with the option to prepay duties, taxes, and fees.


  • Retailers cannot offer Delivered Duty Paid (DDP) and Delivered Duty Unpaid/Delivered at Place (DDU/DAP) shipping options at the same time. They must collect duties, taxes, and fees on all service levels or none.

    • The estimated amount owed will still be displayed for shoppers if not pre-collecting.
  • All products/SKUs can be configured with only one country of origin (COO) with this integration.

  • Zonos integration requires the “Standard” ShipperHQ subscription or higher.

Getting started 

Prior to onboarding, your Zonos sales rep should have instructed you to create a Zonos Dashboard account. If you do not have a Zonos account, you can learn how to create one or you can contact us to get one set up.

First, integrate Zonos within ShipperHQ:

  1. Log in to your BigCommerce accountMy AppsShipperHQ
  2. Log in to your ShipperHQ accountShipperHQ marketplace
  3. Search “Zonos” in the search bar → Click on the Zonos app that appears
  4. Click Go To Dashboard, which will install the app
  5. You will be brought to a screen where will need to enter your credentials. Your credentials are also referred to as your API key and that can be found in Zonos DashboardSettingsIntegrations. Click Enter Credentials, and add your API key.
  6. Review and agree to the ShipperHQ terms and conditions by clicking the checkmark and selecting Install.
  7. A message indicating the installation was successful will appear.

Second, configure Zonos with ShipperHQ:

  1. Click on Advanced Features in the left sidebar.
  2. Ensure the toggle to the right of the settings icon under Landed Cost Engine is set to “Enabled” for shipping options.
  3. Select the settings icon under Landed Cost Engine. (If done separately from the installation, go into BigCommerce backendAppsMy AppsShipperHQAdvanced Features.)
  4. Once the settings icon is selected, you will be redirected to the settings page. Select Zonos from the dropdown menu under Select Landed Cost Provider.
  5. There are three options in the dropdown under Duties and Taxes Display (shown in the image above), which are listed as follows, including their definitions:
  • DDP - Display and include duties & taxes in the shipping rate

    • This option will include the duties, taxes, and fees calculated by Zonos in the total shipping rate charged for each shipping option. Customers will be shown the total landed cost, carrier name, service level, and duty and tax amount.
    • Example: “$48.92 – UPS (Worldwide Express – $24.80 in taxes and duties included.)” If this method is used, your packages should be sent DDP, which instructs the carrier to bill the duty/tax to the shipper.
  • DDU - Display duties & taxes, but do not include them in the shipping rate

    • Customers will be shown the amount they can expect to pay upon delivery, but the duties, taxes, and fees will not be included in the shipping rate.
    • Example of how this option looks at checkout: “$48.92 – UPS (Worldwide Express – $24.80 in duties and taxes will be payable on delivery.)”
  • DDU - Do not display or include duties & taxes in the shipping rate but note in order comments

    • While this option is compatible with other shopping platforms, it does not work with BigCommerce.

Now, set up your BigCommerce account with Zonos Landed Cost:

If you have been using ShipperHQ before adding Zonos, then you should have already set up shipping zones. If you have not, then complete the steps below.

  1. Log in to your BigCommerce dashboardSettingsShipping.

  2. Ensure the toggle is set to Advanced shipping rules.

  3. If you have not set up a shipping zone for the countries you want to use the Landed Cost Engine for, click Add Shipping Zone, then select the option that makes the most sense for your store.

    1. Click Add a country zone: Use this option to add a zone with a single country.
    2. Click Add a custom zone: Use this option to add a zone with multiple countries or regions.
    3. Click Add the rest of the world: Use this option to add a zone with all of the countries/regions not already set up in an existing zone.
  4. Once the toggle is set to Advanced and the country zone is set up to use ShipperHQ (shown in the screenshot below), you can set your Automatic Fallback Shipping Methods.

Set up product classification codes in BigCommerce for accurate quotes:

  1. Identify the HS Code or Schedule B number for your product(s). Landed cost calculations cannot be done without HS codes, and the accuracy of the landed cost will greatly increase with correctly classified products.

  2. If you do not have HS codes for your product catalog, Zonos Classify can assist.

  3. Once you have HS codes, add them to your products in BigCommerce by going to ProductsViewDimensions & weightShipping Groups where you can add the HS codes.

  4. Enter the HS code into the Shipping Groups field (found under Advanced Shipping Fields) by prefixing the numerical code with “^HS:”.

    1. For example, you will enter “^HS:0307.40” for the numerical HS code 0307.40. If you already have data listed in this field, it should be separated from the HS code format by a comma, e.g. Poly Mailers,^HS:030740.

The period (between the 7 and 4 in the example) is inconsequential; the code will work correctly whether it is included or not.

Finally, set up Zonos Dashboard settings

  1. Log in to your Zonos Dashboard account.

  2. Add your most commonly used HS code and COO as defaults in Zonos DashboardSettingsLanded Cost Settings. These defaults ensure that Zonos always returns a duty and tax amount.

    1. Your most commonly used HS code will be used to calculate duty and tax rates for products that do not otherwise have this data.
    2. The COO set in Zonos Dashboard is the default COO that will be used for all products (TheCOO is the country of manufacture, not the country where the package is shipped from).
  3. Ensure the store info in Zonos DashboardSettingsGeneral has your correct store information.

If you have questions, please contact our support team. If you do not have the resources to complete the integration and need assistance, please contact our Professional Services team.