Importer des transactions dans Stripe TaxVersion bêta publique

Importez des données de transaction dans Stripe Tax à partir de plateformes tierces à l’aide de fichiers CSV. Consolidez les données de vente provenant de plusieurs plateformes pour bénéficier d’une vue unifiée de vos obligations fiscales, simplifier la conformité et prendre des décisions éclairées sur les exigences en matière d’immatriculation fiscale.

L’importation de vos données de transaction à partir de plateformes externes dans Stripe Tax présente plusieurs avantages :

• Suivi unifié des obligations fiscales : surveillez les seuils pour tous les canaux de vente, y compris les transactions effectuée en dehors de Stripe.
• Conformité simplifiée : évitez le rapprochement manuel et l’agrégation de données provenant de différentes plateformes.
• Surveillance plus précise des seuils : identifiez les territoires dans lesquels vous devez vous immatriculer pour collecter des taxes en centralisant les données de transaction.
• Gestion flexible des données : importez des données historiques pour les obligations passées ou maintenez des importations régulières pour une surveillance continue.

Fonctionnement

Lorsque vous importez des données de transaction dans Stripe Tax :

1. Vous exportez vos données de transaction à partir de plateformes externes.
2. Vous formatez les données dans un fichier CSV à raison d’une ligne par poste (et non par transaction).
3. Vous chargez le fichier CSV dans Stripe Tax via le Dashboard.
4. Stripe Tax valide et traite vos données.
5. Accédez aux transactions importées dans les rapports, le suivi des obligations et les déclarations et versements.

Exigences relatives au format de fichier CSV

Votre fichier CSV doit respecter un format spécifique et certaines colonnes sont obligatoires. Ajoutez une ligne d’en-tête dans chaque fichier. Chaque ligne représente un poste, et non une transaction complète. Si une même transaction se compose de plusieurs produits ou postes, indiquez chaque poste sur une ligne distincte dans le fichier CSV.

Référence de la colonne

Exemple de fichier CSV

Exemple de fichier CSV avec plusieurs postes et une variété de champs couramment utilisés (vous pouvez également télécharger un fichier CSV d’exemple depuis le panneau Importer du Dashboard) :

source_transaction_id,transaction_type,provider,liable_transaction_id,transaction_version,tax_rules_at,created_at,posted_at,currency,customer_id,tax_exempt,line_item.id,line_item.amount,line_item.product_id,line_item.product_name,line_item.product_description,line_item.product_tax_code,line_item.external_product_id,line_item.external_tax_code,line_item.tax_behavior,line_item.unit_amount,line_item.quantity,line_item.amount_discount,line_item.taxable_amount,line_item.tax_rate,line_item.amount_tax,shipping_line_item.id,shipping_line_item.tax_behavior,shipping_line_item.description,shipping_line_item.tax_code,shipping_line_item.external_tax_code,shipping_line_item.amount,shipping_line_item.amount_discount,shipping_line_item.taxable_amount,shipping_line_item.tax_rate,shipping_line_item.amount_tax,merchant_address.city,merchant_address.country,merchant_address.line1,merchant_address.line2,merchant_address.postal_code,merchant_address.state,tax_ids.type,tax_ids.value,buyer_address.city,buyer_address.country,buyer_address.line1,buyer_address.line2,buyer_address.postal_code,buyer_address.state
1935a6-Sale,Sale,tax_jar,,1,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,USD,cus_9s6XKzkNRiz8i3,none,LineItem-1,42.54,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,inclusive,55.05,1,12.51,,,4.06,ShippingLineItem-8ab3,inclusive,Shipping description 69,txcd_92010001,shipping_tax_code_3,10.33,,,,0,San Francisco,US,510 Townsend St,,94103,CA,us_ein,12-3456789,Seattle,US,9205th Ave,,98104,WA
8a54a0-Refund,Refund,tax_jar,1935a6-Sale,1,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,USD,cus_9s6XKzkNRiz8i3,none,LineItem-1,-42.54,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,inclusive,-55.05,1,-12.51,,,-4.06,ShippingLineItem-8ab3,inclusive,Shipping description 69,txcd_92010001,shipping_tax_code_3,-10.33,,,,0,San Francisco,US,510 Townsend St,,94103,CA,us_ein,12-3456789,Seattle,US,9205th Ave,,98104,WA
1860e6-Sale,Sale,tax_jar,,1,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,USD,cus_9s6XKzkNRiz8i3,none,LineItem-1,172.58,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,inclusive,45.37,4,8.9,,,16.47,ShippingLineItem-e936,inclusive,Shipping description 69,txcd_92010001,shipping_tax_code_3,8.14,,,,0,San Francisco,US,510 Townsend St,,94103,CA,us_ein,12-3456789,Seattle,US,9205th Ave,,98104,WA
e7f7a1-Void,Void,tax_jar,1860e6-Sale,1,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,USD,cus_9s6XKzkNRiz8i3,none,LineItem-1,-172.58,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,inclusive,-45.37,4,-8.9,,,-16.47,ShippingLineItem-e936,inclusive,Shipping description 69,txcd_92010001,shipping_tax_code_3,-8.14,,,,0,San Francisco,US,510 Townsend St,,94103,CA,us_ein,12-3456789,Seattle,US,9205th Ave,,98104,WA
6b8059-Sale,Sale,tax_jar,,1,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,2024-06-07 18:07:21 UTC,USD,cus_9s6XKzkNRiz8i3,none,LineItem-1,216.37,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,exclusive,69.17,3,11.79,,,20.65,ShippingLineItem-3218,inclusive,Shipping description 69,txcd_92010001,shipping_tax_code_3,9.41,,,,0,San Francisco,US,510 Townsend St,,94103,CA,us_ein,12-3456789,Seattle,US,9205th Ave,,98104,WA

