REST Resource: accounts.accounttax

Resource: AccountTax

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

JSON representation 
{
  "name": string,
  "account": string,
  "taxRules": [
    {
      object (TaxRule)
    }
  ]
}
Fields
name

string

Identifier. The name of the tax setting. Format: "{accountTax.name=accounts/{account}}"
account

string (int64 format)

Output only. The ID of the account to which these account tax settings belong.
taxRules[]

object (TaxRule)

Tax rules. "Define the tax rules in each region. No tax will be presented if a region has no rule."

TaxRule

Primary type convension

percent micro : 100% = 1 000 000 and 1% = 10 000 cannot be negative.

Information about tax nexus and related parameters applicable to orders delivered to the area covered by a single tax admin. Nexus is created when a merchant is doing business in an area administered by tax admin (only US states are supported for nexus configuration). If merchant has nexus in a US state, merchant needs to pay tax to all tax authorities associated with the shipping destination. Next Id : 8

JSON representation 
{
  "regionCode": string,
  "shippingTaxed": boolean,
  "effectiveTimePeriod": {
    object (Interval)
  },

  // Union field location can be only one of the following:
  "locationId": string,
  "postCodeRange": {
    object (TaxPostalCodeRange)
  }
  // End of list of possible types for union field location.

  // Union field rate_calculation can be only one of the following:
  "useGoogleRate": boolean,
  "selfSpecifiedRateMicros": string
  // End of list of possible types for union field rate_calculation.
}
Fields
regionCode

string

Region code in which this rule is applicable
shippingTaxed

boolean

If set, shipping charge is taxed (at the same rate as product) when delivering to this admin's area. Can only be set on US states without category.
effectiveTimePeriod

object (Interval)

Required. Time period when this rule is effective. If the duration is missing from effective_time listed, then it is open ended to the future. The start of this time period is inclusive, and the end is exclusive.
Union field location. Describe the location through either postal code range or a criteria id. location can be only one of the following:
locationId

string (int64 format)

The admin_id or criteria_id of the region in which this rule is applicable.
postCodeRange

object (TaxPostalCodeRange)

The range of postal codes in which this rule is applicable.
Union field rate_calculation. What is the way to calculate tax rate for deliveries to this admin's area. Can only be set on US states. rate_calculation can be only one of the following:
useGoogleRate

boolean

Rate that depends on delivery location: if merchant has a nexus in corresponding US state, rates from authorities with jurisdiction over delivery area are added up.
selfSpecifiedRateMicros

string (int64 format)

A fixed rate specified in micros, where 100% = 1_000_000. Suitable for origin-based states.

TaxPostalCodeRange

A range of postal codes that defines the area.

JSON representation 
{
  "start": string,
  "end": string
}
Fields
start

string

Required. The start of the postal code range, which is also the smallest in the range.
end

string

The end of the postal code range. Will be the same as start if not specified.

Methods

get

 Returns the tax rules that match the conditions of GetAccountTaxRequest

list

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

patch

 Updates the tax settings of the account.