Import One Stop Shop (IOSS)

Suggest Edits

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:

Field	Description
`taxation.physical.special_tax_registration`	Indicates the tax scheme that applies. Specify `VOEC` for the EU.
`ioss_member_state_of_identification`	Specify the member state country where the IOSS number is registered.
`ioss_registration_number`	Specify 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": "VOEC",
                                        "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": {
                         "EN": {
                              "is_domestic": true,
                              "taxation": {
                                   "physical": {
                                        "is_seller_registered": true
                                   }
                              },
                              "country_subdivisions": {
                                   "NI": {
                                        "taxation": {
                                             "is_enabled": true
                                        }
                                   }
                              }
                         }
                    },
                    "regions": {
                         "EU": {
                              "taxation": {
                                   "physical": {
                                        "special_tax_registration": "VOEC",
                                        "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:

Field	Description
`physical.ioss_member_state_of_identification`	The country of registration for the IOSS number.
`physical.ioss_registration_number`	The IOSS number that the seller can use in this region.

For example:

"regions": {
                         "EU": {
                              "taxation": {
                                   "digital": {
                                        "use_marketplace_as_intermediary": false,
                                        "is_taxation_enabled": true,
                                        "tax_number": "ACC234"
                                   },
                                   "physical": {
                                        "is_seller_located_within_region": true,
                                        "use_marketplace_as_intermediary": false,
                                        "ioss_member_state_of_identification": "GB",
                                        "ioss_registration_number": "GB454949",
                                   },
                                   "services": {
                                        "use_marketplace_as_intermediary": false
                                   }
                              }
                         }
                    },
                    "timezone": "GMT"
               },
               "effective_from": "1999-01-01"
          }
     ],

Updated 12 months ago