# Utiliser Stripe Tax afin d’automatiser le calcul et la déclaration des taxes pour Adobe Commerce

Automatisez la collecte et la déclaration des taxes grâce à une intégration unique dans Adobe Commerce.

> Les fonctionnalités Stripe Tax de notre plugin de paiements Adobe Commerce sont actuellement disponibles en version bêta publique. Vous pouvez les activer dans la configuration du plugin de paiement. Si vous souhaitez utiliser nos API de calcul et de déclaration des taxes avec d’autres solutions de paiement, [contactez-nous](mailto:adobe-commerce-stripe-tax-rc@stripe.com).

Le module Stripe Tax pour Adobe Commerce permet de calculer, de collecter et de déclarer les taxes sur les paiements effectués par l’intermédiaire de n’importe quel moyen de paiement Adobe Commerce pris en charge.

Par rapport au moteur de calcul fiscal natif d’Adobe Commerce, Stripe Tax offre un processus de configuration et d’activation plus simple. Stripe Tax étant dynamique, il n’est pas nécessaire de reconfigurer Adobe Commerce lorsque les taux de taxe changent pour des types de produits, des lieux ou des périodes spécifiques. Stripe met continuellement à jour les règles fiscales locales et calcule automatiquement le bon montant de taxe.

## Disponibilité

Pour utiliser Stripe Tax avec Adobe Commerce :

