Intracommunautaire btw-controle VIES & Verlegging van heffing B2B
VIES-controle, btw-verlegging gekoppeld aan het leveringsland en het onveranderlijke bewijslogboek installeren en configureren.
Deze module controleert intracommunautaire btw-nummers in de VIES-database van de Europese Commissie, past btw-verlegging (factuur met 0 % btw) toe op B2B-verkopen die naar een andere lidstaat worden geleverd, en bewaart een bewijslogboek met tijdstempel: het stuk dat de belastingdienst bij een controle opvraagt.
De belangrijkste instelling is uw eigen btw-nummer. Zonder dit nummer geeft VIES geen officieel raadplegingsnummer uit, het sterkste bewijs bij een controle.
Vereisten
- PrestaShop 8.0 tot 9.x, één winkel of multistore.
- PHP 7.4 tot 8.3 (PrestaShop 9 vereist PHP 8.1 of hoger). De SOAP-extensie wordt aanbevolen; zonder die extensie gebruikt de module de REST-API van VIES.
- Uitgaande HTTPS-toegang tot
ec.europa.euvanaf uw server. - Het veld Btw-nummer moet in het adresformaat staan van de EU-landen waarnaar u levert. De configuratiepagina toont de landen waar het ontbreekt.
Installatie
- Open in het back-office Modules > Modulebeheer > Een module uploaden.
- Selecteer het ZIP-bestand en start de installatie.
- Klik op Configureren.
De installatie maakt het raadplegingslogboek aan en een tabblad VIES B2B-logboek onder het menu Bestellingen.

Bijwerken vanaf 1.1.0
Upload het ZIP-bestand 1.1.1 over het oude. Deze versie verhelpt een fout waardoor de btw-verlegging niet werd toegepast op PrestaShop 8 en 9: het updatescript koppelt de module aan de juiste hook voor de belastingberekening (actionTaxManager). Uw instellingen en het logboek blijven behouden. Gebruikt u 1.1.0, werk dan meteen bij: op deze PrestaShop-versies werden intracommunautaire B2B-bestellingen nog met btw gefactureerd.
Bijwerken vanaf 1.0.0
Upload het nieuwe ZIP-bestand over het oude. Het updatescript voegt de nieuwe logboekkolommen toe, registreert de nieuwe hooks en vervangt de standaardvermeldingen op de factuur, tenzij u die had aangepast. Het bestaande logboek blijft bewaard.
Hoe de module over de vrijstelling beslist
Een bestelling gaat alleen naar 0 % btw als aan al deze voorwaarden is voldaan:
- de vrijstelling is ingeschakeld in de configuratie;
- de klant heeft een btw-nummer uit een andere lidstaat dan de uwe;
- de goederen worden geleverd in een andere lidstaat dan de uwe;
- VIES heeft het nummer bevestigd binnen de gekozen geldigheidsduur.
Voorbeeld: uw winkel is in Nederland gevestigd, een klant heeft een Duits btw-nummer maar laat in Utrecht leveren. De verkoop blijft onderworpen aan Nederlandse btw.
Gebruikt wordt het btw-nummer van het adres waarop de winkel de belastingen berekent (PrestaShop-instelling, standaard het afleveradres). Heeft dat adres geen nummer, dan wordt dat van het factuuradres van dezelfde bestelling gebruikt. Het leveringsland wordt altijd gecontroleerd, ook als de winkel de belastingen op het factuuradres berekent.
Voor Noord-Ierland, in PrestaShop vastgelegd als Verenigd Koninkrijk, wordt een XI-nummer aanvaard voor een adres met een postcode die met BT begint.

Configuratie

Btw-nummer van de verkoper
Voer het btw-nummer van uw bedrijf in met landcode. Elke controle raadpleegt VIES dan met een aanvrager-ID en ontvangt een officieel raadplegingsnummer met tijdstempel. Weigert VIES uw nummer, dan worden uw klanten zonder officieel nummer gecontroleerd en meldt een rode melding dit.
Land van de verkoper
Uw lidstaat. Een btw-nummer uit dat land, of een levering in dat land, geeft nooit recht op vrijstelling.
Automatische vrijstelling
Uitgeschakeld blijven controle en logboek werken, maar de belasting wordt nooit gewijzigd. Handig voor een observatieperiode.
Ongeldige btw-nummers blokkeren
Ingeschakeld wordt het adres- of registratieformulier geweigerd als VIES het nummer ongeldig verklaart of het formaat onjuist is.
Als VIES niet beschikbaar is
- Accepteren (standaard): het adres wordt zonder vrijstelling opgeslagen tot VIES het bevestigt.
- Blokkeren: het formulier wordt geweigerd.
In beide gevallen behoudt een klant van wie het bewijs nog binnen de geldigheidsduur valt de vrijstelling tijdens de storing.
Live controle en registratieveld
De live controle toont tijdens het typen een badge onder het btw-veld. Het registratieveld voegt een optioneel btw-nummer toe aan het aanmaken van een account en aan de pagina met persoonsgegevens. Dat nummer wordt in het profiel bewaard en vooraf ingevuld in nieuwe adressen van de klant.



