Interroger les données fiscales

Les données de Stripe Tax comprennent divers composants qui fonctionnent ensemble pour fournir une vue complète de votre responsabilité fiscale à travers des calculs automatisés avec Payment Links, Checkout, Subscriptions, Invoices, les intégrations personnalisées et en tant que plateforme. Toutes les données spécifiques aux taxes sont disponibles dans la section Tax du schéma, et la table primaire est tax_transactions.

Pour explorer davantage les données fiscales, vous pouvez utiliser des tables supplémentaires qui représentent les composants d’un tax_transaction, tels que tax_transaction_line_items, tax_transaction_shipping_costs et tax_transaction_jurisdiction_details.

Ce diagramme représente tous les composants créés au cours d’un calcul automatisé de la taxe et la manière dont ils sont liés à l’objet d’origine qui a déclenché le calcul. Dans les exemples ci-dessous, les montants sont exprimés en unités monétaires mineures (par exemple, en cents au lieu de dollars).

Transactions fiscales

Chaque ligne de la table tax_transactions représente un objet tax_transaction unique. Les transactions fiscales enregistrent la dette fiscale supposée ou réduite pour une transaction ou une annulation. Vous pouvez établir un rapport sur chaque transaction fiscale créée à l’aide de calculs automatisés de la taxe.

Ce tableau est le point de départ recommandé pour la création de rapports sur la dette fiscale. Vous devez faire la jonction avec les autres tables de taxation ci-dessous pour obtenir les montants de votre dette fiscale, mais cette table relie vos données à d’autres produits tels que les factures et les sessions Checkout. La jonction avec des tables autres que les tables de taxation par source_id et source_type fournit l’objet qui déclenche la création de la transaction fiscale.

Les transactions fiscales ont une relation univoque avec leur objet source d’origine. L’exemple suivant permet de récupérer une liste de transactions fiscales à déclarer avec leur source d’origine, les factures, que vous pouvez ensuite compléter avec des données Billing.

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

Métadonnées des transactions fiscales

Les transactions fiscales peuvent avoir des métadonnées définies par vos intégrations personnalisées. Chaque ligne de tax_transactions_metadata renvoie une paire clé-valeur.

Postes de transaction fiscale

Les postes de taxe et les frais d’expédition taxables constituent les montants totaux et la dette fiscale pour les transactions fiscales. Les postes de taxe et les frais d’expédition taxables se trouvent dans des tableaux distincts, mais ils contribuent tous deux aux montants et à la dette fiscale totale.

Postes de taxe

Les postes de taxe représentent les postes qui contribuent à la vente de biens pour la transaction. Chaque ligne de tax_transaction_line_items représente un poste de taxe unique associé à tax_transaction.

Frais d’expédition taxables

Les frais de livraison taxables représentent des postes de livraison qui contribuent à l’envoi des marchandises pour la transaction. Chaque ligne de tax_transaction_shipping_costs représente un seul coût de livraison associé à tax_transaction.

L’exemple suivant permet d’obtenir une liste de tous les montants et de la dette fiscale pour un tax_transaction donné.

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'

Métadonnées des postes de transaction fiscale

Les postes de transaction fiscale peuvent avoir des métadonnées définies dans le cadre de vos intégrations personnalisées. Chaque ligne de tax_transaction_line_items_metadata renvoie une paire clé-valeur.

Informations concernant le territoire de la transaction fiscale

Chaque ligne de la table tax_transaction_jurisdiction_details représente un territoire qui est responsable du poste de transaction fiscale (tax_transaction_line_item ou tax_transaction_shipping_cost).

Comprendre les informations concernant le territoire

Ce tableau fournit des informations plus détaillées en fonction de chaque territoire. Un même poste de transaction fiscale peut avoir plusieurs territoires qui composent les montants d’un poste de transaction fiscale.

La somme de amount_taxable ou de amount_non_taxable figurant dans les informations concernant le territoire n’est pas toujours égale au amount du poste de transaction fiscale.

amount_taxable : il s’agit du montant imposable jusqu’à concurrence du amount du poste de transaction fiscale. Plusieurs territoires peuvent avoir le même montant taxable.

amount_non_taxable : il s’agit du montant non imposable jusqu’au amount du poste de transaction fiscale. Plusieurs territoires peuvent avoir le même montant non taxable.

amount_tax : fait partie du poste de transaction fiscale amount_tax. La somme des éléments de tous les territoires est égale au amount_tax du poste de transaction.

currency : il s’agit de la devise de présentation qui définit amount_taxable, amount_non_taxable et amount_tax. La somme des différentes devises donne des résultats inattendus.

filing_currency : il s’agit de la devise de déclaration utilisée par l’autorité fiscale compétente qui définit filing_amount_taxable, filing_amount_non_taxable et filing_amount_tax. La somme des différentes devises de déclaration donne des résultats inattendus.

L’exemple suivant permet de récupérer toutes les informations concernant le territoire pour un poste de transaction fiscale donné.

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'

Exemples de requêtes

Pour des exemples supplémentaires, veuillez vous référer à la section Taxe de la bibliothèque de modèles de requêtes dans l’encadré Sigma.

Dette fiscale par mois

Cet exemple récapitule la dette fiscale imposée sur les postes et les frais d’expédition, regroupés par mois et par devise.

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

Informations concernant le territoire en matière d’impôts détaillés

Ce modèle présente les informations concernant le territoire responsable des transactions fiscales pour le mois précédent afin de produire une version personnalisable de l’export détaillé de Tax. Passez en revue les commentaires figurant dans le modèle pour en savoir plus sur la manière dont il peut être adapté à vos besoins.

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