Documentation

Aan de slag > Vereisten

Aan de slag

Vereisten

Controleer voordat je de EU VAT & VIES Checker installeert of je WooCommerce-webshop aan deze technische vereisten voldoet. Deze controle van 5 minuten voorkomt installatieproblemen en zorgt voor betrouwbare btw-validatie vanaf de eerste dag.

Wat je nodig hebt Minimale versie Zo controleer je het
WordPress 6.5 of nieuwer Controleer je WordPress-versie
WooCommerce 9.0 of nieuwer Controleer je WooCommerce-versie
PHP 8.1 of nieuwer Controleer je PHP-versie
PHP SOAP-extensie Moet ingeschakeld zijn Controleer of SOAP beschikbaar is
HTTPS / SSL Vereist Controleer of HTTPS actief is
Uitgaande verbindingen VIES + Swiss UID-endpoints Test API-bereikbaarheid
BridgeSync-licentie Geldige, actieve licentie Bekijk je licenties

Wat elke vereiste betekent

WordPress 6.5 of nieuwer

WordPress is het contentmanagementsysteem waarop je website draait. BridgeSync vereist WordPress 6.5 of hoger om correct te functioneren.

Waarom dit belangrijk is: WordPress 6.5 bevat essentiële beveiligingsupdates en prestatieverbeteringen waar BridgeSync op vertrouwt. Oudere versies kunnen compatibiliteitsproblemen of beveiligingsrisico's veroorzaken.

WooCommerce 9.0 of nieuwer

WooCommerce is de e-commerceplugin die je webshop aanstuurt. Als je al producten verkoopt via WordPress, heb je WooCommerce geïnstalleerd.

Waarom dit belangrijk is: WooCommerce 9.0 introduceerde het Checkout Blocks-systeem dat BridgeSync volledig ondersteunt. De plugin werkt met zowel de klassieke checkout als de nieuwere block-checkout.

PHP 8.1 of nieuwer

PHP is de servertaal waarop WordPress draait. Je hostingprovider bepaalt welke PHP-versie je site gebruikt.

Waarom dit belangrijk is: PHP 8.1 is aanzienlijk sneller en veiliger dan oudere versies. BridgeSync maakt gebruik van moderne PHP-functies die niet beschikbaar zijn in PHP 7.x. Het gebruik van verouderde PHP levert bovendien beveiligingsrisico's op voor je hele webshop.

PHP SOAP-extensie

SOAP is een PHP-extensie waarmee je server kan communiceren met de EU VIES-database. De meeste hostingproviders hebben dit standaard ingeschakeld, maar sommige budgethosts schakelen het uit.

Waarom dit belangrijk is: Zonder de SOAP-extensie kan BridgeSync geen btw-nummers valideren tegen de officiële EU-database. De plugin toont een foutmelding op het Dashboard als SOAP ontbreekt.

HTTPS / SSL-certificaat

HTTPS versleutelt de verbinding tussen je website en je bezoekers. Het wordt weergegeven als een slotje in de adresbalk van de browser.

Waarom dit belangrijk is: De VIES- en Swiss UID-API's vereisen beveiligde verbindingen. Zonder HTTPS kunnen API-verzoeken mislukken of worden geblokkeerd. De meeste WooCommerce-webshops hebben HTTPS al ingeschakeld omdat dit vereist is voor betalingsverwerking.

Uitgaande verbindingen naar VIES en Swiss UID

Je server moet verbinding kunnen maken met externe API's om btw-nummers te valideren:

  • VIES: https://ec.europa.eu/taxation_customs/vies/checkVatService.wsdl
  • Swiss UID: https://www.uid-wse.admin.ch/V3.0/PublicServices.svc?wsdl

Waarom dit belangrijk is: Sommige firewalls of beveiligingsplugins blokkeren uitgaande verbindingen. Als validatie altijd mislukt, is dit vaak de oorzaak.

Zo controleer je je WordPress-versie

  1. Log in op je WordPress-beheerdashboard
  2. Kijk rechtsonder op een willekeurige beheerpagina
  3. Je ziet "WordPress X.X.X" (bijvoorbeeld "WordPress 6.5.3")

Moet je updaten? Ga naar Dashboard → Updates en klik op "Update Now" als er een nieuwere versie beschikbaar is.

Zo controleer je je WooCommerce-versie

  1. Ga naar Plugins → Installed Plugins
  2. Zoek "WooCommerce" in de lijst
  3. Het versienummer staat onder de pluginnaam

Zo controleer je je PHP-versie

  1. Ga naar Tools → Site Health
  2. Klik op het tabblad Info
  3. Vouw het onderdeel Server uit
  4. Zoek naar "PHP version"

PHP moet worden geüpgraded? Neem contact op met je hostingprovider. De meeste hosts bieden de mogelijkheid om van PHP-versie te wisselen via hun configuratiepaneel (cPanel, Plesk, etc.) of via een supportticket.

Zo controleer je of PHP SOAP beschikbaar is

Na het installeren van BridgeSync is de eenvoudigste manier om dit te controleren via het plugindashboard:

  1. Ga naar EU VAT Checker → Dashboard
  2. Kijk bij het onderdeel Environment Status
  3. Controleer dat "PHP SOAP extension" ✓ Available toont

Wordt het als niet beschikbaar getoond? Neem contact op met je hostingprovider en vraag hen de PHP SOAP-extensie in te schakelen.

Zo controleer je of HTTPS actief is

Kijk naar de URL van je website in de adresbalk van je browser:

  • ✓ Correct: https://jouwwebshop.nl (met slotje)
  • ✗ Incorrect: http://jouwwebshop.nl (geen slotje, of "Niet beveiligd"-waarschuwing)

HTTPS nodig? De meeste hostingproviders bieden gratis SSL-certificaten via Let's Encrypt. Kijk in je hostingconfiguratiepaneel of neem contact op met support.

Zo test je de API-bereikbaarheid

Na het installeren van BridgeSync:

  1. Ga naar EU VAT Checker → Dashboard
  2. Kijk bij het onderdeel Environment Status
  3. Controleer dat beide ✓ 200 OK tonen:
    • VIES WSDL reachability
    • Swiss UID reachability

Als een van beide een fout toont, heeft je server mogelijk firewallbeperkingen. Neem contact op met je hostingprovider en vraag hen uitgaande HTTPS-verbindingen toe te staan naar de hierboven genoemde URL's.

Belangrijk: cachingplugins

Checkoutpagina's mogen nooit worden gecachet. Als btw-validatie inconsistent werkt, zie Cacheproblemen voor stappen om het probleem op te lossen.

Niet zeker of je site aan de vereisten voldoet?

Geen zorgen — installeer gewoon de plugin. BridgeSync controleert automatisch alle vereisten en toont duidelijke waarschuwingen op het Dashboard als er iets aandacht nodig heeft.

Of neem contact op met ons supportteam en we controleren je configuratie gratis.