How we integrate
WooCommerce is a customizable platform. This means that a one-size-fits-all integration, like a plugin, doesn't work very well on WooCommerce. Instead, our engineers have created a customizable module to make integration easy for you. Our engineers will review your store's custom setup in WooCommerce, add our WooCommerce Duty and Tax module and adjust the code to accommodate your store.
Integrate
Create and configure a Zonos account
- Register for a Dashboard account.
- After registering, complete your Account setup.
Install the Duty and Tax module
The Duty and Tax module is only available for installation through our Professional Services team. Our engineers will install the Landed Cost module for you once you start onboarding with your Project Manager in onboarding.
Optional—Add your product information
Product information like weight and dimensions can automatically be used in our calculations if you have them present in WooCommerce or Catalog.
However information like HS codes, country of origin, and item restrictions must be either entered in Catalog, or mapped to attributes that you set up in WooCommerce. To map this product information in WooCommerce:
- Create the custom attribute in WooCommerce using the slug in the table below to allow us to recognize it in our mapping.
- After creating the attributes for your store, go into your product listings and add the attributes with their values, using the table below. Instructions for how to add custom attributes to product listings are at the bottom of the article above.
- Item restrctions require a third step: Zonos will need to write a rule on our end to restrict the items you have set as restricted in WooCommerce. Please let us know if you are setting up item restrictions in WooCommerce so that we can complete this step.
| Attribute | Slug | Value |
|---|---|---|
| Hs code | hs_code | The HS code example: 1234.56.7890 |
| Country of origin | country_of_origin | Two letter ISO code of the country example: CA |
| Item restriction | int_restrict | The word "restrict" for any product that you want to restrict |
Configure the Duty and Tax module in WooCommerce
Our engineers will adjust the settings as needed. They will work with your Project Manager if they have any questions for you.
Test your integration
Now that you have set up your account and your module, you are ready to test it by doing the following:
Test duty and tax quotes
- Add item(s) to your cart. We recommend using a higher value (above the de minimis) to ensure that duties and taxes will be due for the order.
- Click Checkout.
- Add an international address to your checkout.
- If set up correctly, you will see a duty and tax quote below the shipping cost in the order summary.
Test order flow through your systems
- Place an order on your site for testing purposes.
- Follow your test order through your systems for fulfillment, label printing, and finances to ensure there are no conflicts.
If you print your labels from Dashboard
-
Confirm labels will generate successfully by printing a test label. If you have multiple carriers enabled, print a label for each carrier. You can void your label after printing it, then use the same order to test more labels.
- If you receive an error when printing a label in the Dashboard, learn how to resolve label errors.
-
Once tested, void the label, then cancel and refund your test order.
After completing testing, you are now ready to go live. Let your Project Manager know when you are ready, and they can enable the Duty and Tax module for you!
Example
Below is an example of a native WooCommerce checkout using the WooCommerce Duty and Tax module. Since WooCommerce is customizable, your checkout may look different from the one below.
Frequently asked questions
What product details are passed to Zonos from WooCommerce?
Product-specific information is not required for Zonos to return a quote. However, the more product-specific information provided, the more accurate our calculations will be. The most helpful product details for improved accuracy are listed below.
Find out which product info is received from WooCommerce, needs a custom attribute, or is not received at all and Catalog is recommended.
- Weights - Received from WooCommerce.
- Dimensions - Received from WooCommerce.
- HS codes - Create a custom attribute in the app or use Catalog.
- Country of origin - Create a custom attribute in the app or use Catalog.
Landed Cost for WooCommerce
Learn about our custom Duty and Tax module.Using the WooCommerce Duty and Tax module will allow the following: