B2B VAT - VIES-validatie & intracommunautaire btw-verlegging. B2B VAT controleert EU-btw-nummers bij de officiële VIES-dienst, past automatisch de btw-vrijstelling door btw-verlegging binnen de EU toe en wijst geldige B2B-klanten toe aan een instelbare groep. De module bevat een validatiecache, een geschiedenis in het back-office met handmatige overschrijving en een handmatig hulpmiddel om btw-nummers op te zoeken. Geen programmeerwerk, geen aanpassingen aan het thema.
B2B VAT controleert EU-btw-nummers bij de officiële VIES-dienst, past automatisch de btw-vrijstelling door btw-verlegging binnen de EU toe en wijst geldige B2B-klanten toe aan een instelbare groep. De module bevat een validatiecache, een geschiedenis in het back-office met handmatige overschrijving en een handmatig hulpmiddel om btw-nummers op te zoeken. Geen programmeerwerk, geen aanpassingen aan het thema.
1. Installatie
- Ga in het back-office naar Modules → Module Manager → Upload a module en selecteer de ZIP van de module.
- Klik na de installatie op Configure om het instellingenscherm te openen.
.local, .test, localhost) zijn altijd toegestaan. Zodra er een nieuwe versie beschikbaar is, wordt dit direct in de module getoond.Als u in plaats van de bevestiging de melding ‘Upload failed’ ziet, heeft PrestaShop de module mogelijk zonder bericht uitgeschakeld: uw instellingen en gegevens blijven behouden. Hoe u een module bijwerkt en wat u doet bij de melding ‘Upload failed’.
2. Configuratie · stap voor stap
Het back-office van de module heeft drie tabbladen: Validation history, VAT lookup en Settings. Alle opties staan op het tabblad Settings, gegroepeerd in Validation, Exemption & B2B group, Behaviour en Data.
Settings tabblad Settings
Stel in wanneer en hoe btw-nummers worden gecontroleerd, tot welke groep kwalificerende B2B-klanten gaan behoren en wat er gebeurt als een nummer ongeldig is of VIES niet bereikbaar is.
- Enable VAT validation: hoofdschakelaar voor de hele module.
- Validate on registration: controleer het btw-nummer wanneer een klant zich registreert.
- Validate on address create / edit: controleer het btw-nummer wanneer een adres wordt opgeslagen of gewijzigd.
- Validate at checkout: controleer het btw-nummer tijdens het afrekenen.
- Require the VIES trader name to match: verleen de vrijstelling alleen als de naam die VIES vrijgeeft overeenkomt met de naam van de klant of het bedrijf. Geeft VIES geen naam vrij, dan wordt de vrijstelling geweigerd (veilige keuze).
- B2B group: klanten met een door VIES gevalideerd intracommunautair btw-nummer worden aan deze groep toegevoegd. Stel de weergavemethode van prijzen van de groep in op exclusief belasting, zodat ze geen btw betalen (btw-verlegging).
- Apply tax-exempt to qualifying customers: verleen de vrijstelling door btw-verlegging (via de B2B-groep) wanneer de btw geldig is en het land in de EU ligt en afwijkt van het land van de webwinkel.
- Treat an invalid VAT as a hard error: als deze optie uitstaat (aanbevolen), levert een ongeldig btw-nummer alleen een waarschuwing op en wordt het vastgelegd; de klant wordt niet geblokkeerd.
- When VIES is unavailable: kies Allow (silent): never block the customer of Allow but show a “could not verify, will retry” notice. Het nummer wordt gemarkeerd als ‘niet verifieerbaar’ en later opnieuw gecontroleerd.
- Cache freshness (days): een resultaat (geldig of ongeldig) wordt dit aantal dagen hergebruikt voordat VIES opnieuw wordt bevraagd (bescherming tegen de aanvraaglimiet).
0schakelt de cache uit. - Drop data on uninstall: indien ingeschakeld, verwijdert het deïnstalleren van de module de volledige validatiegeschiedenis. Laat de optie uit om de gegevens bij een herinstallatie te behouden.
Validation history tabblad History
Elke btw-controle wordt hier vastgelegd: het btw-nummer, de status (Valid, Not valid, Not verifiable of Bad format), de handelsnaam die VIES teruggeeft (indien beschikbaar), de bron (een live VIES-aanvraag of de cache) en het tijdstip. Gebruik het zoekveld en het statusfilter om een record te vinden en gebruik daarna de acties op de rij om het live opnieuw bij VIES te valideren, het als geldig of ongeldig af te dwingen of het te verwijderen.
VAT lookup tabblad Lookup
Een handmatig hulpmiddel om elk EU-btw-nummer op verzoek te valideren, zonder dat er een klantregistratie, een adres of een bestelling voor nodig is. Kies een standaardland (alleen gebruikt als het btw-nummer zonder landvoorvoegsel wordt ingevoerd), typ het nummer en klik op Check: het resultaat wordt direct getoond en ook in de validatiegeschiedenis opgeslagen.
Waar klanten het invoeren Front-office
Het veld VAT number verschijnt naast Company in het registratieformulier en in het adresformulier (My account → Addresses), zoals elk ander adresveld van PrestaShop. Het is optioneel: klanten die het leeg laten, worden gewoon als gewone consumenten behandeld, zonder vrijstelling.
3. Controleer of het werkt
- Registreer u (of reken af) met een geldig intracommunautair btw-nummer uit een ander land dan dat van de webwinkel en controleer dat de bestelling geen btw toont (btw-verlegging toegepast) en dat de klant tot de B2B-groep is gaan behoren.
- Voer een ongeldig btw-nummer in en controleer dat het wordt geweigerd (of, bij de zachte instelling, als waarschuwing wordt vastgelegd) en dat er geen vrijstelling wordt verleend.
- Open het tabblad Validation history en controleer dat elke poging met haar status wordt vermeld (valid / invalid / not verifiable / bad format).
- Gebruik het tabblad VAT lookup om elk EU-btw-nummer op verzoek rechtstreeks bij VIES te valideren.
4. FAQ
Wat als VIES tijdelijk niet beschikbaar is?
De klant wordt nooit geblokkeerd. Het nummer wordt gemarkeerd als ‘niet verifieerbaar’ en later opnieuw gecontroleerd. In Settings kiest u of de module stil blijft of een melding ‘kon niet worden geverifieerd, wordt opnieuw geprobeerd’ toont.
Is een btw-nummer uit mijn eigen land vrijgesteld?
Nee. De vrijstelling door btw-verlegging geldt alleen voor verkopen binnen de EU: een geldig btw-nummer uit een EU-land dat afwijkt van het land van de webwinkel. Binnenlandse verkopen behouden hun normale btw.
Moet ik mijn thema aanpassen?
Nee. B2B VAT werkt via standaardhooks en is compatibel met elk thema.
Kan ik een validatie handmatig corrigeren?
Ja. In de Validation history kunt u een record live opnieuw bij VIES valideren, het als geldig of ongeldig afdwingen of het verwijderen.