Resource: AccountTax
The tax settings of a merchant account. All methods require the admin role.
JSON representation |
---|
{
"name": string,
"account": string,
"taxRules": [
{
object ( |
Fields | |
---|---|
name |
Identifier. The name of the tax setting. Format: "{accountTax.name=accounts/{account}}" |
account |
Output only. The ID of the account to which these account tax settings belong. |
taxRules[] |
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 ( |
Fields | |
---|---|
regionCode |
Region code in which this rule is applicable |
shippingTaxed |
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 |
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 |
The admin_id or criteria_id of the region in which this rule is applicable. |
postCodeRange |
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 |
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 |
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 |
Required. The start of the postal code range, which is also the smallest in the range. |
end |
The end of the postal code range. Will be the same as start if not specified. |
Methods |
|
---|---|
|
Returns the tax rules that match the conditions of GetAccountTaxRequest |
|
Lists the tax settings of the sub-accounts only in your Merchant Center account. |
|
Updates the tax settings of the account. |