REST Resource: accounts.accounttax

资源:AccountTax

商家账号的税费设置。所有方法都需要管理员角色。

JSON 表示法
{
  "name": string,
  "account": string,
  "taxRules": [
    {
      object (TaxRule)
    }
  ]
}
字段
name

string

标识符。税费设置的名称。格式:“{accountTax.name=accounts/{account}}”

account

string (int64 format)

仅限输出。这些账号税费设置所属的账号的 ID。

taxRules[]

object (TaxRule)

税务规则。"定义每个地区的税务规则。如果某个地区没有规则,就不会显示税费。”

TaxRule

主要类型会议

微百分比 : 100% = 1 000 000 和 1% = 10 000 不能为负数。

有关税务关系和相关参数的信息,适用于配送到某位税务管理员所涵盖地区的订单。当商家在税务管理员所管理的区域开展业务时,系统会创建 Nexus 设备(Nexus 配置仅支持美国各州)。如果商家在美国有实体存在,则商家需要向与送货目的地相关联的所有税务机关支付税费。下一个 ID :8

JSON 表示法
{
  "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.
}
字段
regionCode

string

此规则适用的地区代码

shippingTaxed

boolean

如果设置,则在配送到此管理员所在的区域时,将对运费收税(与商品费率相同)。只能针对没有类别的美国州进行设置。

effectiveTimePeriod

object (Interval)

必需。此规则生效的时间段。如果有效的时间中缺少持续时间,则该持续时间为将来开放。此时间段的开始时间含边界值,结束时间不含边界值。

联合字段 location。通过邮政编码范围或条件 ID 描述地理位置。location 只能是下列其中一项:
locationId

string (int64 format)

此规则适用的地区的 admin_id 或 criteria_id。

postCodeRange

object (TaxPostalCodeRange)

此规则适用的邮政编码范围。

联合字段 rate_calculation。使用什么方法计算配送到此管理员所在区域的税率?只能针对美国各州进行设置。rate_calculation 只能是下列其中一项:
useGoogleRate

boolean

运费取决于送货地点:如果商家在美国相应州有实体存在,则对送货区域有管辖权的机构出具的费率会累加。

selfSpecifiedRateMicros

string (int64 format)

以微单位指定的固定费率,其中 100% = 1_000_000。适用于基于来源的州。

TaxPostalCodeRange

用于定义区域的邮政编码范围。

JSON 表示法
{
  "start": string,
  "end": string
}
字段
start

string

必需。邮政编码范围的起点,也是范围内的最小值。

end

string

邮政编码范围的末尾。如果未指定,则与 start 相同。

方法

get

返回与 GetAccountTaxRequest 的条件匹配的税费规则

patch

更新账号的税费设置。