Benodigde tijd: Ongeveer 10 minuten
Deze handleiding begeleidt je bij het instellen van btw-validatie. De installatiewizard regelt de meeste configuratie automatisch. Na afloop valideert je checkout btw-nummers in realtime en past automatisch 0% btw toe voor zakelijke bestellingen die daarvoor in aanmerking komen.
Voordat je begint
Zorg dat je het volgende bij de hand hebt:
- •Een WooCommerce-webshop die draait
- •HTTPS ingeschakeld op je website (vereist voor API-verzoeken aan VIES)
- •Je BridgeSync-licentiesleutel (zie je welkomstmail of je account)
Installeer de plugin
Duurt: Ongeveer 2 minuten
- Download het plugin-ZIP-bestand vanuit je BridgeSync-account
- Ga in WordPress naar Plugins → Add Plugin
- Klik bovenaan de pagina op Upload Plugin
- Kies het gedownloade ZIP-bestand en klik op Install Now
- Klik na de installatie op Activate Plugin
De installatiewizard start automatisch na activering. Gebeurt dit niet, ga dan naar EU VAT Checker → Setup Wizard in de WordPress-zijbalk.
Voer je licentiesleutel in
Duurt: Ongeveer 1 minuut
De installatiewizard opent op stap 1: License Key. Hier activeer je je BridgeSync-licentie.
- Zoek je licentiesleutel in de welkomstmail die je na aankoop hebt ontvangen, of in je BridgeSync-account onder Licenses
- Plak de licentiesleutel in het veld License Key (deze ziet eruit als
BS-XXXX-XXXX-XXXX-XXXX) - De wizard valideert je licentie automatisch — wacht op de groene bevestiging
- Je wordt automatisch doorgestuurd naar stap 2
Licentievalidatie mislukt?
- •Controleer of je de volledige licentiesleutel hebt gekopieerd, zonder ontbrekende tekens of extra spaties
- •Controleer of je een geldige, actieve licentie gebruikt (niet verlopen of al geactiveerd op een andere site)
- •Zorg dat je WordPress-site verbinding kan maken met het internet (vereist voor licentievalidatie)
Lukt het nog steeds niet? Neem contact op met ons supportteam en vermeld je licentiesleutel.
Btw-validatie-instellingen configureren
Duurt: Ongeveer 3 minuten
Stap 2 van de installatiewizard toont de btw-validatie-instellingen. De standaardwaarden werken goed voor de meeste webshops, maar hier lees je wat elke optie doet:
Validatie-instellingen
| Instelling | Wat het doet | Aanbevolen |
|---|---|---|
| Auto-check VAT number at checkout | Valideert btw-nummers tegen de EU VIES-database wanneer klanten afrekenen | ✓ Aan |
| Switzerland: Validate CHE number | Valideert ook Zwitserse ondernemingsnummers (CHE) via het Zwitserse UID-register | ✓ Aan (als je aan Zwitserland levert) |
| Apply 0% VAT for EU B2B customers | Verwijdert automatisch btw voor geldige intracommunautaire B2B-bestellingen (verlegging van btw) | ✓ Aan |
| Backup check when VIES is down | Gebruikt formaatvalidatie als terugvaloptie wanneer de VIES-database tijdelijk niet beschikbaar is | ✓ Aan |
Prestatie-instellingen
| Instelling | Wat het doet | Standaard |
|---|---|---|
| Validation wait time | Hoe lang er wordt gewacht op een reactie van VIES voordat de checkout verdergaat zonder validatie | 10 seconden |
| Remember results | Hoe lang een gevalideerd btw-nummer in de cache blijft voordat het opnieuw wordt gecontroleerd | 24 uur |
Controleer de instellingen en klik op Next Step om verder te gaan.
Installatie voltooid!
Duurt: Ongeveer 1 minuut
Stap 3 bevestigt dat alles correct is geconfigureerd. Je ziet een overzicht van de functies die nu zijn ingeschakeld:
- •✓ Licentie succesvol geactiveerd
- •✓ VIES API-integratie ingeschakeld
- •✓ Swiss UID API-integratie ingeschakeld
- •✓ Automatische btw-validatie geconfigureerd
- •✓ 0%-btw-regel toegepast voor intracommunautaire B2B-transacties
Klik op Go to Dashboard om het plugindashboard te openen, waar je de API-verbinding kunt testen en validaties kunt monitoren.
Test je configuratie
Duurt: Ongeveer 3 minuten
Testen vanuit het Dashboard
- Ga naar EU VAT Checker → Dashboard
- Zoek het onderdeel API Testing onderaan de pagina
- Voer een test-btw-nummer in:
NL123456789B01 - Klik op Test API
- Binnen enkele seconden zou je een validatieresultaat moeten zien
Testen vanuit de checkout
- Voeg een willekeurig product toe aan je winkelwagen
- Ga naar de checkout in een incognito-/privévenster
- Selecteer een EU-land als factureringsland
- Zoek het btw-nummerveld en voer een geldig btw-nummer in
- Na enkele seconden zou de validatiemelding moeten verschijnen
Je bent helemaal klaar
Btw-nummers worden nu automatisch gevalideerd tijdens het afrekenen. Zakelijke klanten uit andere EU-landen die daarvoor in aanmerking komen, zien automatisch 0% btw op hun bestelling.
Wat je hierna kunt doen