Seller Settings - Tax

Use tax settings to model your sellers tax requirements.

The following settings are available to help model taxation for your sellers:

Regional Settings

The following tax settings can be specified at the regional level:

FieldDescription
digital.use_marketplace_as_intermediaryIf set to true, this means that the marketplace can be used as an intermediary for this seller's digital sales in this region. This can effect how tax and liability are determined.
digital.is_taxation_enabledIf set to true, this seller is permitted to sell digital goods in this region of the marketplace.
digital.tax_numberThe tax number that is used for digital goods.
physical.is_seller_located_within_regionIf set to true, this means that the seller is located in this region.
physical.use_marketplace_as_intermediaryIf set to true, this means that the marketplace can be used as an intermediary for this seller's physical goods sales in this region. This can effect how tax and liability are determined.
physical.ioss_member_state_of_identificationThe state where the IOSS number was registered. This is only used in the EU.
physical.ioss_registration_numberThe IOSS number that the seller can use in this region. This is only used in the EU.
physical.oss_member_state_of_identificationThe state where the OSS number was registered. This is only used in the EU.
physical.oss_registration_numberThe OSS number that the seller can use in this region. This is only used in the EU.
services.use_marketplace_as_intermediaryIf set to true, this means that the marketplace can be used as an intermediary for this seller's service sales like shipping in this region. This can effect how tax and liability are determined.

Country Settings

The following tax settings can be specified at the country level:

Field

Description

services.use_marketplace_as_intermediary

If set to true, this means that the marketplace can be used as an intermediary for this seller's service sales like shipping in this country. This can effect how tax and liability are determined.

physical.is_seller_registered

If set to true, this means that the seller is registered as a seller in this country. This can effect how tax and liability are determined.

physical.is_physical_tax_enabled

If set to true, this means that the seller can sell physical goods in this country.

physical.seller_tax_number

The Tax ID number that the seller uses for physical sales in this country.

physical.tax_obligation_country_code_override

You use this setting to change the tax liability assignment for physical goods sold by the seller in this country. You can set it to any of the following:

  • seller_country: Liability is assigned to the seller's country.
  • ship_from: Liability is assigned to the country that the goods are shipped from
  • country_code: Liability is assigned to the specified country code. For example, IE for Ireland.
has_physical_presenceIf set to true, it indicates that the seller has a physical presence in this country.

Country Subdivision Settings

The following seller's settings are available for the seller's country subdivisions:

FieldDescription
has_physical_presenceIf set to true, it indicates that the seller has a physical presence in this subdivision.
is_enabledIf set to true, this means that taxation is enabled for the seller in this country subdivision.
seller_tax_numberThe seller's Tax ID for this subdivision.
digital.is_seller_registeredIndicates whether the seller is registered as a tax collector for digital goods in the country subdivision.
digital.seller_tax_numberThe seller's Tax ID that is used for digital goods.
digital.use_marketplace_as_intermediaryIf set to true, this means that the marketplace can be used as an intermediary for this seller's digital goods in this country subdivision. This can affect how tax and liability are determined.
physical.is_seller_registeredIndicates whether the seller is registered and can be liable for tax for physical goods in the country subdivision.
physical.seller_tax_numberThe seller's Tax ID that is used for physical goods.
physical.use_marketplace_as_intermediaryIf set to true, this means that the marketplace can be used as an intermediary for this seller's physical goods in this country subdivision. This can affect how tax and liability are determined.

For example:

{
     "settings": [
          {
                    "countries": {
                         "DE": {
                              "is_domestic": false,
                              "taxation": {
                                   "services": {
                                        "use_marketplace_as_intermediary": true
                                   },
                                   "physical": {
                                        "is_seller_registered": true,
                                        "is_physical_tax_enabled": true,
                                        "seller_tax_number": "DE456778",
                                        "tax_obligation_country_code_override": "DE"
                                   }
                              },
                              "country_subdivisions": {
                                   "BWB": {
                                        "taxation": {
                                             "is_enabled": true,
                                             "physical": {
                                                  "use_marketplace_as_intermediary": true
                                             }
                                        }
                                   }
                              }
                         }
                    },
                    "regions": {
                         "EU": {
                              "taxation": {
                                   "physical": {
                                        "is_seller_located_within_region": true,
                                        "use_marketplace_as_intermediary": false,
                                        "ioss_member_state_of_identification": "GB",
                                        "ioss_registration_number": "GB454949",
                                        "oss_member_state_of_identification": "FR",
                                        "oss_registration_number": "FR458686"
                                   },
                                   "services": {
                                        "use_marketplace_as_intermediary": false
                                   }
                              }
                         }
                    },
                    "timezone": "GMT"
               },
               "effective_from": "1999-01-01"
          }
     ],
     "country": "IE",
     "postal_code": "XC12134",
     "business_name": "Test Widgets",
     "email": "[email protected]",
     "postal_address_line3": "Building 5",
     "postal_address_line2": "Main Street",
     "last_name": "Murphy",
     "first_name": "Audey",
     "seller_code": "XCV123",
     "postal_address_line1": "Wessex Town",
     "middle_name": "Humphrey"
}
'