REST Resource: accounttax

  • AccountTax resource allows management of tax settings for a merchant account, requiring admin access for all methods.

  • Tax rules can be defined for specific states/provinces within the US, impacting tax calculations for products.

  • Global tax tables or custom rates can be utilized, with options to include shipping in tax calculations.

  • Multiple methods, such as get, list, update, and custombatch, are available for managing AccountTax settings.

  • JSON representation provides structured data format for AccountTax and AccountTaxTaxRule resources, including fields like accountId, rules, country, locationId, and more.

Resource: AccountTax

The tax settings of a merchant account. All methods require the admin role.

JSON representation 
{
  "accountId": string,
  "rules": [
    {
      object (AccountTaxTaxRule)
    }
  ],
  "kind": string
}
Fields
accountId

string

Required. The ID of the account to which these account tax settings belong.
rules[]

object (AccountTaxTaxRule)

Tax rules. Updating the tax rules will enable "US" taxes (not reversible). Defining no rules is equivalent to not charging tax at all.
kind

string

Identifies what kind of resource this is. Value: the fixed string "content#accountTax".

AccountTaxTaxRule

Tax calculation rule to apply in a state or province (US only).

JSON representation 
{
  "country": string,
  "locationId": string,
  "useGlobalRate": boolean,
  "ratePercent": string,
  "shippingTaxed": boolean
}
Fields
country

string

Country code in which tax is applicable.
locationId

string

Required. State (or province) is which the tax is applicable, described by its location ID (also called criteria ID).
useGlobalRate

boolean

Whether the tax rate is taken from a global tax table or specified explicitly.
ratePercent

string

Explicit tax rate in percent, represented as a floating point number without the percentage character. Must not be negative.
shippingTaxed

boolean

If true, shipping charges are also taxed.

Methods

custombatch

 Retrieves and updates tax settings of multiple accounts in a single request.

get

 Retrieves the tax settings of the account.

list

 Lists the tax settings of the sub-accounts in your Merchant Center account.

update

 Updates the tax settings of the account.