account APIv1.4.0

createOrReplaceSalesTax

PUT
/sales_tax/{countryCode}/{jurisdictionId}
This method creates or updates a sales tax table entry for a jurisdiction. Specify the tax table entry you want to configure using the two path parameters: countryCode and jurisdictionId.

A tax table entry for a jurisdiction is comprised of two fields: one for the jurisdiction's sales-tax rate and another that's a boolean value indicating whether or not shipping and handling are taxed in the jurisdiction.

You can set up tax tables for countries that support different tax jurisdictions. Currently, only Canada, India, and the US support separate tax jurisdictions. If you sell into any of these countries, you can set up tax tables for any of the country's jurisdictions. Retrieve valid jurisdiction IDs using getSalesTaxJurisdictions in the Metadata API.

For details on using this call, see Establishing sales-tax tables.

Important! Starting in January 2019, eBay will begin to calculate, collect, and remit sales tax on behalf of sellers for items shipped to customers. This feature is rolling out on specific dates to specific US states as defined on the following page: eBay sales tax collection.

Once eBay starts to collect sales tax for a state, no action is required on the seller's part and there will be no charges or fees for eBay automatically calculating, collecting and remitting sales tax. The sales-tax collection process will apply to all the sales in the states that support this feature, whether the seller is located in or outside of the United States.

When a buyer purchases an item on eBay, and the ship-to address is one of the states where eBay collects the sales tax, eBay will calculate and add the applicable sales tax at checkout. The buyer will pay both the cost of the item along with the sales tax. eBay will collect and remit the tax.

Input

Resource URI (production)

PUT https://api.ebay.com/sell/account/v1/sales_tax/{countryCode}/{jurisdictionId}

URI parameters

ParameterTypeDescription
jurisdictionIdstringThis path parameter specifies the ID of the sales-tax jurisdiction for the table entry you want to create.

Occurrence: Required

countryCodeCountryCodeEnumThis path parameter specifies the two-letter ISO 3166-1 Alpha-2 code for the country for which you want to create tax table entry.

Occurrence: Required

HTTP request headers

All requests made to eBay REST operations require you to provide the Authorization HTTP header for authentication authorization.

OAuth scope

This request requires an access token created with the authorization code grant flow, using one or more scopes from the following list (please check your Application Keys page for a list of OAuth scopes available to your application):

https://api.ebay.com/oauth/api_scope/sell.account

See OAuth access tokens for more information.

Input container/fieldTypeDescription
salesTaxPercentagestringThe sales tax rate, as a percentage of the sale.

Occurrence: Required

shippingAndHandlingTaxedbooleanIf set to true, shipping and handling charges are taxed.

Occurrence: Required

Output

HTTP response headers

HTTP status codes

This call can return one of the following HTTP status codes. For an overview of the status codes, see HTTP status codes in Using eBay RESTful APIs.

StatusMeaning
204No Content
400Bad Request
404Not Found
500Internal Server Error

Error codes

For more on errors, plus the codes of other common errors, see Handling errors.

CodeDomainCategoryMeaning
20400API_ACCOUNTREQUESTInvalid request. {additionalInfo}
20401API_ACCOUNTREQUESTMissing field {fieldName}. {additionalInfo}
20403API_ACCOUNTREQUESTInvalid {fieldName}. {additionalInfo}
20404API_ACCOUNTREQUEST{fieldName} not found.
20407API_ACCOUNTREQUESTTax table not supported for {fieldName}.
20500API_ACCOUNTAPPLICATIONSystem error.

Samples

New to making API calls? Please see Making a Call.

Note: Identifiers, such as order IDs or user IDs, and personal data in these samples might be anonymized or may no longer be active on eBay. If necessary, substitute current, relevant eBay data in your requests.

Sample 1: Create or update a sales tax table entry

This call creates or updates a sales tax table entry for the specified country and sales tax jurisdiction.

Input

This example sets the sales tax table entry for New York, a sales tax jurisdiction in the United States.
PUT
https://api.sandbox.ebay.com/sell/account/v1/sales_tax/US/NY

Output

A successful call returns the HTTP status code 204 No content.