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.
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”:
Log in to your Magento admin account.
“Purchase” both of these Zonos extensions from the Magento marketplace:
Follow the Adobe install an extension instructions to complete the installation via Composer.
Zonos 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 Zonos Hello and Duty & Tax from the marketplace, then the installation will fail with a package not found error.
Go toMagento admin.
Click on Stores in the sidebar.
Click on Configuration in the popup menu.
Then click on Zonos in the white sidebar on the next page.
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.
Obtain your site key from Zonos Dashboard.
Go to Magento admin → Stores → Configuration → Zonos → Zonos Hello.
Configure the following options as instructed below:
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.
Enable or activate your extension within your Magneto Admin once all settings have been configured for accurate testing.
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.
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.)
The Shipping tab should have a section to enter “Shipping Address” information and a section to choose “Shipping Methods.”
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.
If you need to disable or uninstall either Zonos extension, follow the Uninstall modules Adobe Commerce instructions.
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.