Bedrijfsdata-API in België, KBO, NBB of een kant-en-klare API

Uw CRM moet bij elke nieuwe klant de officiële naam en het adres invullen. Uw kredietbeleid wil de laatste cijfers van elke debiteur zonder dat iemand ze overtypt. Of u bouwt een product dat Belgische bedrijven toont. Dan wilt u de gegevens niet opzoeken, maar automatisch binnenhalen. Daarvoor zijn er in België drie wegen, met elk een andere prijs in geld en in onderhoud.

Wat heeft u echt nodig?

De keuze hangt minder af van de techniek dan van drie vragen.

• Identiteit of cijfers? Naam, adres, rechtsvorm, juridische toestand en activiteit staan in de KBO. Eigen vermogen, winst en schulden staan in de jaarrekening bij de Nationale Bank. De KBO bevat geen cijfers, de Nationale Bank geen volledige identiteitsfiche.
• Alle bedrijven of de uwe? Wie het hele land in een eigen database wil, kijkt naar bestanden. Wie een paar duizend klanten opvolgt of een bedrijf opzoekt wanneer een gebruiker erom vraagt, heeft genoeg aan een opvraging per bedrijf.
• Ruw of verwerkt? Een jaarrekening is een lijst rubriekcodes in een van meerdere schema's. Wilt u een solvabiliteit of een Gezondheidsscore, dan moet iemand die codes lezen en rekenen: uw ontwikkelaars, of uw leverancier.

Drie manieren om KBO-gegevens op te halen

De Kruispuntbank van Ondernemingen van de FOD Economie stelt haar publieke gegevens op drie manieren ter beschikking voor hergebruik. Wat er in de KBO staat en wat niet, leest u in KBO-nummer opzoeken.

KBO Open Data is de bekendste weg, en voor veel toepassingen genoeg. Reken wel op werk aan uw kant. Het bestand bestaat uit meerdere CSV-tabellen (ondernemingen, adressen, benamingen, activiteiten, contactgegevens) die u zelf aan elkaar koppelt via het ondernemingsnummer, met codes die u vertaalt via een aparte codetabel. U moet de updates elke dag inlezen, want een bestand blijft maar 31 dagen staan: mist u een maand, dan begint u opnieuw met het volledige bestand. En Open Data bevat alleen actieve ondernemingen: wie stopgezet wordt, valt uit het bestand, zonder historiek.

Jaarrekeningen via de Nationale Bank

De Balanscentrale van de Nationale Bank biedt webservices aan voor professionele gebruikers. U schrijft in met een formulier, uw technische gebruiker maakt een profiel aan op het developer portal en na goedkeuring wordt het product aan uw sleutel gekoppeld. De belangrijkste producten:

• Opvraging authentieke gegevens (gratis): per ondernemingsnummer eerst de lijst van neerleggingen (de refertes), daarna per neerlegging de documenten. Dat zijn de PDF, het XBRL-bestand voor neerleggingen vanaf 2007 en, voor XBRL-neerleggingen sinds april 2022, een JSON-document met de rubrieken en de deelnemingen.
• Dagelijks extract authentieke gegevens (gratis): alle neerleggingen die op één dag gepubliceerd zijn, als zip-bestanden met PDF's, XBRL en JSON. De bestanden zijn niet cumulatief en blijven een beperkte periode beschikbaar.
• Verbeterde gegevens (3.300 euro per jaar): wat de Nationale Bank zelf verbeterde. PDF-neerleggingen omgezet in gestructureerde gegevens, neerleggingen in vreemde munt omgerekend naar euro, en correcties op de boekhoudkundige gegevens.

Daarmee heeft u de officiële bron, maar nog geen cijfers die u in een scherm kan tonen. U leest de rubriekcodes uit, en die verschillen tussen het micro, verkort en volledig schema en de modellen voor vzw's. Een bedrijf kan een jaarrekening opnieuw neerleggen, en dan moet u weten welke versie telt. Neerleggingen die enkel als PDF binnenkwamen, zijn zonder het betalende product niet gestructureerd. De ratio's rekent u zelf uit. En u koppelt elke neerlegging aan de KBO-gegevens, want de Nationale Bank levert geen adres, activiteit of juridische toestand zoals de KBO dat doet.

Een verwerkte API

De derde weg is een API die de bronnen al gekoppeld en verwerkt heeft. U vraagt een bedrijf op en krijgt identiteit, cijfers en ratio's in één antwoord, zonder dat u zelf bestanden inleest of rubriekcodes vertaalt. U betaalt per request in plaats van in ontwikkeltijd, en u bent afhankelijk van hoe die leverancier de gegevens verwerkt.

