Shopware 6

Wat het doet

Verkoopt u aan Nederlandse en Belgische bedrijven? Laat de klant het btw-nummer intikken, de rest vult zichzelf in.

De plugin controleert het btw-nummer zoals klanten het echt intikken (met of zonder landcode, spaties of punten), eerst offline en daarna bij het EU-btw-register (VIES). Voor Nederlandse en Belgische bedrijven vult hij de geregistreerde bedrijfsnaam en het adres in. Nederlandse adressen komen uit postcode + huisnummer (PDOK, het adressenregister van de overheid), Belgische straten worden voorgesteld op basis van de postcode (BeST). Dit alles werkt zonder API-sleutel of extra abonnement.

Klanten worden nooit gestraft voor een trage overheidsdienst: ligt VIES eruit, dan gaat de bestelling gewoon door en wordt de klant voor u gemarkeerd. Niets wat de klant heeft ingetikt wordt zonder te vragen overschreven, en elk ingevuld veld blijft bewerkbaar.

Voor Nederlandse B2B-winkels kan de plugin ook het KvK-nummer opzoeken met uw eigen KvK API-sleutel. Probeer het eerst gratis in de KvK-testomgeving; live opzoeken is de optionele upgrade KvK live in de plugin.

In de administratie ziet u de btw- en KvK-status bij elke klant en bestelling, een logboek dat elke opzoeking in gewone woorden uitlegt, en per dienst een knop “Verbinding testen”.

Kenmerken

• Btw-controle via VIES voor alle EU-landen, eerst offline controlecijfer (ook de nieuwe NL-nummers sinds 2020)
• Bedrijfsnaam en adres automatisch ingevuld uit VIES voor NL en BE
• Gratis postcode + huisnummer opzoeken (PDOK), met keuze voor toevoeging en handmatige invoer
• Gratis Belgische straatsuggesties en adrescontrole (BeST), Nederlandse/Franse straatnamen
• Optioneel KvK-nummer opzoeken met eigen sleutel: testmodus gratis, live met de upgrade KvK live
• Blokkeert nooit het afrekenen als VIES niet bereikbaar is: accepteren en markeren (of “niet geregistreerd” weigeren, uw keuze)
• Btw/KvK-status, datum en VIES-raadplegingsnummer bij klant en bestelling
• Logboek met redenen in gewone woorden, verbindingstest per dienst
• Controle op de server bij registratie; werkt ook bij gastbestellingen en in het adresboek
• Toegankelijk: suggestielijsten met het toetsenbord te bedienen, geen voorbarige foutmeldingen
• Nederlands, Engels en Duits; Shopware 6.6 en 6.7

Prijs

€ 4,95 per maand voor alles: btw-controle, automatisch invullen, NL-postcode, BE-straten, beheertools en de KvK-testmodus. Live KvK-opzoekingen zijn een in-app upgrade, KvK live, voor € 3,00 per maand extra (€ 7,95 per maand in totaal). U koopt hem in de configuratie van de plugin wanneer u hem nodig hebt, hij gaat mee op uw Shopware-factuur en is op elk moment opzegbaar. Zonder upgrade wordt niets verwijderd: uw KvK-sleutel en instellingen blijven, alleen live opzoeken pauzeert.

Installeren

Dit deel is alleen in het Engels beschikbaar.

1. Upload the zip in Extensions → My extensions → Upload extension (or put it in custom/plugins and run bin/console plugin:refresh).
2. Install and activate. Compile the theme if your shop does not do so automatically (bin/console theme:compile).
3. Open the configuration and click Test connection for each service.

Requirements: Shopware 6.6.9+ or 6.7 (in-app purchases, DECISIONS D-39), PHP as required by Shopware. KvK live mode is the in-app upgrade kvk-live; test mode and everything else work without it. No Composer dependencies beyond Shopware.

Instellen

Dit deel is alleen in het Engels beschikbaar.

• Settings per sales channel (Extensions → My extensions → VAT & Company Autofill → Configure), with a Test connection button per service and a step-by-step “get your own KvK key” guide with the KvK calls per month.
• A VAT/KvK status card on the customer and the order (status, date, source, VIES request identifier).
• A lookup log (Settings → Extensions → NL/BE lookup log) with the reason for each result in plain words.
• A Copy diagnostics button (Support card in the configuration) for support mails, without keys.
• Outage policy: a VIES outage is accepted and flagged, never a blocked customer. “Not registered” can be set to reject. Server-side re-check on registration and address changes; client flags are never trusted.

