Koppelen met de KvK API (Open KvK)
Twee bronnen, één doel
Er zijn twee manieren om bij Nederlandse bedrijfsdata te komen. De officiële KvK API biedt volledige toegang tot het Handelsregister, is officieel gelicentieerd en geeft zekerheid over data-actualiteit. Voor commerciële toepassingen zoals klantonboarding, KYC-processen en juridische verificatie is dit de logische keuze. Kosten worden per bevraging in rekening gebracht.
Open KvK is een gratis alternatief dat een subset van dezelfde data ontsluit via een open API. Voor toepassingen waar volledigheid en 100% actualiteit niet doorslaggevend zijn (autocomplete-formulieren, snelle validatie tijdens registratie, KvK-nummer verificatie zonder juridische zwaarte) is Open KvK vaak voldoende én kostenefficient.
Voor de meeste projecten adviseren we een combinatie: Open KvK voor snelle publieke functies, KvK API voor de kritieke momenten waar volledigheid telt. Wij helpen die keuze maken op basis van jullie situatie.
Waar wij deze koppeling het meest bouwen
Op registratie- en aanmeldformulieren, waar een gebruiker het KvK-nummer intypt of zijn bedrijfsnaam begint te typen, en het systeem direct de correcte gegevens ophaalt. Naam, adres, rechtsvorm, activiteitcode: alles wordt automatisch ingevuld. Voor de klant is dit een fors betere ervaring dan alles handmatig invoeren, voor jullie is het minder foutgevoelig en betrouwbaarder. Werkt voor WordPress met Gravity Forms, Laravel, Nuxt en custom applicaties.
Voor CRM-verrijking en dataschoning is dit een van de sterkste toepassingen. Klantrecords worden verrijkt met correcte NAW-gegevens, huidige rechtsvorm, actuele bedrijfsstatus en SBI-codes. Voor sales-teams betekent dit een compleet klantbeeld zonder handmatig research. Voor jullie datateam betekent dit een cleaner CRM zonder outdated informatie. Werkt met Salesforce, Pipedrive en eigen CRM-oplossingen.
In boekhouding en facturatie wordt de koppeling gebruikt om zeker te weten dat facturen naar het juiste bedrijf gaan, met de correcte NAW-gegevens en de actuele rechtsvorm. Dat voorkomt facturen die “onbezorgbaar” terugkomen omdat de gegevens niet meer kloppen. Ook interessant voor het detecteren van klantwijzigingen die impact hebben op de facturatie (bijvoorbeeld: klant is failliet gegaan, klant heeft een naamswijziging doorgevoerd). Werkt met AFAS, Exact Online, Twinfield en SnelStart.
Voor compliance en KYC-processen wordt de KvK API gebruikt bij het formeel valideren van klanten. Financiële dienstverleners, verzekeraars en organisaties die Wwft-onderworpen zijn, gebruiken dit als onderdeel van hun onboarding-flow. Voor deze scenario’s kiezen we vrijwel altijd de officiële KvK API omdat de juridische geldigheid van de data belangrijk is.
Voor B2B-webshops en klantportalen wordt de koppeling ingezet tijdens registratie om zakelijke klanten van consumenten te onderscheiden. Op basis van een geldig KvK-nummer krijgen klanten toegang tot B2B-prijzen, kredietvoorwaarden, of specifieke productcategorieën.
Voor marketing en lead-verrijking verrijken we inkomende leads uit formulieren met bedrijfsdata voordat ze in het CRM of marketing automation tool (Spotler, Mailchimp) belanden. Segmentatie op branche (via SBI-codes) of bedrijfsgrootte wordt daarmee mogelijk zonder handmatig research.
Wat vaak wordt overzien
KvK-nummer validatie is niet hetzelfde als bedrijfsdata ophalen. Een geldige 11-cijferige structuur (waarvan de eerste 8 het KvK-nummer zijn en de laatste 3 het vestigingsnummer) zegt niks over of dat nummer daadwerkelijk bestaat. Elfproef-validatie is een startpunt, API-bevraging is het echte antwoord.
Historiek en actualiteit spelen een rol. Een bedrijf dat vorig jaar failliet is gegaan, kan nog steeds als “actief” in verouderde caches staan. Voor kritieke beslissingen (kredietwaardigheid, langdurige contracten) moeten we altijd een verse bevraging doen, geen cached data van een half jaar oud.
Vestigingen en holdings zijn complex. Een bedrijf kan meerdere vestigingen hebben, elk met een eigen vestigingsnummer. Bij een KvK-bevraging krijg je vaak het hoofdvestiging-record, terwijl de klant wellicht een specifieke locatie bedoelt. Wij bouwen daar bewuste keuzes in.
BTW-nummer validatie is een aparte stap. Het KvK-nummer geeft geen zekerheid dat het opgegeven BTW-nummer klopt. Voor EU-brede BTW-validatie combineren we vaak met VIES/VATLayer voor een correcte compliance-flow.
Rate limits en kosten. De officiële KvK API rekent per bevraging. Zonder cache-strategie kunnen kosten snel oplopen bij druk gebruik. Wij bouwen bewuste caching in met correcte invalidatie-momenten.
Hoe wij deze koppeling technisch bouwen
Voor de meeste projecten bouwen we een dunne middleware-laag tussen jullie applicatie en de KvK API. Voordelen: cache-management, retry-logica, foutafhandeling, en de mogelijkheid om later te wisselen tussen KvK API en Open KvK zonder dat de rest van jullie code aangepast hoeft te worden.
De authenticatie verloopt via API-keys die veilig opgeslagen worden. Voor de KvK API gebruikte we hun officiële token-flow, voor Open KvK werkt de bevraging zonder authenticatie.
Autocomplete-functionaliteit bouwen we via debounced input (om niet bij elke toetsaanslag een API-call te doen), met een minimum aantal karakters voordat de bevraging start. Voor de gebruiker voelt dit snel en responsive.
Caching doen we per project bewust: voor autocomplete-scenario’s kunnen resultaten uren tot dagen gecached blijven, voor kritieke bevragingen (KYC, contracten) altijd vers. Cache-invalidatie combineren we met event-triggers waar dat relevant is.
Foutafhandeling wordt expliciet ontworpen. Wat gebeurt er als de KvK API onbereikbaar is (dan valt de flow terug op handmatige invoer met melding), wat als een bedrijf niet gevonden wordt (heldere feedback naar de gebruiker), wat als de API-key is verlopen (alert naar het team).
Voor AVG en dataminimalisatie halen we alleen op wat nodig is. KvK-data die niet gebruikt wordt, wordt niet opgeslagen. Bewaartermijnen zijn ingesteld conform jullie retentiebeleid.
Voor welke platformen
De koppeling werkt met vrijwel elk platform. Wij bouwen ‘m met:
WordPress en WooCommerce via Gravity Forms, Contact Form 7 of custom implementaties. Voor WooCommerce B2B-webshops verzorgen we de koppeling tijdens klantregistratie en checkout.
Laravel en Symfony met directe SDK-integratie of eigen abstractie-laag. Voor complexere projecten met veel bevragingen adviseren we vaak een gededicaceerde microservice.
Nuxt en Vue-frontends met server-side proxy zodat API-keys niet in de browser terechtkomen.
Directus en headless CMS’en via Flows en hooks, voor content-hubs waar zakelijke leads worden verrijkt.
Bestaande systemen zonder moderne API-support koppelen we via een middleware-laag, ook voor legacy-systemen op AS/400 of andere platformen.
Overheid en semi-publieke organisaties koppelen we vaak in bredere context van eHerkenning, DigiD en Peppol-flows.
AI hielp bij het schrijven. Gereedschap verandert, vakmanschap niet.Hoe ideeën werkelijkheid worden
Geen theorie, maar echte trajecten. Bekijk hoe richting, techniek en ontwerp samen zorgen voor resultaat dat blijft staan.
Inzichten uit ons digitaal vakmanschap
Van praktijkverhalen en slimme oplossingen tot updates uit ons eigen team. Een inkijk in wat ons bezighoudt, wat we ontdekken en hoe ideeën langzaam vorm krijgen.
Veelgestelde vragen
Moet ik voor autocomplete op mijn website de officiële KvK API gebruiken?
Voor autocomplete-functionaliteit op registratieformulieren is Open KvK bijna altijd voldoende. De data is publiek beschikbaar, gratis, en snel genoeg voor gebruikerservaring. Wij combineren autocomplete met een verse KvK API-bevraging op het moment dat de klant zijn registratie afrondt, zodat de definitieve gegevens klopeen. Voor pure autocomplete zonder juridische zwaarte volstaat Open KvK.
Wat kost een bevraging op de KvK API?
De officiële KvK API rekent per bevraging, met verschillende tarieven per datatype (basis-inzage is goedkoper dan uitgebreide inzage). Voor projecten met veel bevragingen bouwen we bewuste caching zodat je alleen betaalt voor bevragingen die daadwerkelijk nieuwe of actuele data nodig hebben. Voor projecten die veel autocomplete-verkeer verwerken, adviseren we altijd Open KvK voor die functie en KvK API alleen voor de kritieke momenten. Concrete kostenvoorspelling maken we in de intake op basis van jullie verwachte volume.
Kunnen we KvK-data koppelen aan onze CRM voor automatische verrijking?
Ja. Bestaande klanten in Salesforce, Pipedrive of een eigen CRM worden bij ons verrijkt met actuele KvK-data. Wij bouwen een reguliere sync (bijvoorbeeld wekelijks) die inactieve klanten, adreswijzigingen en rechtsvormwijzigingen detecteert. Voor nieuwe leads gebeurt de verrijking direct bij aanmaken. Combineerbaar met dashboards voor management-inzicht in je klantportefeuille.
Wat gebeurt er als de KvK API tijdelijk niet bereikbaar is?
Onze integraties zijn defensief opgezet. Bij een tijdelijke storing wordt de bevraging automatisch opnieuw geprobeerd (met exponential backoff). Als het langer duurt, valt de flow terug op handmatige invoer met een duidelijke melding naar de gebruiker, zodat de registratie of klantonboarding niet volledig blokkeert. Kritieke bevragingen (KYC, contract-onboarding) worden gequeued voor latere afhandeling.
Kunnen we ook bevragen op basis van bedrijfsnaam of alleen op KvK-nummer?
Beide. De KvK API en Open KvK ondersteunen zoekopdrachten op bedrijfsnaam, KvK-nummer, RSIN of vestigingsadres. Voor autocomplete werkt name-based search het beste (de gebruiker typt zijn bedrijfsnaam), voor validatie werken we vaak met KvK-nummer als sleutel omdat die uniek is. Wij combineren beide methodes in de flow die past bij jullie use case.
Voor de ontwikkeling van een kennisplatform van een nieuw team binnen het VUmc, zijn we de samenwerking aangegaan met SMIT. Dit heeft een prettige en vakkundige samenwerking opgeleverd, waarin SMIT. onze wensen begrijpt en hier vakkundig en constructief over mee kan denken. Wij zijn erg tevreden over het resultaat en deze samenwerking!
SMIT is voor ons een betrouwbare partner op IT gebied. We werken al 19 jaar samen. We zijn met onze webshop Drankdozijn altijd vooruitstrevend en daar past SMIT heel goed bij. Innovatieve ideeën worden met SMIT werkelijkheid. Naast een digitale strategie staat digital security bij SMIT centraal, wat voor ons als e-commerce bedrijf een vertrouwd gevoel geeft.
We werken al lange tijd samen met SMIT en zijn zeer tevreden over de samenwerking. Het team is uiterst deskundig en denkt proactief mee over marketingoplossingen met creatieve, waardevolle ideeën die ons echt verder helpen. Als het nodig is, spelen ze kort op de bal en handelen ze snel en direct. Een betrouwbare partner waar we graag mee blijven werken!
Voor een complex portal hebben wij SMIT Digitaal Vakmanschap ingeschakeld. Na wat opstartproblemen is er door de werknemers van SMIT een waardevolle tool ontwikkeld, waar zowel wij als onze klanten, elke dag dankbaar gebruik van maken.
In maart 2024 is onze nieuwe website gelanceerd. Gemaakt door en gehost bij SMIT. Design was op basis van corporate huisstijl met eigen stijlelementen. Veel aandacht is gegeven aan site performance, waardoor website hoog scoort op SEO, accessibility en best practices.
SMIT heeft ons super geholpen met het zetten van de volgende stap met onze webshop. Wij hadden behoefte aan een partij die ons kon faciliteren in een stabiele server die bestand is tegen pieken in bezoekersaantallen. SMIT heeft meer dan dat geleverd. Een uiterst professionele partij, heel toegankelijk, snel in hun reactie en ze weten echt waar ze het over hebben. Aanrader!
SMIT is technisch sterk, ze kunnen goed luisteren naar de businessvraag achter de it-oplossing en zijn zakelijk betrouwbaar. Kortom: een goede partner voor je IT-innovaties.