Accounttax

For a list of methods for this resource, see the end of this page.

Resource representations

The tax settings of a merchant account.

JSON

{
  "kind": "content#accountTax",
  "accountId": unsigned long,
  "rules": [
    {
      "country": string,
      "locationId": unsigned long,
      "useGlobalRate": boolean,
      "ratePercent": string,
      "shippingTaxed": boolean
    }
  ]
}
Property name Value Description Notes
accountId unsigned long The ID of the account to which these account tax settings belong.
kind string Identifies what kind of resource this is. Value: the fixed string "content#accountTax".
rules[] list Tax rules. Updating the tax rules will enable US taxes (not reversible). Defining no rules is equivalent to not charging tax at all. writable
rules[].country string Country code in which tax is applicable. writable
rules[].locationId unsigned long State (or province) is which the tax is applicable, described by its location id (also called criteria id). writable
rules[].ratePercent string Explicit tax rate in percent, represented as a floating point number without the percentage character. Must not be negative. writable
rules[].shippingTaxed boolean If true, shipping charges are also taxed. writable
rules[].useGlobalRate boolean Whether the tax rate is taken from a global tax table or specified explicitly. writable

XML

<account_tax>
  <account_id>
    unsigned long
  </account_id>
  <rules>
    (foreach)
      <rule>
        <country>
          string
        </country>
        <location_id>
          unsigned long
        </location_id>
        <use_global_rate>
          boolean
        </use_global_rate>
        <rate_percent>
          string
        </rate_percent>
        <shipping_taxed>
          boolean
        </shipping_taxed>
      </rule>
    (/foreach)
  </rules>
</account_tax>
Property name Value Description Notes
account_tax object The tax settings of a merchant account.
account_tax/account_id unsigned long The ID of the account to which these account tax settings belong.
account_tax/rules object
account_tax/rules/rule object Tax rules. Updating the tax rules will enable US taxes (not reversible). Defining no rules is equivalent to not charging tax at all. Tax calculation rule to apply in a state or province (USA only). writable
account_tax/rules/rule/country string Country code in which tax is applicable. writable
account_tax/rules/rule/location_id unsigned long State (or province) is which the tax is applicable, described by its location id (also called criteria id). writable
account_tax/rules/rule/rate_percent string Explicit tax rate in percent, represented as a floating point number without the percentage character. Must not be negative. writable
account_tax/rules/rule/shipping_taxed boolean If true, shipping charges are also taxed. writable
account_tax/rules/rule/use_global_rate boolean Whether the tax rate is taken from a global tax table or specified explicitly. writable

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.
patch
Updates the tax settings of the account. This method supports patch semantics.
update
Updates the tax settings of the account.

Send feedback about...

Content API for Shopping