- Votre entreprise doit être établie dans l’un des [pays pris en charge](https://docs.stripe.com/tax/supported-countries.md).
- Votre système doit répondre aux exigences minimales suivantes : PHP 7.4 ou plus récent, Magento 2 version 2.3.7 ou plus récente, Adobe Commerce version 2.3.7 ou plus récente.

[Contactez le service Support](https://support.stripe.com/contact/) si vous avez des questions sur la configuration de Stripe Tax pour Adobe Commerce.

L’utilisation des fonctionnalités fiscales du plugin entraîne des [frais d’API](https://support.stripe.com/questions/understanding-stripe-tax-pricing) sur les calculs taxés et l’enregistrement taxé. Dans un environnement de test, vous pouvez effectuer 1 000 appels à l’API gratuits par jour. Un environnement de test est un environnement de test isolé qui vous permet de tester les fonctionnalités Stripe dans votre compte sans affecter votre intégration en mode production. Utilisez des environnements de test pour expérimenter en toute sécurité de nouvelles fonctionnalités et de changements.

## Configuration

Vous pouvez configurer les paramètres généraux de Stripe Tax dans Adobe Commerce sur la page de configuration de Tax.

### Paramètres généraux

Pour accéder à vos paramètres généraux dans le panneau d’administration de votre boutique Adobe Commerce :

1. Accédez à **Boutiques** > **Paramètres** > **Configuration**.
1. Dans la section Ventes, sélectionnez **Stripe Tax**.

Les paramètres suivants sont disponibles pour la configuration :

- **Enabled** (activé) : Définissez `Yes` pour activer Stripe Tax pour votre boutique. Cela permet au module de commencer à calculer, à collecter et à déclarer les taxes.
- **Mode** : sélectionnez **Test** pour utiliser les identifiants de test afin de tester l’intégration sans affecter les transactions réelles. Passez en **Production** lorsque vous souhaitez commencer à calculer les taxes dans un environnement de production.
- **Clé API publique** : saisissez votre clé API publique obtenue à partir de votre [Dashboard Stripe](https://dashboard.stripe.com/apikeys).
- **Clé API secrète** : saisissez votre clé API secrète à partir de votre [Dashboard Stripe](https://dashboard.stripe.com/apikeys).
- **Prix des produits et promotions** : Configurez la manière de calculer les taxes sur le prix des produits et le montant des remises. Choisissez entre `Hors taxes` ou `Toutes taxes comprises` selon le modèle de tarification de votre boutique. Si vous sélectionnez **Hors taxes**, les prix des produits configurés dans le panneau d’administration, ainsi que les remises appliquées au panier, n’incluent pas la taxe. Si vous sélectionnez **Toutes taxes comprises**, les prix des produits et les remises incluent déjà la taxe.
- **Frais de port** : déterminez le mode de taxation des frais de port. Sélectionnez **Détaxé**, **Hors taxes** ou **TTC** si vous souhaitez que les frais d’expédition incluent les taxes.

Sous l’onglet **Stripe Tax Exemptions** (exemptions de taxe Stripe), vous trouverez les paramètres supplémentaires suivants :

- **Groupes de clients exonérés de taxe** : Aucune taxe n’est facturée au moment du paiement pour les groupes de clients que vous sélectionnez ici. Par exemple, si vous sélectionnez **Vente en gros**, les clients grossistes ne paieront pas de taxe sur leurs commandes. Vous pouvez utiliser ce paramètre si certains clients ou groupes B2B sont admissibles aux achats hors taxes en vertu de vos réglementations locales.
- **Groupes de clients soumis à l’autoliquidation** : Tout groupe de clients que vous sélectionnez ici est soumis aux règles d’imposition dites de « taxe au preneur » plutôt qu’aux règles normales en matière de taxe sur les ventes. L’autoliquidation signifie qu’au lieu que vous (le vendeur) préleviez et reversiez la taxe, c’est l’acheteur (votre client) qui la comptabilise lui-même. Cela est courant dans certaines transactions B2B au sein de l’UE (et dans d’autres régions appliquant des règles similaires). Par exemple, si vous sélectionnez **détaillant**, Magento et Stripe gèrent ces transactions de détaillant selon la logique de l’autoliquidation au lieu de la collecte standard des taxes.

### Gérer les catégories de taxes produit

Vous pouvez gérer les catégories de taxes produit pour vous assurer que vos produits sont correctement classés à des fins de calcul de la taxe.

Pour ajouter, modifier ou supprimer des catégories de taxes produit dans votre boutique Adobe Commerce :

1. Depuis le panneau d’administrator, accédez à **Boutiques** > **Taxes** > **Catégories de Stripe Tax** pour ouvrir la page dans laquelle vous pouvez gérer vos classe de taxes.

1. Pour ajouter une nouvelle catégorie de taxe, cliquez sur **Ajouter une nouvelle catégorie de taxe** en bas de la page Catégories de taxes Stripe. Une fenêtre modale s’ouvre alors, dans laquelle vous pouvez sélectionner une catégorie de taxe. Chaque catégorie représente un code de taxe spécifique. Sélectionnez celle que vous souhaitez utiliser pour vos produits, puis cliquez sur **Ajouter**.

1. Vous pouvez modifier une catégorie de taxe existante si des catégories de taxes sont déjà assignées à vos produits avant l’installation de Stripe Tax. Cela vous permet de conserver ces catégories de taxes existantes et de leur attribuer un code de taxe. Pour ce faire, cliquez sur **Sélectionner** dans la colonne **Actions** à côté de la catégorie de taxe que vous souhaitez modifier. Choisissez **Définir la catégorie** pour attribuer une nouvelle catégorie.

1. Pour renommer une catégorie de taxe, cliquez sur son nom. Une fenêtre modale s’ouvre alors, dans laquelle vous pouvez définir un nouveau nom. Vous pouvez également développer la liste des options **Sélectionner** dans la colonne **Actions** et cliquer sur **Renommer** ou **Supprimer**.

1. Les modifications apportées aux catégories de taxes ne sont pas enregistrées automatiquement. Pour enregistrer vos modifications, cliquez sur **Enregistrer les modifications**.

1. Après avoir configuré vos catégories de taxes, vous pouvez les appliquer aux produits :

- Vous pouvez configurer la catégorie de taxe produit à partir de n’importe quelle page de modification de produit à l’aide du menu déroulant **Catégorie de taxe**. Les catégories de taxes que vous avez ajoutées apparaissent sur la page de modification du produit.
- Vous pouvez également utiliser la page de configuration des taxes afin de définir les catégories de taxe par défaut pour les produits auxquels aucune catégorie n’a été attribuée ou dont la catégorie a été supprimée.

### Immatriculations fiscales

Avant de pouvoir calculer les taxes en mode production, vous devez ajouter des immatriculations fiscales dans votre Dashboard Stripe. Vous pouvez ajouter des immatriculations fiscales manuellement dans la section [Immatriculations fiscales](https://dashboard.stripe.com/tax/registrations) ou dans la section [Seuils fiscaux](https://dashboard.stripe.com/tax/thresholds). Au cours des étapes d’immatriculation, vous pouvez choisir de vous immatriculer immédiatement ou programmer l’immatriculation de façon à ce qu’elle commence à une date ultérieure si vous prévoyez de le faire à l’avenir. Stripe Tax calcule et prélève la taxe uniquement sur les transactions effectuées dans ces territoires.

Si vous commencez à vendre dans un nouveau pays ou une nouvelle juridiction fiscale, Stripe peut automatiquement vous indiquer si vous devez vous immatriculer pour les taxes dans cette juridiction. Cela se produit généralement lorsque votre volume de ventes dépasse le seuil d’imposition de cette autorité fiscale. Si vous avez des transactions existantes sur Stripe, vous pouvez utiliser notre [outil de surveillance](https://dashboard.stripe.com/tax/thresholds) pour comprendre où vous pourriez avoir besoin de vous immatriculer.

## Remboursements et annulations de taxe

Une annulation de taxe est déclenchée lorsque vous créez une note de crédit à partir de la zone d’administration d’Adobe Commerce. L’annulation de la taxe sera déclenchée dans les deux cas de création d’une note de crédit en ligne ou d’une note de crédit hors ligne.

- **Remboursement hors ligne** : cette option crée une annulation de la taxe sans rembourser le paiement.
- **Remboursement** : cette opération crée une annulation de taxe et rembourse le paiement en ligne par l’intermédiaire de Stripe

Dans les cas où tous les éléments de la commande ne figurent pas sur la note de crédit (note de crédit partielle), l’annulation de la taxe ne sera déclenchée que pour les seuls éléments identifiés figurant sur la note de crédit.

> Les champs « Frais de réajustement » et « Remboursement de réajustement » de la note de crédit ne sont jamais pris en considération lors des annulations de taxes.

## Exporter les transactions fiscales

Si vous vous trouvez dans un pays où la prise en charge de la déclaration fiscale automatique n’est pas encore assurée, vous pouvez exporter vos transactions fiscales à partir de [Immatriculations fiscales](https://dashboard.stripe.com/tax/registrations)

- Cliquez sur le pays pour lequel vous souhaitez exporter les transactions avec taxe.
- Cliquez sur le bouton « Exporter les transactions » en haut à droite de la page d’immatriculation.
- Sélectionnez la plage de dates et les colonnes que vous souhaitez exporter.
- Cliquez sur le bouton « Exporter » pour télécharger les transactions au format CSV.