Prestashop module NW VAT Number

Description

Module PrestaShop 1.7.8.11+ pour la gestion moderne de la TVA intracommunautaire (B2B UE), base sur le module historique vatnumber.

• valider le numero de TVA intracom via VIES (SOAP officiel),
• appliquer une exoneration de TVA quand les conditions B2B intra-UE sont reunies,
• rester compatible avec les mecanismes de calcul taxe PrestaShop 1.7.8.11 et superieur.

Lors de la validation d’une adresse client, le module :

• normalise le numero (suppression des espaces/caracteres non alphanumeriques),
• appelle VIES via SOAP : https://ec.europa.eu/taxation_customs/vies/checkVatService.wsdl,
• refuse un numero invalide,
• n’interrompt pas la validation de l’adresse si VIES est temporairement indisponible (mode fail-open).

Le module branche un TaxManager qui force un taux de TVA 0% si :

• un numero de TVA est present sur l’adresse fiscale utilisee,
• le pays client est dans la liste UE supportee,
• le pays client est different du pays boutique configure dans le module,
• la gestion TVA du module est activee.

PrestaShop 1.7 utilise encore des cles legacy (VATNUMBER_*) dans certaines portions du coeur. Le module synchronise automatiquement :

• NWVATNUMBER_MANAGEMENT -> VATNUMBER_MANAGEMENT
• NWVATNUMBER_COUNTRY -> VATNUMBER_COUNTRY
• NWVATNUMBER_CHECKING -> VATNUMBER_CHECKING

Cela garantit un comportement coherent dans tout le checkout.

• PrestaShop : >= 1.7.8.11
• PHP : compatible avec la stack PS 1.7.8 (SOAP requis pour test/validation VIES)
• Hook fiscal : priorite geree pour fonctionner avec le hook canonique resolu par PrestaShop (actionTaxManager / alias taxManager)

1. Copier le dossier nwvatnumber dans modules/.
2. Installer le module dans le BO PrestaShop.
3. Ouvrir la configuration du module.
4. Verifier :
   • pays boutique pour comparaison TVA,
   • activation de la validation VIES.
5. Vider le cache PrestaShop (var/cache/dev et var/cache/prod).

Parametres disponibles :

• Pays de la boutique pour la comparaison TVA
• Activer la validation TVA via VIES
• Test de connexion VIES (bouton de diagnostic)

1. Activer les taxes globales PrestaShop.
2. Verifier que la base taxe est sur l’adresse de livraison (ou facture selon votre besoin).
3. Creer/editer une adresse client UE avec :
   • entreprise renseignee,
   • numero TVA intracom valide.
4. Tester avec un nouveau panier.
5. Controle attendu :
   • prix HT conserves,
   • TVA finale a 0% en cas B2B intra-UE valide.

Certains modules de livraison peuvent forcer une TVA locale selon le transporteur selectionne. nwvatnumber detecte ces cas et se desactive sur ce panier pour eviter les conflits fiscaux.

• Verifier extension PHP SOAP activee.
• Tester le bouton Test de connexion VIES dans la config du module.
• Verifier acces sortant HTTPS vers le domaine VIES (firewall/proxy).

• Verifier qu’un seul module TVA est actif (nwvatnumber).
• Vider cache PrestaShop.
• Refaire le test avec un nouveau panier.
• Verifier l’adresse reellement utilisee pour la taxe (PS_TAX_ADDRESS_TYPE).
• Verifier le transporteur selectionne (certains modules forcent une TVA locale).

• nwvatnumber.php : module principal, configuration BO, validation adresse, synchro legacy.
• NwvatnumberTaxManager.php : logique d’exoneration fiscale.
• translations/*.php : traductions.
• config.xml : metadonnees module.