PS PrestaShop Gemiddeld

Intracommunautaire btw-controle VIES & Verlegging van heffing B2B

VIES-controle, btw-verlegging gekoppeld aan het leveringsland en het onveranderlijke bewijslogboek installeren en configureren.

Bijgewerkt Moduleversie 1.1.1

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.eu vanaf 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

  1. Open in het back-office Modules > Modulebeheer > Een module uploaden.
  2. Selecteer het ZIP-bestand en start de installatie.
  3. Klik op Configureren.

De installatie maakt het raadplegingslogboek aan en een tabblad VIES B2B-logboek onder het menu Bestellingen.

PrestaShop-module voor btw-controle via VIES: statistieken van raadplegingen, diagnose en cron-URL voor hervalidatie
Bovenaan de configuratiepagina: statistieken van de afgelopen 30 dagen, diagnose en de cron-URL.

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.

B2B-afrekenproces: 0 € btw dankzij de intracommunautaire btw-verlegging
Italiaanse klant met een door VIES gevalideerd nummer, levering in Italië: de winkelwagen zonder btw.

Configuratie

Module-instellingen: eigen btw-nummer, automatische vrijstelling (btw-verlegging), blokkeren van ongeldige nummers, B2B-groep
Alle instellingen van de module, hieronder beschreven.

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.

Registratieformulier: intracommunautair btw-nummer in realtime gevalideerd door VIES
Registratie: VIES valideert het nummer tijdens het typen, met de bedrijfsnaam.
Registratieformulier: btw-nummer niet herkend door VIES, gemeld aan de klant
Een nummer dat VIES niet herkent, wordt direct aan de klant gemeld.
Klantadres met een door VIES gevalideerd intracommunautair btw-nummer
Dezelfde badge in het adresformulier van het klantaccount.

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.

PDF-factuur zonder btw met de wettelijke vermelding btw verlegd (art. 138 en 196) en het VIES-raadplegingsnummer
De vermelding onder de totalen van een factuur zonder btw, met datum en nummer van de VIES-raadpleging.

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.

Logboek met tijdstempel van VIES-raadplegingen met officieel raadplegingsnummer, bewijs bij een belastingcontrole
Het VIES B2B-logboek: elke raadpleging, de bron, het officiële nummer en de bestellingen zonder btw.

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.

B2B-bestelling zonder btw gefactureerd (btw-verlegging) met het VIES-bewijs opgeslagen in de PrestaShop-backoffice
Het VIES-paneel van de bestelling: gevalideerd nummer, officieel raadplegingsnummer en facturatie zonder btw.

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.

Was deze pagina nuttig?

Loopt u nog vast? Neem contact op met support