KYC/KYB bij het openen van een zakelijk account
Wanneer een vennootschap bij jou een account opent, moet je weten wie ze is, waar ze gevestigd is en wie haar bestuurt. De API brengt die elementen samen uit officiële bronnen.
Het probleem#
Een account openen voor een vennootschap (fintech, marktplaats, B2B-platform, kantoor onderworpen aan de antiwitwasregels) betekent haar identiteit controleren, niet overnemen wat de aanvrager intikte. In de praktijk mengt het dossier schermafbeeldingen, een pdf-uittreksel van het register en met de hand ingegeven namen van bestuurders.
Met de API bouw je dat dossier op vanuit enkel het ondernemingsnummer, vergelijk je wat de aanvrager verklaart met wat de officiële bronnen zeggen, en schakel je een analist alleen in voor de verschillen.
De API-gegevens die antwoorden#
GET /enterprise/{num}: officiële benaming, rechtsvorm, status, juridische toestand, begindatum en maatschappelijke zetel.GET /enterprise/{num}/denominations: alle benamingen, om een handelsnaam te koppelen aan de vennootschap die hem draagt.GET /enterprise/{num}/roles: bestuurders, vertegenwoordigers en uiteindelijke begunstigden, gehaald uit de meest recente publicatie in het Belgisch Staatsblad (oprichting, benoeming, overdracht), met de referentie van die publicatie.GET /vat/{vatNumber}: validatie van het btw-nummer bij VIES.GET /enterprise/{num}/financial: de financiële samenvatting uit de bij de Nationale Bank neergelegde jaarrekeningen, als die bestaan.
Voorbeeldverzoek#
"tok-comment"># Identity: legal name, form, status, juridical situation, registered office
curl https://companybelgium.be/api/v2/enterprise/1033.022.383 \
-H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
"tok-comment">
# Officers and beneficial owners extracted from the Moniteur belge
curl https://companybelgium.be/api/v2/enterprise/1033.022.383/roles \
-H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
"tok-comment">
# VAT number through VIES
curl https://companybelgium.be/api/v2/vat/BE1033022383 \
-H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"Uittreksel van het antwoord van /enterprise/{num}/roles:
{
"success": true,
"data": {
"enterpriseNumber": "1033022383",
"status": "...",
"source": {
"refNumber": "...",
"publicationDate": "...",
"publicationTitle": "...",
"publicationType": "..."
},
"roles": [
{
"fullName": "...",
"entityType": "...",
"roles": [
"..."
],
"ownershipPercentage": "...",
"enterpriseNumber": "..."
}
],
"updatedAt": "..."
},
"timestamp": "...",
"meta": {
"responseTime": "..."
}
}Het veld status van dit antwoord is ok wanneer een publicatie werd gelezen, no_publication wanneer er geen bruikbare publicatie bestaat en extraction_failed wanneer het lezen mislukte. Met het blok source vind je de oorspronkelijke publicatie in het Belgisch Staatsblad terug.
Aanbevolen aanpak#
- Vraag eerst het ondernemingsnummer en vul het formulier vooraf in vanuit de fiche: de aanvrager verbetert in plaats van te tikken.
- Vergelijk de persoon die het account opent met de bestuurders die
/enterprise/{num}/rolesteruggeeft; een afwezigheid is geen weigering maar een punt om na te gaan (een gevolmachtigde kan optreden zonder bestuurder te zijn). - Weiger automatisch een onderneming die niet actief is, en stuur een abnormale juridische toestand naar een analist.
- Archiveer het ruwe antwoord, de referentie van de publicatie en de datum van de call in het klantendossier.
Grenzen om te kennen#
- Bestuurders en begunstigden worden automatisch gehaald uit publicaties in het Belgisch Staatsblad. Dit is niet het UBO-register van de FOD Financiën, dat de bron blijft om te raadplegen voor je wettelijke verplichtingen.
- De extractie steunt op de laatste relevante publicatie: een wijziging die nog niet is gepubliceerd, verschijnt niet, en een extractie kan mislukken of onvolledig zijn.
- Een onderneming zonder bruikbare publicatie geeft
no_publicationterug; wanneer de bron tijdelijk onbereikbaar is, kan het endpoint 502 antwoorden. - De API verifieert de identiteit van een natuurlijk persoon niet (identiteitsbewijs, selfie): ze documenteert de onderneming, niet de aanvrager.
- Het resultaat ondersteunt een beslissing; het neemt die niet in jouw plaats en is geen juridisch advies.
Veelgestelde vragen#
Geeft de API de uiteindelijke begunstigden (UBO)?
Via GET /enterprise/{num}/roles geeft ze de bestuurders en begunstigden terug die automatisch uit het Belgisch Staatsblad zijn gehaald. Het is geen kopie van het officiële UBO-register van de FOD Financiën.
Waar komen de identiteitsgegevens van de onderneming vandaan?
Uit de officiële open data van de Kruispuntbank van Ondernemingen (KBO/BCE), gepubliceerd door de FOD Economie.
Kan de API dienen voor een antiwitwasdossier?
Ja, als gegevensbron om het dossier op te bouwen en te documenteren. De waakzaamheidsverplichtingen blijven de jouwe, en het officiële UBO-register moet worden geraadpleegd waar de wet dat vereist.
Aan de slag
Maak een sleutel aan in het ontwikkelaarsportaal en volg daarna de referentiedocumentatie voor elk vermeld endpoint.
Referentiedocumentatie