# Importer des transactions dans Stripe Tax Importez des données de transaction dans Stripe Tax depuis une plateforme externe. > [Connectez-vous](https://dashboard.stripe.com/settings/tax) ou [créez un compte Stripe](https://dashboard.stripe.com/register) pour activer Stripe Tax. 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. 1. Vous formatez les données dans un fichier CSV à raison d’une ligne par poste (et non par transaction). 1. [Vous chargez le fichier CSV dans Stripe Tax via le Dashboard](https://docs.stripe.com/tax/imports.md#import-your-transaction-data). 1. Stripe Tax valide et traite vos données. 1. Accédez aux transactions importées dans les [rapports](https://docs.stripe.com/tax/reports.md), le [suivi des obligations](https://docs.stripe.com/tax/monitoring.md) et les [déclarations et versements](https://docs.stripe.com/tax/filing.md). ## 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 | Nom de colonne | Type | Exemple | | -------------------------------------- | ------------------------------------------------------------------------------- | ------------------------------------------- | | `source_transaction_id` | Texte (Obligatoire) | `order_123abc` | Identifiant unique de la transaction | | `transaction_type` | `Sale`, `Refund` ou `Void` (Obligatoire) | `Sale` | Type de transaction | | `transaction_version` | Numéro (Facultatif) | `1`, `1712863281` (horodatage Unix) | Champ numérique pour spécifier la version la plus récente de la transaction. La valeur par défaut est `1`. | | `provider` | Texte (Obligatoire) | `amazon`, `tax_jar`, `shopify` | Source externe de la transaction | | `liable_transaction_id` | Texte (Obligatoire pour le remboursement ou l’annulation) | `order_abc123` | ID de la transaction source à laquelle ce remboursement ou cette annulation se rapporte | | `tax_rules_at` | Date et heure (format `yyyy-MM-dd HH:mm:ss z`) (Obligatoire) | `2024-02-22 18:42:47 UTC` | Date à laquelle la taxe est due | | `created_at` | Date et heure (format `yyyy-MM-dd HH:mm:ss z`) (Obligatoire) | `2024-02-22 18:42:47 UTC` | Date de création de la transaction | | `posted_at` | Date et heure (format `yyyy-MM-dd HH:mm:ss z`) (Obligatoire) | `2024-02-22 18:42:47 UTC` | Date à laquelle la responsabilité est assumée ou réduite | | `currency` | Code de devise (ISO 4217) (Obligatoire) | `USD`, `EUR`, `GBP` | Devise de règlement de la transaction | | `customer_id` | Texte (Facultatif) | `cus_123` | ID client Stripe | | `tax_exempt` | `exempt`, `none` ou `reverse` (Obligatoire) | `exempt` | Exonération fiscale de la transaction | | `line_item.id` | Texte (Obligatoire) | `item_123` | ID du poste | | `line_item.amount` | Nombre1 (Facultatif) | `150.50` | Montant total du poste **après application des remises et taxes incluses** | | `line_item.product_id` | Texte (Facultatif) | `prod_123` | ID de produit Stripe | | `line_item.product_name` | Texte (Facultatif) | `Premium Widget` | Nom de produit fourni par l’utilisateur | | `line_item.product_description` | Texte (Facultatif) | `High-quality widget for premium customers` | Description du produit au format libre | | `line_item.product_tax_code` | Texte (Obligatoire) | `txcd_99999999` | Un [code fiscal produit](https://docs.stripe.com/tax/tax-codes.md) Stripe qui classe cette transaction. | | `line_item.external_product_id` | Texte (Facultatif) | `SKU123` | ID de produit externe (par exemple, unités de gestion des stocks du marchand) | | `line_item.external_tax_code` | Texte (Facultatif) | `TX456` | Code de taxe externe du produit | | `line_item.tax_behavior` | `exclusive` (par défaut) ou `inclusive` (Optional) | `exclusive` | Comportement fiscal du montant unitaire du poste | | `line_item.unit_amount` | Nombre1 (Obligatoire) | `50.12` | Coût d’une unité avant application des réductions et hors taxes (si exclusive) ou taxes comprises (si inclusive) | | `line_item.quantity` | Nombre (les valeurs décimales sont prises en charge) (Obligatoire) | `1`, `2`, `3.5` | Quantité de l’unité | | `line_item.amount_discount` | Nombre1 (Facultatif) | `10.00` | Réduction pour un poste donné | | `line_item.taxable_amount` | Nombre1 (Facultatif) | `45.50` | Montant taxable pour un poste donné | | `line_item.tax_rate` | Numéro (Facultatif) | `0.08` | Taux de taxe agrégé au niveau du poste | | `line_item.amount_tax` | Nombre1 (Obligatoire) | `12.18` | Montant total des taxes perçues pour le poste concerné | | `shipping_line_item.id` | Texte (Obligatoire si vous utilisez la livraison)2 | `ship_123` | ID de poste de livraison externe | | `shipping_line_item.tax_behavior` | `exclusive` (par défaut) ou `inclusive` (Optional) | `exclusive` | Régime de taxe du poste de livraison | | `shipping_line_item.amount` | Nombre1 (Obligatoire si vous utilisez la livraison) | `5.99` | Frais de livraison avant application des réductions et hors taxes (si exclusive) ou taxes comprises (si inclusive) | | `shipping_line_item.taxable_amount` | Nombre1 (Obligatoire si `tax_rate` est manquant) | `5.99` | Montant taxable pour la livraison | | `shipping_line_item.tax_rate` | Nombre (Obligatoire si `taxable_amount` est manquant) | `0.08` | Taux de taxe pour la livraison | | `shipping_line_item.amount_tax` | Nombre1 (Obligatoire si vous utilisez la livraison) | `0.48` | Taxe perçue pour le poste de livraison | | `shipping_line_item.description` | Texte (Facultatif) | `Express Shipping` | Description du poste de livraison au format libre | | `shipping_line_item.tax_code` | `txcd_00000000` ou `txcd_92010001` (Required) | `txcd_92010001` | Un [code de taxe produit](https://docs.stripe.com/tax/tax-codes.md) Stripe qui classe le poste de livraison. | | `shipping_line_item.external_tax_code` | Texte (Facultatif) | `TX789` | Code fiscal externe pour la livraison | | `shipping_line_item.amount_discount` | Nombre1 (Facultatif) | `2.00` | Réduction sur un poste de livraison | | `merchant_address.city` | Texte (Facultatif) | `San Francisco` | Ville du marchand | | `merchant_address.country` | Code pays (ISO 3166-1 alpha-2) (Obligatoire) | `US` | Pays du marchand | | `merchant_address.line1` | Texte (Facultatif) | `123 Commerce St` | Ligne 1 de l’adresse du marchand | | `merchant_address.line2` | Texte (Facultatif) | `Suite 400` | Ligne 2 de l’adresse du marchand | | `merchant_address.postal_code` | Texte (Obligatoire pour les États-Unis et le Canada) | `94111` | Code postal du marchand | | `merchant_address.state` | Texte (Facultatif) | `CA` | État du marchand | | `tax_ids.type` | Texte (Obligatoire si des champs tax_ids sont fournis) | `EU_OSS_VAT`, `CA_QST` | Type de numéro fiscal fourni. | | `tax_ids.country` | Code pays (ISO 3166-1 alpha-2) (Obligatoire si des champs tax_ids sont fournis) | `US`, `CA` | Code pays à deux caractères du numéro fiscal. | | `tax_ids.value` | Texte (Obligatoire si des champs tax_ids sont fournis) | `12-3456789` | Valeur du numéro fiscal. | | `buyer_address.city` | Texte3 (Facultatif) | `Boston` | Ville du client | | `buyer_address.country` | Code pays (ISO 3166-1 alpha-2)3 (Obligatoire) | `US` | Pays du client | | `buyer_address.line1` | Texte3 (Facultatif) | `456 Main St` | Ligne 1 de l’adresse du client | | `buyer_address.line2` | Texte3 (Facultatif) | `Apt 789` | Ligne 2 de l’adresse du client | | `buyer_address.postal_code` | Texte3 (Obligatoire pour les États-Unis et le Canada) | `02108` | Code postal du client | | `buyer_address.state` | Texte3 (Facultatif) | `MA` | État du client | 1 Les montants sont représentés dans la devise sous forme décimale dans la dénomination principale. Par exemple, `10.00` en USD est égal à `$10.00`. 2 Les postes de livraison sont facultatifs, mais s’ils sont indiqués, certains champs deviennent obligatoires. 3 Pour les adresses des clients, les [exigences de Stripe Tax en matière d’adresse](https://docs.stripe.com/tax/customer-locations.md#supported-formats) s’appliquent. ### 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.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,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,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,-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,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,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,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,-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,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,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,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.*` #### 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` 1. Mettez à jour les champs à corriger. 1. Augmentez la valeur de `transaction_version` (par ex. de `1` à `2`). 1. 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](https://dashboard.stripe.com/tax/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 | Limites | Détails | | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- | | Taille maximale du fichier | 50 Mo | | Format de fichier pris en charge | CSV uniquement | | Ligne de l’en-tête | Obligatoire (doit inclure les noms des colonnes, comme indiqué ci-dessus) | | Traitement des fichiers | Le traitement des fichiers volumineux peut prendre plus de temps | | Impact des rapports | Les transactions importées n’ont aucune incidence sur vos calculs ni vos rapports pour les transactions traitées via Stripe. | ## Importer vos données de transaction Pour importer vos données de transactions tierces : 1. Accédez à la section **[Tax](https://dashboard.stripe.com/tax)** du Dashboard Stripe. 1. Cliquez sur **Actions rapides**, puis sélectionnez **Importer des transactions**. 1. Cliquez sur **Importer un fichier CSV**. 1. Sélectionnez le fichier CSV préparé et cliquez sur **Importer un fichier**. 1. 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](https://docs.stripe.com/tax/testing.md). > Vous ne pouvez pas supprimer des transactions importées. L’importation d’une nouvelle version de transaction permet de corriger des transactions précédemment importées. Pour toute transaction importée par inadvertance, l’importation d’une transaction annulée supprime toute obligation fiscale. ## 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](https://docs.stripe.com/tax/reports.md#exports) : 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](https://docs.stripe.com/stripe-data/query-tax-data.md) : 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](https://docs.stripe.com/tax/testing.md#tax-transactions-page) : le Dashboard Taxer Aperçu n’inclut pas les transactions importées dans ses calculs ou ses affichages. - [Rapports par territoire fiscal](https://docs.stripe.com/tax/reports.md#us-location-reports) : 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](https://docs.stripe.com/tax/reports.md) et le [suivi des obligations](https://docs.stripe.com/tax/monitoring.md). ### 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](https://docs.stripe.com/revenue-recognition.md), 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. ## See also - [Déclarations fiscales](https://docs.stripe.com/tax/reports.md) - [Suivi des obligations fiscales](https://docs.stripe.com/tax/monitoring.md) - [Immatriculation fiscale](https://docs.stripe.com/tax/registering.md)