Connecteur Tax indépendant pour Adobe CommerceBêta

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.

La configuration minimale requise est PHP 7.4, et au moins la version 2.3.7 ou ultérieure de Magento 2 et Adobe Commerce.

Contactez le service d’assistance pour toute question relative à la configuration de Stripe Tax pour Adobe Commerce.

Installation

Afin d’installer Stripe Tax pour Adobe Commerce :

1. Commandez le module sur Adobe Marketplace.
2. Ouvrez votre terminal et exécutez la commande suivante dans votre répertoire Adobe Commerce :

composer require stripe/tax

• Si c’est la première fois que vous installez un module, il vous sera peut-être demandé de saisir votre nom d’utilisateur et votre mot de passe. Fournissez vos clés d’authentification Adobe Commerce.

1. Configurez le module en exécutant les commandes suivantes :

php bin/magento setup:upgrade
php bin/magento cache:flush
php bin/magento cache:clean

1. Si vous exécutez Adobe Commerce en mode production, vous devez également compiler et déployer les fichiers statiques du module :

php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy

Mise à niveau du module

Avant de procéder à la mise à niveau :

• Sauvegardez vos fichiers et votre base de données.
• Commencez dans votre environnement de test.
• Conservez une copie de toutes les personnalisations que vous avez apportées au code d’origine du module.

Vous pouvez mettre à niveau le module en exécutant les commandes suivantes :

composer remove stripe/tax
composer require stripe/tax
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:clean

Désinstaller le module

Avant de désinstaller le module :

• Sauvegardez vos fichiers et votre base de données.
• Conservez une copie de toutes les personnalisations que vous avez apportées au code d’origine du module au cas où vous auriez besoin de le réinstaller ultérieurement.

Exécutez les commandes suivantes pour désinstaller le module :

composer remove stripe/tax
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:clean

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.
2. Dans la section Ventes, sélectionnez Stripe Tax.

Les paramètres suivants sont disponibles pour la configuration :

• Activé : définissez le paramètre sur Yes afin d’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.
• Clé API secrète : saisissez votre clé API secrète à partir de votre Dashboard Stripe.
• Tarif des produits et promotions : configurez le mode de calcul des taxes sur les tarifs des produits et sur les montants des réductions. Définissez cette option sur Tax exclusive or Tax inclusive, en fonction de la stratégie de tarification de votre boutique. Si vous sélectionnez hors taxes, les tarifs des produits configurés à partir du panneau d’administration ou les réductions appliquées au panier n’incluent pas la taxe. Si vous sélectionnez TTC, les tarifs des produits et les réductions 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.

Catégories de taxes sur les produits

Vous pouvez gérer les catégories de taxes sur les produits 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 sur les produits dans votre boutique Adobe Commerce :

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

2. 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.

3. 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.

4. 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.

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

6. 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 effectuer des calculs de taxes en direct, vous devez ajouter des immatriculations fiscales Tax registrationI dans votre Dashboard Stripe. Vous pouvez ajouter des immatriculations fiscales manuellement dans la section Immatriculations fiscales Tax registrations, ou via la section Seuils d’imposition. Au cours des étapes d’immatriculation fiscale, vous pouvez choisir entre une immatriculation immédiate, ou programmer l’immatriculation pour qu’elle commence à une date ultérieure si vous prévoyez de vous immatriculer. Stripe Tax ne calcule et ne collecte la taxe que sur les transactions effectuées dans ces lieux.

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 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 via 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.

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

• Cliquez sur le pays pour lequel vous souhaitez exporter des transactions fiscales.
• 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.