Conseils pour chaque type de transaction

Transactions de vente

Lorsque vous importez des transactions de vente, suivez ces directives pour vous assurer qu’elles sont traitées correctement. Vous ne pouvez inclure qu’un seul poste de livraison par transaction.

Pour les transactions comportant un seul poste :

• Créez une ligne avec tous les champs obligatoires
• Définissez transaction_type sur Sale

Pour les transactions comportant plusieurs postes :

• Créer une ligne distincte pour chaque poste
• Assurez-vous que ces champs correspondent exactement à tous les postes d’une même transaction :
  • source_transaction_id
  • transaction_type
  • provider
  • tax_rules_at
  • currency
  • Tous les champs tax_ids.*
  • Tous les champs shipping_line_item.*

Remboursements et transactions annulées

Lors de l’importation de remboursements ou d’annulations, vous devez indiquer la transaction d’origine :

Pour les transactions comportant un seul poste :

• Créez une ligne avec tous les champs obligatoires
• Définissez transaction_type sur Refund ou Void
• Définissez liable_transaction_id sur le source_transaction_id de la transaction d’origine
• Utilisez des valeurs négatives pour les champs de montant (ajoutez un signe moins)
• Veillez à ce que la devise currency corresponde à la transaction initiale

Pour les transactions comportant plusieurs postes :

• Créer une ligne distincte pour chaque poste
• Définissez transaction_type sur Refund ou Void
• Définissez liable_transaction_id sur le source_transaction_id de la transaction d’origine
• Utilisez les valeurs négatives pour tous les champs de montant
• Assurez-vous que ces champs correspondent exactement à tous les postes d’une même transaction de remboursement/annulation :
  • source_transaction_id
  • transaction_type
  • provider
  • tax_rules_at
  • currency
  • Tous les champs tax_ids.*
  • Tous les champs shipping_line_item.*

Correction des transactions

Pour corriger une transaction précédemment importée :

1. Dupliquez la transaction que vous souhaitez corriger, en utilisant des valeurs identiques pour :
   • source_transaction_id
   • transaction_type
   • provider
2. Mettez à jour les champs à corriger.
3. Augmentez la valeur de transaction_version (par ex. de 1 à 2).
4. Réimportez les transactions corrigées.