Wat de API van Jaarrekening.be teruggeeft

Jaarrekening.be leest elke dag de wijzigingen in de KBO, de nieuwe neerleggingen bij de Nationale Bank en de publicaties in het Belgisch Staatsblad in. De API geeft dezelfde gegevens die u op de bedrijfspagina's ziet, voor Belgische ondernemingen:

U authenticeert met een token dat u aanmaakt onder Instellingen, API. Met de parameter lang krijgt u codes zoals rechtsvorm en juridische toestand in het Nederlands, Frans of Engels. De volledige beschrijving staat in de API-documentatie.

Wat het kost

Elk plan heeft een maandtegoed aan requests, dat op de eerste van de maand opnieuw volloopt. Een team deelt één tegoed.

Heeft u meer nodig, dan koopt u een pakket: 25.000 requests voor 2.500 euro, 50.000 voor 4.000 euro of 100.000 voor 6.000 euro, exclusief btw. Gekochte requests vervallen niet en worden pas gebruikt als het maandtegoed op is. Voor grotere volumes vraagt u een voorstel op maat. Is alles op, dan antwoordt de API met code 429 en de datum waarop het tegoed terug volloopt. De plannen staan op de prijzenpagina.

De drie wegen naast elkaar

Voorwaarden en persoonsgegevens

Openbare gegevens zijn niet vrij van regels. Lees de voorwaarden voor u bouwt, want ze bepalen wat u met de gegevens mag doen.

• Geen direct marketing met persoonsgegevens uit de KBO. Voor alle drie de KBO-diensten zegt de FOD Economie dat persoonsgegevens niet hergebruikt mogen worden voor direct marketing. Dat gaat in het bijzonder over alle gegevens van ondernemingen die natuurlijke personen zijn, zoals eenmanszaken.
• De GDPR geldt voor namen. Een bestuurder of zaakvoerder is een natuurlijke persoon, ook als zijn naam in een openbare jaarrekening staat. Wie namen opslaat of gebruikt, heeft een rechtsgrond nodig en moet de rechten van die personen respecteren.
• Licentie en registratie. KBO Open Data en Public Search vragen een registratie en het aanvaarden van gebruiksvoorwaarden. Het volledige KBO-bestand vraagt een licentieovereenkomst. De NBB-webservices hebben eigen abonnementsvoorwaarden.
• Voorwaarden van een leverancier. Bij Jaarrekening.be mag u de opgehaalde gegevens tonen en verwerken in uw eigen product of interne systemen. Doorverkopen van de toegang, uw sleutel delen met derden of grote delen van de database herpubliceren als concurrerend product mag niet. Systematisch gegevens van de website halen met scripts is verboden; daarvoor is de API er.

Zelf bouwen of afnemen?

1. Heeft u alleen identiteitsgegevens nodig?

   Dan volstaat de KBO. Public Search voor opvragingen per bedrijf, Open Data als u alle ondernemingen in een eigen database wilt en iemand de dagelijkse updates kan opvolgen.

2. Wilt u de jaarrekeningen zelf analyseren?

   Dan haalt u ze bij de Nationale Bank. Reserveer ontwikkeltijd voor het lezen van XBRL of JSON per schema en voor de koppeling met de KBO, en neem Verbeterde gegevens als u ook de PDF-neerleggingen gestructureerd wilt.

3. Wilt u kant-en-klare cijfers en ratio's bij een bedrijf?

   Dan is een verwerkte API meestal goedkoper dan het zelf bouwen. Tel hoeveel bedrijven u per maand opvraagt: honderden passen in een maandtegoed, tienduizenden in een pakket.

4. Test eerst

   Met een gratis account heeft u 10 requests per maand. Genoeg om te zien of de velden passen bij wat uw software nodig heeft, voor u een plan of pakket kiest.

Samengevat

Belgische bedrijfsgegevens zijn openbaar, en de officiële bronnen geven ze gratis: de KBO de identiteit, de Nationale Bank de jaarrekeningen. Wat ze niet geven, is het werk dat erna komt: bestanden dagelijks inlezen, rubriekcodes per schema lezen, ratio's berekenen en alles aan elkaar koppelen. Doet u dat liever niet zelf, dan haalt u het verwerkt op via een API en betaalt u per request. Welke weg u ook kiest, de regel over persoonsgegevens geldt overal: geen direct marketing met de gegevens van personen uit de KBO.