KvK-opzoek

Elk Nederlands bedrijf heeft een KvK-nummer — het 8-cijferige
registratienummer toegekend door de Kamer van Koophandel. Deze module
voegt een eenkliks-opzoek toe die de officiële gegevens uit het KvK-
register ophaalt en uw Klant- of Leverancier-record vult.

Wat wordt ingevuld

Klik op Lookup KvK op een Klant- of Leverancier-formulier nadat u het
KvK-nummer heeft ingevuld, en u krijgt:

• Statutaire naam
• Eventuele handelsnaam
• Geregistreerd adres (straat, postcode, plaats)
• Activiteit-classificatie (SBI-code)
• Oprichtingsdatum en rechtsvorm (BV, eenmanszaak, VOF, enz.)
• Status (actief / opgeheven / opgeschort)

Deze waarden komen in de bijbehorende ERPNext-velden plus het primaire
Adres van de Klant of Leverancier terecht.

Zoeken op naam

Geen KvK-nummer? Klik dan op Search KvK en typ een deel van de
bedrijfsnaam. De dialoog toont overeenkomende bedrijven; kies een en
het formulier vult alles in, inclusief het KvK-nummer.

Configuratie

KvK-opzoek gebruikt de overheid.io OpenKvK API,
die de officiële KvK-datafeed doorverkoopt. U heeft een API-sleutel
nodig:

1. Registreer u bij overheid.io. De gratis tier
   geeft alleen testdata.
2. Open Netherlands Localization Settings in ERPNext.
3. Vink Enable KvK Lookup aan en plak de API-sleutel in het
   wachtwoordveld. Sla op.

Prijs

overheid.io rekent per opzoek-tier. Vanaf 2026 is het Small-abonnement
ongeveer €150/jaar voor 2.500 opzoekingen/maand — voldoende voor de
meeste MKB's die wekelijks een paar nieuwe B2B-klanten aanmaken. Zwaarder
gebruik vraagt om een hoger abonnement; check overheid.io voor actuele
prijzen.

Beperkingen

• Alleen Nederlandse bedrijven. Internationale klanten verschijnen
  niet; gebruik daarvoor de EU VIES-BTW-nummer-validator (geen onderdeel
  van deze module).
• Opzoekingen worden niet als volledige snapshot opgeslagen. Als KvK-
  data verandert (een handelsnaam-update, een adresverhuizing), moet u
  de opzoek opnieuw uitvoeren — ERPNext merkt dit niet vanzelf. Plan een
  periodieke vernieuwing voor actieve klanten als versheid voor compliance
  belangrijk is.
• Knoppen verborgen indien niet geconfigureerd. Is de API-sleutel
  niet ingesteld op Netherlands Localization Settings, dan blijven de
  knoppen verborgen — het formulier valt u niet lastig met een functie
  die u niet kunt gebruiken.

En het BTW-nummer?

KvK-nummer ≠ BTW-nummer. Het BTW-nummer wordt apart afgegeven door de
Belastingdienst. ERPNexts standaard tax_id-veld is waar het BTW-nummer
hoort; het KvK-nummer staat in het custom_kvk_number-veld dat deze
module toevoegt.

Validatie van het BTW-nummer tegen EU VIES is een aparte functie op de
roadmap.