Import One Stop Shop (IOSS)

This topic describes how to configure the marketplace and sellers settings to facilitate participation in Import One Stop Shop (IOSS).

First, you need to ensure that you have created an EU region to represent the European Union.

Marketplace Regional Settings

You need to specify the following fields in the Marketplace's regional settings:

FieldDescription
taxation.physical.special_tax_registrationIndicates the tax scheme that applies. Specify VOEC for the EU.
ioss_member_state_of_identificationSpecify the member state country where the IOSS number is registered.
ioss_registration_numberSpecify the IOSS number, if any, that will be used by sellers in this region. For example, you can use it to assign an IOSS number to your sellers who are based in Great Britain (GB).

For example:

{
     "settings": [
          {
               "value": {
                    "taxation": 
                    "regions": {
                         "EU": {
                              "taxation": {
                                   "physical": {
                                        "special_tax_registration": "IOSS",
                                        "ioss_member_state_of_identification": "HU",
                                        "ioss_registration_number": "ABC12345",
                                   }
                              }
                         }
                    }
               }
          }
     ],
}
'

Marketplace Country and Subdivision Settings

For the Marketplaces country setting, you need to ensure that the taxation.physical.is_seller_registered setting is set for the subdivision.

For country subdivisions, you need to ensure that the taxation.is_enabled setting is set for the subdivision.

For example:

{
     "settings": [
          {
               "value": {
                    "countries": {
                         "GB": {
                              "is_domestic": true,
                              "taxation": {
                                   "physical": {
                                        "is_seller_registered": true
                                   }
                              },
                              "country_subdivisions": {
                                   "NI": {
                                        "taxation": {
                                             "is_enabled": true
                                        }
                                   }
                              }
                         }
                    },
                    "regions": {
                         "EU": {
                              "taxation": {
                                   "physical": {
                                        "special_tax_registration": "IOSS",
                                        "ioss_member_state_of_identification": "HU",
                                        "ioss_registration_number": "ABC12345",
                                   }
                              }
                         }
                    }
               }
          }
     ],
}

Seller Regional Settings

You need to specify values for the following fields in the seller's regional settings:

FieldDescription
physical.ioss_member_state_of_identificationThe country of registration for the IOSS number.
physical.ioss_registration_numberThe IOSS number that the seller can use in this region.

For example:

"regions": {
                         "EU": {
                              "taxation": {
                                   "physical": {
                                        "is_seller_located_within_region": true,
                                        "ioss_member_state_of_identification": "FR",
                                        "ioss_registration_number": "FRU454949",
                                   },