Stripe Tax conserve un historique de toutes les versions et utilise celle dont la valeur transaction_version est la plus élevée pour ses calculs et ses rapports. Cette approche remplace effectivement les données de transaction d’origine dans vos calculs fiscaux, sans les annuler.

La page Transactions du Dashboard affiche les trois enregistrements: la transaction d’origine, une transaction d’invalidation qui l’annule, et la nouvelle transaction corrigée.

Limites d’importation

Importer vos données de transaction

Pour importer vos données de transactions tierces :

1. Accédez à la section Tax du Dashboard Stripe.
2. Cliquez sur Actions rapides, puis sélectionnez Importer des transactions.
3. Cliquez sur Importer un fichier CSV.
4. Sélectionnez le fichier CSV préparé et cliquez sur Importer un fichier.
5. Surveillez l’état de l’importation dans le volet qui s’affiche. Vous pouvez fermer ce volet et y revenir plus tard pour vérifier l’avancement ou afficher les résultats de la validation.

Si des erreurs se produisent lors de l’importation, vous pouvez télécharger un fichier CSV de toutes les lignes présentant des problèmes et les erreurs spécifiques qui se sont produites.

Testez vos données importées en suivant les étapes de validation de la section Test de Stripe Tax.

Informations supplémentaires

Limitations d’utilisation

L’outil d’importation de transactions présente certaines limites d’utilisation :

• Portée des données : l’outil permet d’importer des données externes sur les ventes afin d’aider à surveiller les obligations fiscales. Ne l’utilisez pas pour importer des achats reportables pour la TVA. L’importation d’achats reportables pour la TVA gonfle de manière inexacte les chiffres bruts de ventes et n’ajuste pas correctement l’obligation fiscale.
• Transactions externes uniquement : cet outil prend exclusivement en charge l’importation de données de transaction à partir de sources externes. Ne l’utilisez pas pour corriger ou modifier des transactions traitées initialement par Stripe.

Tarifs

Pendant la version bêta publique, vous pouvez importer gratuitement des transactions au format CSV. Ces importations ne sont pas comptabilisées dans les droits ou les limites d’utilisation de l’API.

Gestion du calcul des taxes

Stripe ne recalcule pas automatiquement les taxes pour les transactions importées. Les transactions importées sont déclarées en utilisant le montant de taxe indiqué dans le fichier CSV, que vous disposiez ou non d’une immatriculation Stripe Tax active pour ce lieu.

Bien que les montants taxables, les montants non taxables, les taux de taxe et les raisons d’assujettissement à la taxe pour les transactions importées puissent apparaître dans les rapports Stripe Tax et ailleurs dans Stripe, traitez ces valeurs uniquement comme des estimations ou des approximations.

Visibilité limitée

Les données de transaction importées ont une visibilité limitée dans certains rapports et interfaces de Stripe Tax :

• Exports de transactions : les exports détaillés et récapitulatifs excluent les informations sur les taux de taxe, les montants taxables et les motifs de taxabilité dans chaque territoire pour les transactions importées.
• Sigma : les informations relatives aux juridictions fiscales (lignes tax_transaction_jurisdiction_details) ne sont pas accessibles pour les transactions importées dans les rapports Sigma.
• Page Taxer Aperçu : le Dashboard Taxer Aperçu n’inclut pas les transactions importées dans ses calculs ou ses affichages.
• Rapports par territoire fiscal : les transactions importées ne sont pas affichées dans les rapports par territoire fiscal.

Vous pouvez toujours consulter le détail des transactions importées dans les rapports fiscaux et le suivi des obligations.

Visibilité dans d’autres produits Stripe

Les transactions importées à l’aide de l’outil d’importation apparaissent uniquement dans les rapports et interfaces de Stripe Tax. Pour inclure des transactions tierces dans d’autres produits comme Revenue Recognition, vous devez utiliser un outil d’importation distinct spécifique à chaque produit.

Traitement des données

Historique des données de transaction

Vous pouvez importer l’historique des données de transaction pour n’importe quelle période à compter du 1er octobre 2023.

Délai de traitement

24 heures sont parfois nécessaires pour que les transactions traitées applicables soient reflétées dans certains rapports et interfaces Stripe Tax.