概要

ZuoraはProduct Rate Plan ChargeのTax Codeと顧客のBill To住所を組み合わせ、Bill Run時に自動で税計算します。内部・外部エンジンの使い分けとExempt・Tax Modeの設定を理解することで、グローバルな税務設計ができるようになります。

全体フロー — オブジェクトとアクションの関係：

税計算の基本設計 — Tax Code・Tax Rule・Tax Rate

Tax CodeはChargeに設定する商品分類タグです。Tax RuleはそのタグとBill To住所の組み合わせで税率を決める変換ルールになります。

Zuoraの税計算は「何を売るか（Tax Code）」×「どこに売るか（住所）」の2軸で決まります。

Tax Codeの設定場所：

Product
  └── Product Rate Plan
        └── Product Rate Plan Charge  ← ここにTax Codeを設定
              └── Subscription作成時にRate Plan Chargeへ引き継がれる

Tax RuleはTax Codeと管轄地域の中間テーブル：

Tax Ruleの例：

Zuora内部税計算エンジン

Bill Run時にZuoraがTax Code×管轄地域を自動照合し、Taxation Itemを生成します。税計算の実行はBill Runのタイミングです。

計算が実行されるタイミング

Zuoraの税計算はOrderやSubscription作成時ではなく、Bill Runの実行時に行われます。Chargeに設定されたTax Codeは「タグ」として保存されているだけで、Bill Runが走るまで税額は確定しません。

内部エンジンの処理ステップ

内部エンジンが向いているケース

外部税計算エンジンとの連携

複雑な税管轄や税率の自動更新への対応のため、ZuoraはTax Codeと住所を外部エンジンに送り税額を受け取るハブとして機能します。

なぜ外部エンジンが必要か

Zuoraの内部エンジンはTax Ruleを運用担当者が手動管理します。しかし以下のケースでは現実的ではなくなります。

主な外部税計算エンジン

連携の仕組み

ZuoraはBill Run時に外部エンジンへAPIリクエストを送り、税額の計算結果だけを受け取ります。税のロジックはすべて外部エンジン側に委ねます。

外部エンジン使用時のTax Code

内部エンジンでは自由に命名できたTax Codeが、外部エンジンでは外部システムのコード体系に合わせる必要があります。

後からグローバル対応する場合の移行コスト

内部エンジンから外部エンジンへの移行は、全ChargeのTax Codeを付け替える作業が発生します。

移行時の作業：

1. 既存Tax Code → 外部エンジンコードのマッピング表を作成
2. Product Rate Plan Charge全件のTax Codeを更新
3. Tax Ruleを内部設定から外部エンジン設定に切り替え
4. テスト環境でBill Runを実行して税額を検証

Taxation ItemとExempt設定

Taxation ItemはBill Run時に生成される税明細オブジェクトです。AccountまたはChargeレベルで事前に非課税設定できます。

Taxation Itemの構造

Bill Runが実行されると、課税対象のInvoice ItemごとにTaxation Itemが生成されます。税計算の結果を記録するオブジェクトです。

Exempt（非課税）設定

特定の顧客や商品を税免除にしたい場合、Bill Run前にExemptをAccountまたはChargeに設定しておきます。

Taxation Itemへの操作

税モード — ExclusiveとInclusive

ExclusiveはChargeの金額に税を上乗せし（デフォルト）、Inclusiveは税込み価格から税額を内訳として分離します。

2つの税モードの違い

同じ税率でも、Chargeに設定する金額の意味が変わります。

数値例（Tax Rate = 10%）：

どちらを使うか