B2B VAT - VIES validation & intra-EU reverse charge. B2B VAT valide les numéros de TVA intracommunautaire auprès du service officiel VIES, applique automatiquement l'exonération de TVA pour autoliquidation intracommunautaire et affecte les clients B2B valides à un groupe configurable. Il inclut un cache de validation, un historique en back-office avec forçage manuel et un outil de vérification de TVA manuelle. Aucun code, aucune modification du thème.
B2B VAT valide les numéros de TVA intracommunautaire auprès du service officiel VIES, applique automatiquement l'exonération de TVA pour autoliquidation intracommunautaire et affecte les clients B2B valides à un groupe configurable. Il inclut un cache de validation, un historique en back-office avec forçage manuel et un outil de vérification de TVA manuelle. Aucun code, aucune modification du thème.
1. Installation
- Dans la Boutique, allez dans Modules → Gestionnaire de modules → Charger un module et sélectionnez le ZIP du module.
- Une fois installé, cliquez sur Configurer pour ouvrir l'écran de configuration.
.local, .test, localhost) sont toujours autorisés. Quand une nouvelle version est disponible, elle est signalée directement dans le module.2. Configuration · étape par étape
Le back-office du module comporte trois onglets : Historique des validations, Vérification TVA et Configurer. Toutes les options se trouvent dans l'onglet Configurer, regroupées en Validation, Exonération et groupe B2B, Comportement et Données.
Configurer onglet Configurer
Configurez quand et comment les numéros de TVA sont vérifiés, quel groupe rejoignent les clients B2B éligibles, et ce qui se passe quand un numéro n'est pas valide ou que VIES est inaccessible.
- Activer la validation TVA : interrupteur général de tout le module.
- Valider à l'inscription : vérifie le numéro de TVA quand un client s'inscrit.
- Valider à la création / modification d'adresse : vérifie le numéro de TVA quand une adresse est enregistrée ou mise à jour.
- Valider au moment de la commande : vérifie le numéro de TVA pendant le tunnel de commande.
- Exiger la correspondance du nom déclaré par VIES : n'accorde l'exonération que lorsque le nom communiqué par VIES correspond au nom du client / de l'entreprise. Quand VIES ne communique aucun nom, l'exonération est refusée (sécurité par défaut).
- Groupe B2B : les clients avec un numéro de TVA intracommunautaire valide selon VIES sont ajoutés à ce groupe. Réglez sa méthode d'affichage des prix sur HT afin qu'ils ne paient pas de TVA (autoliquidation).
- Appliquer l'exonération de TVA aux clients éligibles : accorde l'exonération pour autoliquidation (via le groupe B2B) quand la TVA est valide, que le pays est dans l'UE et différent du pays de la boutique.
- Traiter une TVA non valide comme une erreur bloquante : si désactivé (recommandé), une TVA non valide produit seulement un avertissement et est enregistrée ; le client n'est pas bloqué.
- Quand VIES est indisponible : choisissez Autoriser (silencieux) : ne jamais bloquer le client ou Autoriser mais afficher un message « impossible de vérifier, nouvelle tentative ». Le numéro est marqué « non vérifiable » et recontrôlé plus tard.
- Fraîcheur du cache (jours) : un résultat valide/non valide est réutilisé pendant ce nombre de jours avant une nouvelle interrogation de VIES (protection contre les limites de fréquence).
0désactive le cache. - Supprimer les données à la désinstallation : si activé, la désinstallation du module supprime tout l'historique des validations. Laissez-le désactivé pour conserver les enregistrements lors d'une réinstallation.
Historique des validations onglet Historique
Chaque vérification de TVA est enregistrée ici : le numéro de TVA, son statut (Valide, Non valide, Non vérifiable ou Format incorrect), le nom de l'assujetti retourné par VIES (quand disponible), la source (une interrogation VIES en direct ou le cache) et l'horodatage. Utilisez le champ de recherche et le filtre par statut pour retrouver un enregistrement, puis les actions de la ligne pour le revalider en direct auprès de VIES, le forcer valide ou non valide, ou le supprimer.
Vérification TVA onglet Vérification
Un outil manuel pour valider n'importe quel numéro de TVA de l'UE à la demande, sans passer par une inscription client, une adresse ou une commande. Choisissez un pays par défaut (utilisé uniquement quand le numéro de TVA est saisi sans préfixe pays), saisissez le numéro et cliquez sur Vérifier : le résultat s'affiche immédiatement et est également enregistré dans l'Historique des validations.
Où le client le saisit Front-office
Le champ Numéro de TVA apparaît à côté de Société sur le formulaire d'inscription et sur le formulaire d'adresse (Mon compte → Adresses), comme n'importe quel autre champ d'adresse PrestaShop. Il est facultatif : les clients qui le laissent vide sont simplement traités comme des particuliers, sans exonération appliquée.
3. Vérifiez que ça fonctionne
- Inscrivez-vous (ou passez commande) avec un numéro de TVA intracommunautaire valide d'un pays différent de celui de la boutique, puis vérifiez que la commande n'affiche pas de TVA (autoliquidation appliquée) et que le client a rejoint le groupe B2B.
- Saisissez un numéro de TVA non valide et vérifiez qu'il est rejeté (ou, avec le réglage souple, enregistré comme avertissement) et qu'aucune exonération n'est accordée.
- Ouvrez l'onglet Historique des validations et vérifiez que chaque tentative est listée avec son statut (valide / non valide / non vérifiable / format incorrect).
- Utilisez l'onglet Vérification TVA pour valider à la demande n'importe quel numéro de TVA de l'UE directement auprès de VIES.
4. Foire aux questions
Que se passe-t-il si VIES est temporairement hors service ?
Le client n'est jamais bloqué. Le numéro est marqué « non vérifiable » et recontrôlé plus tard. Vous choisissez dans la Configuration de rester silencieux ou d'afficher un message « impossible de vérifier, nouvelle tentative ».
Un numéro de TVA de mon propre pays est-il exonéré ?
Non. L'exonération pour autoliquidation ne s'applique qu'aux ventes intracommunautaires : un numéro de TVA valide d'un pays de l'UE différent de celui de la boutique. Les ventes nationales conservent leur TVA normale.
Dois-je modifier mon thème ?
Non. B2B VAT fonctionne via les hooks standards et est compatible avec n'importe quel thème.
Puis-je corriger une validation manuellement ?
Oui. Dans l'Historique des validations, vous pouvez revalider un enregistrement en direct auprès de VIES, le forcer valide ou non valide, ou le supprimer.