Eén eigen API voor betrouwbare, actuele ondernemingsgegevens uit de KBO
Voor verschillende klanten halen we ondernemingsgegevens op via diensten zoals VIES, Graydon of vergelijkbare aanbieders. Die diensten zijn echter duur om enkel ondernemingsgegevens op te halen, of net niet stabiel genoeg. Daarom ontwikkelden we een API die ondernemingsgegevens rechtstreeks uit de officiële KBO-bronnen haalt, herbruikbaar over projecten heen.
We bouwden al verschillende projecten waarin juiste ondernemingsgegevens nodig zijn: een naam, een adres, een ondernemingsnummer dat klopt. Die gegevens haalden we tot nog toe op via diensten zoals VIES of Graydon.
De uitdaging
Voor projecten die ondernemingsgegevens nodig hebben, botste het team telkens op dezelfde knelpunten.
- De VIES-dienst van de Europese Commissie, vaak gebruikt om btw-nummers te controleren, is niet stabiel.
- Betrouwbare data vraagt om een officiële bron: de Kruispuntbank van Ondernemingen (KBO).
- Commerciële diensten zoals Graydon zijn duur als je enkel basisgegevens over een onderneming wil opvragen.
Onze aanpak
We kozen ervoor om de officiële API van KBO en de Open Data te combineren. We zetten caching in om het aantal dure calls zo laag mogelijk te houden.
- Een duidelijk endpoint dat alle relevante ondernemingsgegevens teruggeeft in JSON.
- Een eenvoudige beheerinterface voor API keys.
- Normalisatie en validatie van ondernemingsnummers.
Technisch draait dit samen dankzij een aantal gerichte keuzes:
- Symfony Rate Limiter om te veel aanvragen op korte tijd tegen te gaan.
- Symfony Cache om dezelfde data niet opnieuw op te vragen.
- Dagelijkse verwerking van de update-bestanden van KBO Open Data voor cache invalidatie.
Resultaat
Sinds de lancering krijgen projecten direct de officiële gegevens via de KBO, via één endpoint in plaats van een aparte integratie per service.
- Ondernemingsgegevens komen rechtstreeks uit de officiële KBO-bron.
- Cache houdt het aantal betalende aanroepen naar de KBO Public Search Webservice laag.
We wilden niet afhankelijk zijn van een trage VIES-dienst of een dure externe partij voor basisgegevens van een bedrijf. Door de officiële KBO-data te gebruiken zijn we zeker van de juiste informatie aan een correcte prijs.
CTO, Sumo Coders
