eBay · Schema

SalesTax

This type is used to provide sales tax settings for a specific tax jurisdiction.

AuctionsCommerceProductsMarketplaceFortune 500

Properties

Name Type Description
countryCode string The country code enumeration value identifies the country to which this sales tax rate applies.

Note: Sales-tax tables are available only for the US and Canada ma
salesTaxJurisdictionId string A unique ID that identifies the sales tax jurisdiction to which the sales tax rate applies.

Note: When the returned countryCode is US, t
salesTaxPercentage string The sales tax rate that will be applied to sales price. The shippingAndHandlingTaxed value will indicate whether or not sales tax is also applied to shipping and handling charges

Althoug
shippingAndHandlingTaxed boolean If returned as true, sales tax is also applied to shipping and handling charges, and not just the total sales price of the order.
View JSON Schema on GitHub

JSON Schema

ebay-salestax-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/SalesTax",
  "title": "SalesTax",
  "type": "object",
  "properties": {
    "countryCode": {
      "type": "string",
      "description": "The country code enumeration value identifies the country to which this sales tax rate applies.<br><br><span class=\"tablenote\"><b>Note:</b> Sales-tax tables are available only for the US and Canada marketplaces. Therefore, the only supported values are:<ul><li><code>US</code></li><li><code>CA</code></li></ul></span> For implementation help, refer to <a href='https://developer.ebay.com/api-docs/sell/account/types/ba:CountryCodeEnum'>eBay API documentation</a>"
    },
    "salesTaxJurisdictionId": {
      "type": "string",
      "description": "A unique ID that identifies the sales tax jurisdiction to which the sales tax rate applies.<br><br><span class=\"tablenote\"><b>Note:</b> When the returned <code>countryCode</code> is <code>US</code>, the only supported return values for <code>salesTaxJurisdictionId</code> are:<ul><li><code>AS</code> (American Samoa)</li><li><code>GU</code> (Guam</li><li><code>MP</code> Northern Mariana Islands</li><li><code>PW (Palau)</li><li><code>VI</code> (US Virgin Islands)</li></ul></span>"
    },
    "salesTaxPercentage": {
      "type": "string",
      "description": "The sales tax rate that will be applied to sales price. The <b>shippingAndHandlingTaxed</b> value will indicate whether or not sales tax is also applied to shipping and handling charges<br><br>Although it is a string, a percentage value is returned here, such as <code>7.75</code>"
    },
    "shippingAndHandlingTaxed": {
      "type": "boolean",
      "description": "If returned as <code>true</code>, sales tax is also applied to shipping and handling charges, and not just the total sales price of the order."
    }
  },
  "description": "This type is used to provide sales tax settings for a specific tax jurisdiction."
}