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 divers champs fréquemment utilisés :

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.tax_behavior,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.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.country,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,inclusive,42.54,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,55.05,1,12.51,,,9.67,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,US,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,inclusive,-42.54,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,-55.05,1,-12.51,,,-9.67,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,US,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,inclusive,172.58,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,45.37,4,8.9,,,7.43,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,US,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,inclusive,-172.58,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,-45.37,4,-8.9,,,-7.43,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,US,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,inclusive,195.72,,,Pepperoni Pizza,txcd_40060003,tax_product_id_56,tax_code_99,69.17,3,11.79,,,5.51,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,US,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.*

Corriger les 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 qui doivent être corrigés
3. Augmentez la valeur transaction_version (par exemple, de 1 à 2)

Cette approche remplace les données de transaction d’origine dans vos calculs de taxe plutôt que de les annuler. Stripe Tax utilise la version présentant la valeur transaction_version la plus élevé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.

Contrôle des versions de transactions

Vous pouvez corriger des transactions précédemment importées à l’aide du champ transaction_version afin de gérer correctement les mises à jour. Pour apporter des corrections à des transactions que vous avez déjà importées, procédez comme suit :

1. Apportez les corrections nécessaires à votre fichier CSV.
2. Réimportez les transactions portant les mêmes identifiants.
3. Définissez la transaction_version sur un nombre plus élevé que l’importation d’origine.

Stripe Tax conserve une trace de ces versions et utilise la version la plus récente dans ses calculs et ses rapports.

Informations supplémentaires

Limitations on use

The transaction import tool has limitations on what you can use it for:

• Scope of data: The tool is for importing external sales data to help monitor tax obligations. Don’t use it to import, VAT reportable purchases. Importing VAT reportable purchases inaccurately inflates gross sales figures and doesn’t correctly adjust tax liability.
• External transactions only: This tool exclusively supports importing transaction data from external sources. Don’t use it to correct or modify transactions that were originally processed through Stripe.

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 motifs de taxabilité puissent apparaître dans les rapports et les pages Stripe Tax pour les transactions importées, ces valeurs sont uniquement 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 concernant le territoire fiscal (lignes tax_transaction_jurisdiction_details) ne sont pas disponibles pour les transactions importées dans les rapports Sigma.
• Page d’aperçu de Tax : le Dashboard Aperçu de Tax n’inclut pas les transactions importées dans ses calculs ni dans ses affichages.
• Rapports par territoire fiscal : les rapports par territoire fiscal n’affichent aucune transaction importée.

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.