Zonos logo
DOCS

Magento

/

Zonos Landed Cost for Magento 

With the Zonos 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.

Getting started 

First, 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. Zonos Duty & Tax
    2. Zonos 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.

Second, configure the Zonos extensions from within the Magento admin:

Configure Zonos Duty & Tax extension in your Magento admin:

  1. Go toMagento 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 Zonos Dashboard and paste it into Magento under “Store ID.”

    • Service Token - Copy your Zonos API key from Zonos 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 Zonos 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 Zonos Hello in your Magento admin:

  1. Obtain your site key from Zonos Dashboard.

  2. Go to Magento adminStoresConfigurationZonosZonos 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 Zonos 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 Zonos 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.

Now, configure your Zonos account settings in your Zonos Dashboard:

After configuring Zonos Duty & Tax and Zonos Hello from within your Magento admin, you will need to configure their settings in Zonos 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 your Zonos Dashboard:

  1. Log in to your Zonos 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 your Zonos Dashboard:

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

Finally, test your Zonos extensions to make sure they are configured correctly

  1. Enable or activate your extension within your Magneto 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 the Zonos Dashboard, along with a quote for the duties, taxes, and fees in the shipping methods offered.


Uninstall or disable Zonos extensions 

How to uninstall Zonos Hello and Zonos Duty & Tax extensions:

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

Disable Zonos Hello and Zonos Duty & Tax:

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