Tax データをクエリする

Stripe Tax のデータには、Payment Links、Checkout、Subscription、Invoice、カスタムの実装、プラットフォーム利用の連携による自動計算でおおまかな税額を提供するさまざまなコンポーネントが含まれています。税金固有のデータはすべてスキーマの税金セクションで利用できます。プライマリーテーブルは tax_transactions です。

税金データを詳しく調べたい場合、tax_transaction_line_items、tax_transaction_shipping_costs、tax_transaction_jurisdiction_details など、tax_transaction のコンポーネントを表すその他のテーブルも使用することができます。

この図は、税金の自動計算中に作成されるすべてのコンポーネントと、計算をトリガーした元のオブジェクトとの関係を示しています。この例に示されている金額は、補助通貨単位で表示されています (ドルではなくセントなど)。

税取引

tax_transactions テーブルの各行は 1 つの tax_transaction オブジェクトで表されます。Tax transaction は、取引または差戻しに対する見積税額または減額後の税額を記録します。自動税金計算で作成されたすべての税取引について報告することが可能です。

税額のレポートを作成する際には、この表を起点にして作成することをお勧めします。税額を確認するには以下の税金表と結合させる必要がありますが、この表は Invoice や Checkout セッションのような他の製品とデータを結びつけます。 source_id と source_type を使用して非課税表に結合すると、税取引の作成をトリガーするオブジェクトが返されます。

税取引は、元の Source オブジェクトと 1 対 1 の関係があります。以下の例は、申告対象の税取引と請求書の元のソースのリストを取得しています。これは、請求データのクエリで拡張することが可能です。

select
  tx.id as tax_transaction_id,
  tx.posted_at as tax_transaction_posted_at,
  inv.id as invoice_id,
  inv.total as invoice_total
from
  tax_transactions tx
  inner join invoices inv on inv.id = tx.source_id
limit
  5

税取引のメタデータ

税取引には、カスタムの実装で設定したメタデータが含まれる場合があります。tax_transactions_metadata の各行には、1 組のキーと値のペアが返されます。

税取引アイテム

税金のラインアイテムと税送料は、税取引の合計金額と税額を構成します。税金のラインアイテムと税送料はそれぞれのテーブルにありますが、どちらも金額と合計税額を構成します。

税金のラインアイテム

税金のラインアイテムは、商品の販売に関係するラインアイテムを表します。tax_transaction_line_items の各行は、tax_transaction に関連付けられた単一の税金のラインアイテムで表されます。

税送料

税送料は、商品の配送に関係する配送アイテムを表します。tax_transaction_shipping_costs の各行は、tax_transaction に関連付けられた単一の配送料で表されます。

以下の例では、tax_transaction のすべての金額と税額のリストを取得しています。

with tax_amounts as (
  select
    li.tax_transaction_id,
    li.id,
    li.amount,
    li.amount_tax,
    li.tax_behavior,
    li.currency,
    'line_item' as item_type
  from
    tax_transaction_line_items li
  union all
  select
    sc.tax_transaction_id,
    sc.id,
    sc.amount,
    sc.amount_tax,
    sc.tax_behavior,
    sc.currency,
    'shipping_cost' as item_type
  from
    tax_transaction_shipping_costs sc
)
select
  id,
  amount,
  amount_tax,
  tax_behavior,
  currency,
  item_type
from
  tax_amounts
where
  tax_transaction_id = 'tax_d2e5470dC63u'

税取引のラインアイテムのメタデータ

税取引のラインアイテムには、カスタムの実装で設定したメタデータが含まれる場合があります。tax_transaction_line_items_metadata の各行には、1 組のキーと値のペアが返されます。

税取引管轄区域情報

tax_transaction_jurisdiction_details テーブルの各行は、税取引アイテム (tax_transaction_line_item または tax_transaction_shipping_cost) を納める管轄区域を表します 。

管轄区域情報について

このテーブルは、各管轄区域についての詳細な情報を提供するものです。1 つの税取引アイテムに、税取引アイテムの金額を納める管轄区域を複数設定することができます。

すべての管轄区域にわたって amount_taxable または amount_non_taxable を合計しても、税取引アイテムの amount と等しくなるとは限りません。

amount_taxable: 税取引アイテムの amount までの金額であり、課税対象となります。複数の管轄区域で同じ課税額を設定できます。

amount_non_taxable: 税取引アイテムの amount までの金額であり、非課税対象となります。複数の管轄区域で同じ非課税額を設定できます。

amount_tax: 税取引アイテム amount_tax の一部です。すべての管轄区域でこれを合計すると、税取引アイテムの amount_tax になります。

currency: amount_taxable、amount_non_taxable、amount_tax を定義する取引通貨です。異なる種類の通貨を合計すると、予期しない結果が生じます。

filing_currency: 管轄の税務局が使用し、filing_amount_taxable、filing_amount_non_taxable、filing_amount_tax を定義する申告通貨です。異なる種類の通貨を合計すると、予期しない結果が生じます。

次の例では、税取引アイテムのすべての管轄区域情報を取得しています。

select
  jd.amount_taxable,
  jd.amount_non_taxable,
  jd.amount_tax,
  jd.taxability_reason,
  jd.jurisdiction_level,
  jd.jurisdiction_name,
  concat(jd.jurisdiction_country, '-', jd.jurisdiction_state) as jurisdiction_location
from
  tax_transaction_jurisdiction_details jd
where
  li.id = 'tax_li_52d37cdd6f7'

クエリ例

その他の例については、Sigma サイドバーのクエリテンプレートライブラリの税金セクションをご覧ください。

月別の仮受消費税

この例では、ラインアイテムと送料に課される税額を、月別および通貨別にまとめています。

with tax_amounts as (
  select
    li.tax_transaction_id,
    li.amount,
    li.amount_tax,
    li.tax_behavior,
    li.currency
  from
    tax_transaction_line_items li
  union all
  select
    sc.tax_transaction_id,
    sc.amount,
    sc.amount_tax,
    sc.tax_behavior,
    sc.currency
  from
    tax_transaction_shipping_costs sc
),
tax_liability as (
  select
    date_format(date_trunc('month', posted_at), '%Y-%m-%d') as month,
    currency as presentment_currency,
    sum(
      (

税金アイテム別の管轄区域情報

このテンプレートは、前月の税取引の管轄区域情報をアイテム別に分け、カスタマイズ可能なアイテム別エクスポートを生成します。テンプレートのコメントをすべてご確認の上、ニーズに合わせたカスタマイズの方法をご覧ください。

with tax_amounts as (
  select
    li.id,
    li.source_line_item_id,
    li.amount,
    li.amount_tax,
    li.tax_behavior,
    li.tax_code,
    li.currency,
    li.quantity_decimal
  from
    tax_transaction_line_items li
  union all
  select
    sc.id,
    -- Shipping costs do not have source line item IDs
    '' as source_line_item_id,
    sc.amount,
    sc.amount_tax,
    sc.tax_behavior,
    sc.tax_code,
    sc.currency,
    -- Shipping costs do not have a quantity
    '' as quantity_decimal
  from