Configuring the Magento Plug-In

Read about how Magento users can use the Taxamo plug-in to integrate the service's features.

A Magento extension for Taxamo Assure by Vertex is available here on the Magento Marketplace.



The documentation here outlines the configuration steps in Taxamo Assure by Vertex only. For a complete overview of the configuration steps in both systems, see the documentation provided by Magento.

This plug-in is only for Magento users and is not required for other types of deployments.

Target Audience

The plug-in is designed for Magento store owners and users who are sellers and are based outside the EU and meet the following criteria:

  • You import low value physical goods into the EU for sale to Business-to-Consumer (B2C) customers.
  • You do not want to register for VAT using an intermediary for IOSS.
  • You want to be able to use Taxamo's IOSS number.

Taxamo will be responsible for the VAT for the sales under IOSS and for filing the IOSS return each month.

You will need to send Taxamo's IOSS number to your parcel carrier for the relevant IOSS sales.

Supported Software

For information about supported software, see Taxamo Assure by Vertex Release Notes (Magento Marketplace).

Installation Process Flow

The flowing graphic visualizes the process flow for a Magento installation:

Magento Installation FlowMagento Installation Flow

Magento Installation Flow

Configuration Steps

To configure the plugin, complete the following steps:

  1. Set up your users in the Taxamo Sandbox and Production environments.
    First, you need to sign up for a user and configure the sandbox environment. After you complete the configuration there, you can move on to production, where you do the same.
    For more information about how to deploy the sandbox environment, see Registering and Accessing the Sandbox Environment.
    For more information about how to deploy the production environment, see Accessing the Production Environment.

  2. Retrieve your access token for each environment. For more information, see Retrieving the Access Token.

  3. Classify your products.
    Use the product classification tool to generate HS-CN codes. Note these down as you will need to enter these in your Magento configuration later. You can do so in either environment and you only have to do so once. For more information, see Product Classification.

  4. Add the Taxamo Assure plug-in for Magento.
    The plugin itself is free. You can access it here.
    The pricing for the Taxamo Assure service is here.

  5. Install and configure the Magento plug-in.
    For more information about how to this, see the the User Guide under Documentation here.

  6. Test the integration.
    After you have completed testing on your test store, ensure that all the relevant settings are applied to your production account. Verify that you can use the Production mode in the Magento Admin UI with your production API token.
    For more information about testing the API, see Testing the API Integration.

  7. Send Taxamo's IOSS number to your parcel carrier for the relevant IOSS sales.



Do not reveal this information to anyone else other than your parcel carrier.

If you need further help, contact support at

Did this page help you?