REST Resource: accounts.accounttax

資源:AccountTax

商家帳戶的稅金設定。所有方法都需要管理員角色。

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

string

ID。稅金設定的名稱。格式:「{accountTax.name=accounts/{account}}」

account

string (int64 format)

僅供輸出。這些帳戶稅金設定所屬的帳戶 ID。

taxRules[]

object (TaxRule)

稅則規定。「定義各地區的稅務規定。如果沒有設定規則的區域,就不會顯示任何稅金。

TaxRule

主要類型會議

微量百分比:100% = 1 000 000 和 1% = 10,000 不得為負數。

課稅關聯資訊和相關參數 (適用於送往單一稅務管理區域的訂單)。當商家在稅務管理員管理的領域內經營業務時,系統就會建立 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)

必要欄位。這項規則的生效時間範圍。如果在清單所列的 Effective_time 中缺少時間長度,則會設為開放到未來。這段期間的開始時間不含時間值,但不包括結束時間。

聯集欄位 location。透過郵遞區號範圍或條件 ID 描述地區。location 只能是下列其中一項:
locationId

string (int64 format)

適用此規則地區的 admin_id 或 requirements_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 條件相符的稅務規則

list

系統只會在 Merchant Center 帳戶中列出子帳戶的稅金設定。

patch

更新帳戶的稅金設定。