Dépannage

Il arrive que les choses ne fonctionnent pas comme prévu et qu'il soit difficile d'en déterminer la cause. Nous clarifions ci-dessous quelques problèmes courants :

Problème de calcul de la TVA sur les commandes

Ce problème peut survenir pour plusieurs raisons. Voici ce que vous devez vérifier :

Comparez les adresses utilisées avec la matrice de compatibilité des cas d'usage. Ce sont les cas pris en charge par l'extension.
Des détails de validation sont-ils visibles dans les commentaires de la commande ? Le module permet à Magento de calculer la TVA lorsque l'un des résultats marqués est faux ou invalide :

Résultat de la validation du numéro de TVA en tant que commentaire de commande

- Le préfixe pays du numéro de TVA correspond-il au pays de l'adresse de livraison ? Si ce n'est pas le cas, le module autorise Magento à appliquer la TVA à la commande. - Pour les clients enregistrés : des détails de validation supplémentaires sont-ils enregistrés dans l'enregistrement d'adresse du client (par ex. « TVA valide », « demande de TVA réussie ») ? Ces informations sont lues par notre module à partir des données d'adresse, qui décide ensuite si Magento applique la TVA à la commande.

Si aucun de ces points ne correspond à votre problème, veuillez ouvrir un nouveau ticket de support dans votre compte client.

Utilisation correcte du champ du numéro de TVA

Magento prend en charge deux champs différents pour les numéros fiscaux. Le premier champ, intitulé « Tax/VAT » (taxvat), est lié à l'entité client. Ce nom peut prêter à confusion, car il est avant tout conçu comme un champ « numéro fiscal » destiné aux pays disposant de numéros fiscaux personnels uniques.

Depuis Magento 1.7, un second champ, « VAT number » (vat_id), a été introduit ; il permet la saisie d'un véritable numéro de TVA de l'UE. Celui-ci est lié à l'adresse du client, qui est déterminante pour le calcul de la TVA. Comme le calcul de la TVA repose sur les données d'adresse, ce champ est le champ destiné aux numéros de TVA de l'UE, qui sont normalement attribués aux entreprises.

Avec notre extension, seul le champ « numéro de TVA » (vat_id) est pris en charge.

Pour activer ce champ, veuillez accéder à Stores -> Konfiguration -> Kundenkonfiguration. Dans les Optionen zum Erstellen eines neuen Kontos, réglez l'option Umsatzsteuernummer im Frontend anzeigen sur Ja.

Pour éviter toute confusion, nous recommandons de désactiver le champ « Tax/VAT » (taxvat) basé sur le compte. Pour cela, accédez aux paramètres de configuration client sous Name und Adressoptionen et réglez Steuernummer anzeigen sur Nein.

Mode débogage et journalisation

Si un problème ne peut pas être résolu à l'aide des points ci-dessus, le journal détaillé du calcul de la taxe vous aidera.

Activez le mode débogage sous Stores → Configuration → (Sales) EU VAT Enhanced → Module Information → Debug Mode sur Oui.
Limitez la journalisation pour qu'elle reste exploitable : placez par exemple un produit dans le panier et ouvrez la page du panier. Videz ensuite le fichier journal et rechargez la page – ainsi le journal ne contient que l'opération pertinente.
Le journal est écrit dans var/log/euvat.log.
Reproduisez le problème, analysez le fichier ou joignez-le à votre ticket de support.

Désactivez à nouveau le mode débogage après l'analyse. Le fichier grossit très rapidement, car sinon chaque calcul de catalogue et d'arrière-plan est également journalisé – cela rend le journal inutilisable et sollicite l'espace de stockage.

Autotest du calcul de la taxe

Pour vérifier rapidement votre configuration, une commande de console calcule la taxe pour les scénarios pris en charge :

bin/magento geissweb:selftest:vatcalc

Si le résultat diffère de ce qui est attendu, vérifiez les règles de taxe, les taux et les classes de taxe dynamiques sous Classes de taxe et calcul.

Format belge des numéros de TVA (BE1)

La Belgique a modifié son schéma d'attribution des numéros de TVA : les numéros peuvent désormais commencer par BE0 ou, nouvellement, par BE1. Pour prendre en charge les nouveaux numéros, utilisez au minimum la version 1.20.9 de l'extension, qui contient l'adaptation au nouveau schéma.

Si cette version n'est pas disponible pour vous, prolongez la période de mises à jour et de support de votre licence via votre compte client, dans la section « Téléchargements et clés de licence ». Vous pouvez également appliquer vous-même la modification nécessaire.

Dans le fichier Validator/Syntax.php :

case 'BE': // Belgium
    $regex = '(BE)?[01][0-9]{9}';
    break;

Dans les fichiers view/base/web/js/model/syntax-validation.js et/ou view/base/web/js/form/element/vat-number-base.js :

'BE': '(BE)?[01][0-9]{9}$',