KvK: uw eigen API-sleutel

De KvK staat geen gedeelde API-sleutel toe, en KvK-gegevens mogen niet tussen winkels worden doorgegeven. Daarom gebruiken KvK-opzoekingen uw eigen KvK API-abonnement (€ 6,20 per maand bij de KvK in oktober 2026, mogelijk per API; een nummer opzoeken is gratis, het optionele volledige adres kost € 0,02 per opvraging). In de configuratie staat een stappenplan: waar u de sleutel aanvraagt, wat hij kost, waar u hem plakt, en een knop om hem te testen vóór het opslaan. Zonder sleutel is het KvK-veld gewoon verborgen; btw-, postcode- en straatopzoekingen werken normaal. KvK-resultaten worden alleen in uw eigen winkel bewaard.

Privacy

Alleen het nummer of de postcode wordt verstuurd: het btw-nummer naar VIES, postcode en huisnummer naar PDOK, postcode en straat naar BeST, het KvK-nummer naar de KvK. Alle opvragingen gaan via uw winkelserver; de storefront laadt geen scripts van derden en zet geen cookies. Uw KvK-sleutel staat op de server en gaat nooit naar de browser. Het logboek bewaart invoer gemaskeerd en verwijdert die na 30 dagen (instelbaar, hoogstens 180 dagen).

Support

We ondersteunen de plugin, niet uw hosting of serverinrichting. Hulp nodig? Open in de pluginconfiguratie de kaart Support, klik op Diagnose kopiëren en plak de tekst in uw supportvraag. Daarin staan de versies van plugin, Shopware en PHP, de status van elke dienst en de laatste mislukte opzoekingen (gemaskeerd); uw API-sleutel en volledige klantnummers staan er nooit in.

Problemen oplossen

• Elke “Verbinding testen” mislukt: uw server kan het internet niet bereiken via HTTPS (firewall, proxy of geblokkeerd uitgaand verkeer). Vraag uw hostingpartij om uitgaand HTTPS toe te staan.
• “Niet te controleren” bij een btw-nummer: VIES of het nationale register is druk. De klant kan verder; het nummer wordt gemarkeerd en kan later opnieuw worden gecontroleerd.
• Geen postcode- of straatsuggesties: controleer of de NL/BE-adresopties aan staan, compileer het thema (bin/console theme:compile) en leeg de cache.
• Geen KvK-veld: de KvK-modus staat uit, of de live-modus is gekozen zonder de upgrade “KvK live”.
• “Te veel opzoekingen”: verhoog de limieten per minuut of per dag in de configuratie.

Veelgestelde vragen

Heb ik een API-sleutel nodig?

Nee. VIES, PDOK en BeST zijn gratis publieke diensten. Alleen de KvK-opzoeking heeft uw eigen KvK API-sleutel nodig; de testomgeving van de KvK werkt zonder.

Welke landen worden ondersteund?

Nederland en België: btw-controle met het invullen van bedrijfsgegevens, Nederlandse postcode + huisnummer en Belgische straatsuggesties. De btw-controle zelf werkt voor elk Europees btw-nummer.

Wat gebeurt er als VIES onbereikbaar is?

De klant kan verder. De bestelling en de klant krijgen “kon niet worden gecontroleerd”, en u ziet dat bij de bestelling, bij de klant en in het opzoeklog.

Verandert het mijn btw-instellingen?

Alleen als u de btw-vrijstelling (verlegging) voor geldige zakelijke klanten in een ander EU-land aanzet. Die staat standaard uit. U bepaalt zelf de btw-behandeling van uw verkopen.

Worden de gegevens van mijn klanten naar codesaur gestuurd?

Niet bij de plugins die u op uw eigen server installeert (Shopware, WooCommerce, Magento, PrestaShop): die praten rechtstreeks met de publieke diensten. De gehoste apps (Shopify, Lightspeed) draaien op onze server in de EU, als uw verwerker. Zie externe diensten en de privacyverklaring.