B2B-klantengroep
Optioneel: klanten met een door VIES gevalideerd nummer worden automatisch aan deze groep toegevoegd.
Cache, geldigheid en hervalidatie
- Cache van raadplegingen (standaard 72 uur): een nummer dat onlangs geldig is bevonden, wordt niet opnieuw opgevraagd. Een negatief antwoord wordt na een uur opnieuw opgevraagd, omdat een net toegekend nummer een paar dagen nodig kan hebben om in VIES te verschijnen. De cache gaat nooit verder dan de geldigheidsduur.
- Geldigheidsduur (standaard 90 dagen): daarna stopt de vrijstelling tot een nieuwe controle. De module controleert automatisch opnieuw bij het openen van de checkout.
- Hervalidatie-interval (standaard 30 dagen): leeftijd vanaf wanneer de cron een nummer opnieuw controleert.
- Limiet live controles (20 per uur en per IP): beschermt VIES en uw winkel tegen misbruik.
Wettelijke vermelding op de factuur
Aanpasbare tekst per taal, met de variabelen %vat% (nummer van de klant), %date% (datum van de VIES-raadpleging, in het formaat van de klanttaal), %consultation% (officieel raadplegingsnummer) en %name% (bedrijfsnaam). Een leeg veld neemt de eerst ingevoerde tekst over.

Het bewijslogboek
Elke raadpleging staat in Bestellingen > VIES B2B-logboek: datum, land, nummer, resultaat, status, bron (adres, checkout, registratie, live controle, bestelbewijs, handmatig, cron), bedrijfsnaam, raadplegingsnummer, bestelling, kolom Zonder btw, klant en IP.
Het logboek is alleen-lezen. Verwijderen en wijzigen worden op de server geweigerd en de tabel blijft bewaard bij het verwijderen van de module.

Bestelbewijs
Bij het valideren van elke intracommunautaire bestelling wordt een regel Bestelbewijs toegevoegd. Die verwijst naar de VIES-raadpleging waarop de vrijstelling berust en geeft aan of de bestelling zonder btw is gefactureerd. Deze regel telt nooit als nieuwe raadpleging. Het VIES-paneel op de bestelpagina toont de raadplegingsdatum, de bedrijfsnaam en het officiële nummer.

CSV-export
De exportknop maakt een CSV met alle kolommen, inclusief de datum van het VIES-verzoek, het bedrijfsadres, de foutcode en de ID van de bronraadpleging.
Automatische hervalidatie (cron)
De configuratiepagina toont een met een token beveiligde cron-URL. Roep die eenmaal per dag aan. Elke run verwerkt tot 25 nummers: die met een oud VIES-antwoord en die waarop VIES niet kon antwoorden. Valt VIES uit, dan stopt de run netjes.
0 4 * * * curl -s "https://uw-winkel/index.php?fc=module&module=dfviesb2b&controller=cron&token=UW_TOKEN" > /dev/null
VIES-storingen
Elke oproep is beperkt tot 8 seconden. Antwoordt SOAP niet, dan probeert de module de REST-API. Na een storing raadpleegt de module VIES vijf minuten niet, zodat de checkout niet vertraagt. Het valideren van een bestelling roept VIES alleen aan voor een nummer dat nooit is gecontroleerd.
AVG
Met de module psgdpr kan een klant zijn raadplegingen exporteren. Een verzoek tot verwijdering wist het in het profiel opgeslagen nummer en zijn IP-adressen uit het logboek. De fiscale bewijzen zelf blijven bewaard, zoals artikel 17, lid 3, onder b) AVG toestaat voor wettelijke verplichtingen.
Probleemoplossing
Er verschijnt geen raadplegingsnummer
Controleer of uw btw-nummer als verkoper is ingevuld en of er geen rode melding over een weigering door VIES staat.
De klant kan geen btw-nummer invullen
Het veld ontbreekt in het adresformaat van zijn land. Voeg vat_number toe via Internationaal > Locaties > Landen.
De vrijstelling wordt niet toegepast
Controleer de vier voorwaarden hierboven, vooral het leveringsland, en bekijk de laatste logboekregel voor dat nummer.
De badge blijft op VIES niet beschikbaar
VIES heeft storingen. Controleer ook of uw server ec.europa.eu via HTTPS kan bereiken. De cron haalt ongecontroleerde nummers in.
Deze module automatiseert controle, vrijstelling en bewijsvoering. Ze vervangt uw accountant niet: u blijft verantwoordelijk voor uw fiscale verplichtingen.