OpenKVK en KVK koppeling.

Waarom koppelen aan het Handelsregister?

Het Handelsregister van de Kamer van Koophandel (KVK) bevat gegevens van alle ondernemingen en rechtspersonen in Nederland. Wanneer je applicatie werkt met zakelijke klanten, leveranciers of partners, wil je die gegevens valideren en verrijken. Een KVK-nummer invoeren en automatisch de handelsnaam, het vestigingsadres, de rechtsvorm en SBI-codes ophalen; dat bespaart handmatig invoerwerk en voorkomt fouten.

Denk aan een onboarding-flow voor zakelijke klanten: in plaats van alle bedrijfsgegevens handmatig te laten invullen, voert de gebruiker alleen het KVK-nummer in. Je applicatie haalt de rest op via de API. Adres, handelsnaam, vestigingsnummer; alles wordt automatisch ingevuld en gevalideerd tegen het officiële register.

Handmatig bedrijfsgegevens overtypen is niet alleen tijdverspilling; het is een bron van fouten die je pas ontdekt als de factuur al verstuurd is.

KVK API vs. OpenKVK

Er zijn twee routes om bij KVK-data te komen: de officiële KVK API en OpenKVK. Het verschil is belangrijk.

De officiële KVK API (via developers.kvk.nl) biedt toegang tot actuele Handelsregisterdata. Je registreert een account, vraagt een API-key aan en betaalt per bevraging. De data is actueel, betrouwbaar en juridisch geldig. Voor toepassingen waar correctheid essentieel is; facturatie, compliance, contracten; is dit de aangewezen bron.

OpenKVK was een gratis alternatief dat data uit het Handelsregister ontsloot. Let op: OpenKVK is niet meer actief en de data is niet langer bijgewerkt. Voor nieuwe projecten adviseren we altijd de officiële KVK API te gebruiken. De kosten per bevraging zijn laag en je hebt de zekerheid van actuele, correcte data.

KVK API endpoints

De KVK API biedt meerdere endpoints. Het zoekendpoint laat je zoeken op KVK-nummer, vestigingsnummer, handelsnaam of adres. Het basisprofiel-endpoint geeft de kerngegevens van een onderneming: naam, rechtsvorm, registratiedatum en status. Het vestigingsprofielen-endpoint levert gedetailleerde informatie per vestiging, inclusief adres, SBI-codes en werkzame personen.

SBI-codes en branche-informatie

Elke onderneming in het Handelsregister heeft een of meerdere SBI-codes (Standaard Bedrijfsindeling). Deze codes classificeren de activiteit van het bedrijf. Via de KVK API kun je deze codes ophalen en gebruiken in je applicatie; denk aan branchefiltering, risicoclassificatie of het automatisch toewijzen van een accountmanager op basis van sector.

De SBI-code is een vijfcijferige code met een hiërarchische structuur. De eerste twee cijfers geven de hoofdsector, de volgende cijfers specificeren de activiteit. In je applicatie worden deze codes automatisch vertaald naar leesbare branche-omschrijvingen, zodat gebruikers direct zien in welke sector een bedrijf actief is.

UBO-register

Sinds de invoering van de UBO-wetgeving (Ultimate Beneficial Owners) zijn bedrijven verplicht hun uiteindelijk belanghebbenden te registreren. De KVK beheert het UBO-register. Hoewel de publieke toegang tot dit register beperkt is, biedt het voor bepaalde toepassingen; compliance, due diligence, KYC-processen; relevante informatie. De beschikbaarheid van UBO-data via de API is aan regelgeving gebonden; houd de ontwikkelingen hieromtrent in de gaten.

Adresvalidatie en verrijking

Een praktische toepassing van de KVK koppeling is adresvalidatie. Klant voert een KVK-nummer in, je applicatie haalt het officiële vestigingsadres op uit het Handelsregister en vergelijkt dit met het ingevoerde adres. Komt het niet overeen? Toon een suggestie. Dit voorkomt foutieve adressen in je systeem en zorgt dat facturen en correspondentie op de juiste plek aankomen.

Combineer de KVK data met andere bronnen voor maximale verrijking. Het BTW-nummer is af te leiden uit het KVK-nummer (voor eenmanszaken en VOF's is dit niet altijd eenduidig, maar voor BV's is het doorgaans het KVK-nummer met een prefix en suffix). Koppel eventueel aan het VIES-systeem van de EU voor BTW-validatie bij internationaal zakendoen.

Eén KVK-nummer invoeren en de rest laten invullen door je systeem; dat is het verschil tussen software die werkt en software die voor je werkt.

Coding Agency bouwt KVK koppelingen

Wij integreren de KVK API in maatwerksoftware waar bedrijfsdata een rol speelt. Van onboarding-flows die automatisch bedrijfsgegevens invullen, tot compliance-modules die KVK-data gebruiken voor klantvalidatie. We bouwen caching-lagen om kosten te beheersen, normaliseren de data voor consistente weergave en zorgen voor correcte foutafhandeling wanneer de API onbeschikbaar is.

De KVK API is een waardevolle bron voor elke applicatie die werkt met zakelijke relaties. De implementatie is technisch niet complex, maar de details maken het verschil: correcte verwerking van meerdere vestigingen, omgaan met inactieve registraties en het cachen van data zonder verouderde gegevens te tonen. Wij zorgen dat de koppeling betrouwbaar en kostenefficiënt werkt.