Steuerdaten abfragen

Stripe Tax-Daten umfassen verschiedene Komponenten, die zusammenarbeiten, um durch automatisierte Berechnungen mit Payment Links, Checkout, Abonnements, Rechnungen, nutzerdefinierten Integrationen und als Plattform umfassenden Überblick über Ihre Steuerpflicht zu bieten. Alle steuerspezifischen Daten sind im Abschnitt Steuern des Systems verfügbar, und die primäre Tabelle ist tax_transactions.

Um Steuerdaten genauer zu untersuchen, können Sie zusätzliche Tabellen verwenden, die die Komponenten einer tax_transaction wie tax_transaction_line_items, tax_transaction_shipping_costs und tax_transaction_jurisdiction_details darstellen.

Dieses Diagramm stellt alle Komponenten dar, die während einer automatisierten Steuerberechnung erstellt wurden, und wie sie sich auf das ursprüngliche Objekt beziehen, das die Berechnung ausgelöst hat. Die Beträge in den folgenden Beispielen werden in untergeordneten Währungseinheiten angezeigt (zum Beispiel Cent anstelle von Dollar).

Steuertransaktionen

Jede Zeile in dertax_transactions-Tabelle repräsentiert ein einzelnes tax_transaction-Objekt. Steuertransaktionen erfassen die übernommene oder reduzierte Steuerschuld für eine Transaktion oder Stornierung. Sie können über jede Steuertransaktion berichten, die mit automatisierten Steuerberechnungen erstellt wurde.

Diese Tabelle ist der empfohlene Ausgangspunkt für die Erstellung von Berichten über Ihre Steuerpflicht. Sie müssen Ihre Steuerschuldbeträge in den anderen Steuertabellen unten eintragen, aber diese Tabelle verbindet Ihre Daten mit anderen Produkten wie Rechnungen und Checkout-Sitzungen. Durch die Verknüpfung mit Nicht-Steuertabellen nach source_id und source_type wird das Objekt bereitgestellt, das die Erstellung der Steuertransaktion auslöst.

Steuertransaktionen haben ein Eins-zu-Eins-Verhältnis zu ihrem ursprünglichen Quellobjekt. Das folgende Beispiel ruft eine Liste von berichtspflichtigen Steuertransaktionen mit ihrer ursprünglichen Rechnungsquelle ab, die Sie dann mit abgefragten Abrechnungsdaten erweitern könne.

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

Metadaten für Steuertransaktion

Steuertransaktionen können Metadaten enthalten, die mit Ihren benutzerdefinierten Integrationen festgelegt wurden. Jede Zeile in tax_transactions_metadata gibt ein Schlüssel-Wert-Paar zurück.

Steuertransaktionsposten

Steuerposten und Steuerversandkosten setzen sich aus den Gesamtbeträgen und der Steuerschuld für Steuertransaktionen zusammen. Steuerposten und Steuerversandkosten befinden sich in ihren eigenen Tabellen, aber sie tragen beide zu den Beträgen und der gesamten Steuerschuld bei.

Steuerposten

Steuerposten stellen Posten dar, die zum Verkauf von Waren für die Transaktion beitragen. Jede Zeile in tax_transaction_line_items stellt einen einzelnen Steuerposten dar, der der tax_transaction zugeordnet ist.

Steuern für Versandkosten

Steuern für Versandkosten stellen Versandposten dar, die zum Versand von Waren für die Transaktion beitragen. Jede Zeile in tax_transaction_shipping_costs stellt einen einzelnen Steuerposten dar, der der tax_transaction zugeordnet ist.

Das folgende Beispiel ruft eine Liste aller Beträge und Steuerschulden für eine bestimmte tax_transaction ab.

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'

Metadaten der Steuertransaktionsposten

Steuertransaktionspositionen können Metadaten enthalten, die mit Ihren benutzerdefinierten Integrationen festgelegt wurden. Jede Zeile in tax_transaction_line_items_metadata gibt ein Schlüssel-Wert-Paar zurück.

Zuständigkeitsdetails für Steuertransaktionen

Jede Zeile in der Tabelle tax_transaction_jurisdiction_details stellt einen Zuständigkeitsbereich dar, der die Haftung für den Steuertransaktionsposten (tax_transaction_line_item oder tax_transaction_shipping_cost) ausmacht.

Informationen zum Zuständigkeitsbereich

Diese Tabelle enthält detailliertere Informationen zu den einzelnen Zuständigkeitsbereichen. Ein einzelner Steuertransaktionsposten kann mehrere Zuständigkeitsbereiche haben, aus denen sich die Beträge für einen Steuertransaktionsposten zusammensetzen.

Die Summe von amount_taxable oder amount_non_taxable in allen Zuständigkeitsbereichen entspricht nicht immer dem amount der Steuertransaktion.

amount_taxable: Dies ist der Betrag bis zur Höhe des zu versteuernden amount des Steuertransaktionspostens. Mehrere Zuständigkeitsbereiche können denselben zu versteuernden Betrag haben.

amount_non_taxable: Dies ist der Betrag bis zur Höhe des zu nicht steuerpflichtigen amount des Steuertransaktionspostens. Mehrere Zuständigkeitsbereiche können denselben nicht steuerpflichtigen Betrag haben.

amount_tax: Dies ist Teil des Steuertransaktionspostens amount_tax. Wenn Sie dies über die Details aller Zuständigkeitsbereiche hinweg summieren, entspricht dies dem amount_tax des Transaktionspostens.

Währung: Dies ist die Transaktionswährung, die amount_taxable, amount_non_taxable und amount_tax definiert. Das Summieren über verschiedene Währungen führt zu unerwarteten Ergebnissen.

filing_currency: Dies ist die von der zuständigen Steuerbehörde verwendete Einreichungswährung, die filing_amount_taxable, filing_amount_non_taxable und filing_amount_tax definiert. Das Summieren über verschiedenen Einreichungswährungen führt zu unerwarteten Ergebnissen.

Das folgende Beispiel ruft alle Zuständigkeitsbereichsdetails für einen bestimmten Steuertransaktionsposten ab.

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'

Beispielabfragen

Weitere finden Sie im Abschnitt „Steuern“ der Abfragevorlagenbibliothek in der Sigma-Seitenleiste.

Steuerschuld nach Monat

In diesem Beispiel werden die auf Einzelposten erhobenen Steuerschulden und Versandkosten nach Monat und Währung zusammengefasst.

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(
      (

Zuständigkeitsdetails für Steuerzuständigkeitsbereiche

In dieser Vorlage werden die Details der Steuerzuständigkeitsbereiche für den Vormonat aufgeführt, um eine anpassbare Version des Steuerexports mit Einzelaufstellungen zu erstellen. Überprüfen Sie die Kommentare in der gesamten Vorlage, um mehr darüber zu erfahren, wie sie an Ihre Bedürfnisse angepasst werden kann.

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