Naar de inhoud
API BCEAPI BCEAPI voor Belgische ondernemingsgegevens
ToepassingenPrijzenDocumentatieSandboxAPI-sleutel
🇬🇧 English🇫🇷 Français🇳🇱 Nederlands🇩🇪 Deutsch🇪🇸 Español
API-sleutel
API BCE / Toepassingen / Een CRM automatisch verrijken vanuit het ondernemingsnummer

📇 Een CRM automatisch verrijken vanuit het ondernemingsnummer

Een ondernemingsnummer volstaat om een klant- of prospectfiche correct in te vullen: officiële benaming, adres van de zetel, activiteiten en gepubliceerde contactgegevens.

Het probleem#

In een CRM bestaat dezelfde vennootschap vaak drie keer: „Dupont BV”, „DUPONT” en „Dupont & zonen”, elk met een iets ander adres. Fiches worden met de hand ingegeven, gesprek na gesprek, en niemand weet welke juist is. Rapporten per sector of regio kloppen niet meer, en de facturatie neemt het meest recente adres, niet noodzakelijk het juiste.

Het ondernemingsnummer is de stabiele identificatie van een Belgische vennootschap. Als je tool van dat nummer vertrekt, kan ze de rest in de officiële bron ophalen in plaats van het te laten intikken.

De API-gegevens die antwoorden#

  • GET /denominations?q=…: autocompletie op ondernemingsnamen, om vanaf de eerste getikte letters de juiste vennootschap voor te stellen en haar nummer op te halen.
  • GET /enterprise/{num}: de hoofdfiche (benaming, rechtsvorm, status, begindatum, zetel).
  • GET /enterprise/{num}/address: enkel het adres van de maatschappelijke zetel, als je alleen dat veld wilt verversen.
  • GET /enterprise/{num}/activities: alle aangegeven NACE-activiteiten, om je accounts per sector in te delen.
  • GET /enterprise/{num}/denominations: alle benamingen (officieel, afgekort, commercieel) in de gepubliceerde talen.
  • GET /enterprise/{num}/contact: telefoon, e-mail en website, wanneer de onderneming ze heeft gepubliceerd.
  • GET /naces: zoeken in de NACE-nomenclatuur, om het label van een code te tonen of je eigen segmenten te bouwen.

Voorbeeldverzoek#

"tok-comment"># 1. Type-ahead on the company name, returns enterprise numbers
curl "https://companybelgium.be/api/v2/denominations?q=espero&limit=5" \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
"tok-comment">
# 2. Once a number is chosen, read the record and its sub-resources
curl https://companybelgium.be/api/v2/enterprise/1033.022.383 \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
curl https://companybelgium.be/api/v2/enterprise/1033.022.383/activities \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"
curl https://companybelgium.be/api/v2/enterprise/1033.022.383/contact \
  -H "X-API-Key: $API_BCE_KEY" -H "X-API-Secret: $API_BCE_SECRET"

De eerste call dient het invoerscherm: de gebruiker tikt een paar letters, kiest de juiste vennootschap en je tool onthoudt haar nummer. De volgende calls vullen de fiche in vanuit dat nummer.

Aanbevolen aanpak#

  • Maak van het ondernemingsnummer de koppelsleutel van je accounts: twee fiches met hetzelfde nummer zijn dezelfde vennootschap.
  • Vervang een adres dat een verkoper heeft ingegeven niet zonder te verwittigen: stel de officiële waarde voor en laat de gebruiker bevestigen.
  • Bewaar de datum van de laatste verrijking en ververs actieve accounts periodiek in plaats van telkens het hele bestand.
  • Roep de subresources parallel aan: ze zijn onafhankelijk van elkaar en geven elk de standaard JSON-envelope terug.
  • Plaats de call in je backend of in een geplande taak, nooit in de browser.

Grenzen om te kennen#

  • Contactgegevens (telefoon, e-mail, website) worden alleen teruggegeven als de onderneming ze heeft gepubliceerd; veel ondernemingen publiceren er geen.
  • Met een OAuth-token van een applicatie vereist het contact-endpoint de scope enterprise:contact. Een gewone API-sleutel heeft toegang zonder scope.
  • NACE-activiteiten zijn die welke bij het register zijn aangegeven: ze beschrijven het doel van de onderneming, niet noodzakelijk wat ze vandaag echt verkoopt.
  • De API geeft geen commerciële contactpersoon of nominatieve contacten terug: het is geen prospectiedatabank.
  • Elke call telt mee in je maandquota: een massale verrijking plan je volgens je abonnement en de uurlimiet.

Veelgestelde vragen#

Kan ik een onderneming vinden op naam in plaats van op nummer?

Ja. GET /denominations?q=… geeft suggesties terug met het ondernemingsnummer van elk; roep daarna de fiche met dat nummer aan.

In welke taal zijn de benamingen?

In de talen die in het register zijn gepubliceerd: Frans, Nederlands, Duits of Engels, afhankelijk van de onderneming. GET /enterprise/{num}/denominations geeft ze allemaal terug.

Hoe houd ik fiches actueel na de verrijking?

Ververs actieve accounts periodiek, of abonneer ze op een webhook om verwittigd te worden wanneer hun fiche in het register wijzigt.

Aan de slag

Maak een sleutel aan in het ontwikkelaarsportaal en volg daarna de referentiedocumentatie voor elk vermeld endpoint.

API-sleutel aanvragenLees de documentatie

Referentiedocumentatie

  • Onderneming
  • Filteren en zoeken

Andere toepassingen

  • Een klant of leverancier controleren voor je met hem werkt
  • Een btw-nummer valideren (VIES) bij het invoeren van een factuur
  • KYC/KYB bij het openen van een zakelijk account
  • Ondernemingen opvolgen met webhooks

Op deze pagina

Het probleemDe API-gegevens die antwoordenVoorbeeldverzoekAanbevolen aanpakGrenzen om te kennenVeelgestelde vragenAan de slag
API BCEAPI BCE

Een ontwikkelaarsproduct van Espero-Soft Informatiques, gebouwd op officiële KBO/BCE-opendata.

Product

ToepassingenWaarom API BCEPrijzenFAQ

Ontwikkelaars

DocumentatieAPI-referentieAPI-playgroundWijzigingslogboekAPI-sleutel

Bedrijf

Gegevens, compliance en Peppol ↗Company Belgium ↗Espero-Soft ↗

Juridisch

Wettelijke vermeldingenAlgemene gebruiks- en verkoopvoorwaardenPrivacybeleidCookiebeleid
© 2026 Espero-Soft Informatiques SRL · Alle rechten voorbehouden.Gemaakt in België 🇧🇪