Landed Cost for Magento

Learn how to integrate the Zonos Duty & Tax extension for Magento to provide a total landed cost in your native checkout.

With our Duty & Tax extension for Magento, you can give international customers a total landed cost within your Magento checkout, including duty, tax, and brokerage fee calculations with prepayment options. You are able to customize your international shipping options using the shipping carriers and service levels of your choice.

Important to note
  • The extension installation described below must be done by an experienced Magento developer. If you have questions, please contact us.

  • In order for Zonos Landed Cost to work properly, two extensions must be “purchased”:

  • Create your Zonos account before doing your Magento configuration to ensure a smooth installation. If you do not have a Zonos account, please contact us.

Get started 


Install the Zonos extensions from the Magento store

  1. Log in to your Magento admin account.

  2. “Purchase” both of these Zonos extensions from the Magento marketplace:

    1. Duty & Tax
    2. Hello
    3. The extensions will be linked to your Magento authentication keys and allow the extensions to be installed via Composer.
  3. Follow the Adobe install an extension instructions to complete the installation via Composer.

Hello will automatically get installed during the installation of the Duty & Tax extension because it is listed as a dependency in the Duty & Tax extension’s composer.json file.

If you do not “purchase” both Hello and Duty & Tax from the marketplace, then the installation will fail with a package not found error.


Configure the Zonos extensions from within the Magento admin

Configure the Duty & Tax extension in your Magento admin:

  1. Go to Magento admin.

  2. Click on Stores in the sidebar.

  3. Click on Configuration in the popup menu.

  4. Then click on Zonos in the white sidebar on the next page.

  5. Configure the following options as instructed below:

    • Enable - Select Yes in the Yes/No dropdown next to the field “Enabled” in the Magento extension settings configuration. This allows Zonos to display duty, tax, and shipping quotes to your shoppers in your selected, specified countries.

    • Store ID - Copy your Zonos account number from Dashboard and paste it into Magento under “Store ID.”

    • Service Token - Copy your Zonos API key from Dashboard and paste it into Magento under “Service Token.”

    • Carrier Title - “International” will be displayed by default to distinguish quotes from Zonos, but you can change it to your preferred carrier title.

    • Disable for U.S. Addresses - By default, this is set to YES because Zonos is not typically meant to quote domestic orders, so you would select YES to disable U.S. addresses. However, you can select NO if you want Zonos to quote U.S.-addressed orders. Generally, if you are based outside of the U.S., select NO to enable U.S.-addressed orders.

    • Ship to Applicable Countries - Set to All Allowed Countries by default to provide a landed cost quote for any countries you have enabled and set up shipping rates for in Dashboard. If you want to quote for only specific countries, select Specific Countries, then choose countries you wish to ship to in the “Ship to Specific Countries” section.

  • Displayed Error Message - Type in the message you want to display to your customer if an international shipping quote cannot be given, or a default message will be displayed (shown in the image above).

  • Cart Item Attribute Mapping - There is product/item-level information that Zonos uses to calculate duties and taxes that Magento does not have fields for, like HS codes. You may use any of these open fields to add additional item information to your catalog.

Map your custom fields, or those missing from Magento, to any of these fields available in the Zonos system for Zonos to recognize what your custom fields communicate. You may need info that is not passed by default for custom rules.

  • Length, Width, and Height - Although the extension includes the shipment’s length, width, and height in the description, the measurements require some mapping before they are pulled through. Like the HS codes, there’s a drop-down menu under Cart Item Attribute Mapping (pictured below). Again, you must select the corresponding length, width, height, and HS code fields to input their information.

Configure Hello in your Magento admin:

  1. Obtain your site key from Dashboard.

  2. Go to Magento admin -> Stores -> Configuration -> Zonos -> Zonos Hello.

  3. Configure the following options as instructed below:

    • Enable - Select Yes in the Yes/No dropdown next to “Module Enable” in the Magento extension settings configuration. This allows the Hello widget to display duty and tax quotes while customers visit your product pages.
    • Store ID - Enter your Zonos-provided site key obtained from step 1 into Magento under “Store ID.”
    • Currency Conversion Selectors - If you want Hello to convert currency, paste your CSS selectors here. Multiple selectors are separated with a comma, e.g., .price,.__current-price,.__subtotal,.__original-price.
    • Hide Domestic Elements (optional) - If you need or want to hide domestic elements for your international customers, input CSS selectors for elements you want to hide, e.g., .nav-6,.action-add.

Configure your Zonos account settings in Dashboard

After configuring Duty & Tax and Hello from within your Magento admin, you will need to configure their settings in Dashboard. Follow the instructions below to complete the Dashboard configurations and adjust how your landed cost will be calculated.

Configure how landed cost is calculated in Dashboard:

  1. Log in to your Dashboard account.
  2. Visit the Landed Cost setup page to learn how to configure the specifics of how your landed cost will be calculated.

Configure your shipping rates in Dashboard:

  1. Visit the shipping setup page to learn how to configure your shipping settings.

Test your Zonos extensions to make sure they are configured correctly

  1. Enable or activate your extension within your Magento Admin once all settings have been configured for accurate testing.

    1. If there are more changes you want to make post-testing, select No in the Yes/No dropdown next to the field “Enabled” until you have adjusted everything to your liking. When you are ready for Zonos to be enabled and live on your site, select Yes in the Yes/No dropdown next to the field “Enabled.”
  2. Go onto your business website and add items to your cart. It is best to have a cart over the de minimis value for whatever country you will be testing rates for so that duties and taxes will be due, and thus, you will receive a total landed cost quote.

  3. Click Checkout.

  4. Add an international address to your checkout. (Note: If you are connected to your carrier’s API via the carrier account connection for shipping rates, you will need to use a legitimate address, or you will not get quotes back.)

    1. Use this link to generate valid addresses in the country you are testing.
  5. The Shipping tab should have a section to enter “Shipping Address” information and a section to choose “Shipping Methods.”

  6. If completed the setup correctly, you will see the shipping options you set up in Dashboard, along with a quote for the duties, taxes, and fees in the shipping methods offered.

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.

Uninstall or disable Zonos extensions 

How to uninstall Hello and Duty & Tax

If you need to disable or uninstall either Zonos extension, follow the Uninstall modules Adobe Commerce instructions.

Disable Hello and Duty & Tax

Disable Hello and Duty & Tax extensions by selecting No in the Yes/No dropdown next to the field “Enabled” in the Magento extension settings configuration.

Was this page helpful?

© 2023