Batchverwerking KBO/BCE-API: praktische gids 2026

In het kort

Batchverwerking met de KBO/BCE-API maakt het mogelijk duizenden bedrijfsfiches in een enkele doorloop te valideren, verrijken of opschonen. De aanpak steunt op drie bouwstenen: normalisatie van KBO-nummers, een concurrentie-queue beperkt tot 5-10 gelijktijdige aanroepen om rate limiting te respecteren, en CSV-export van de resultaten. Ideaal voor CRM-migraties, leveranciers-due-diligence of B2B-prospectie in Belgie.

Waarom batchverwerking?

Veel use cases vereisen de verwerking van grote hoeveelheden bedrijfsgegevens:

CRM-migratie: duizenden klantfiches importeren en verrijken

Databankopschoning: bestaande gegevens valideren en corrigeren

Due diligence: een leveranciersportefeuille verifiëren

Prospectie: een B2B-prospectlijst verrijken

Aanbevolen architectuur

Code

┌──────────────┐     ┌───────────────┐     ┌──────────────┐
│  CSV-bestand │────▶│  Worker Queue  │────▶│  KBO/BCE API │
│  of Database │     │  (Bull/Redis)  │     │              │
└──────────────┘     └───────┬───────┘     └──────────────┘
                             │
                     ┌───────▼───────┐
                     │  Verrijkte    │
                     │  resultaten   │
                     └───────────────┘

Stap 1: Gegevens voorbereiden

Lees en parseer uw CSV-bestand met bedrijfsgegevens.

Stap 2: KBO-nummers normaliseren

Een KBO-nummer heeft 10 cijfers in het formaat 0XXX.XXX.XXX. Normaliseer alle invoer.

Stap 3: Wachtrij met debietcontrole

Verwerk bedrijven in batches van 5-10 met een vertraging tussen batches om rate limits te respecteren.

Stap 4: Resultaten exporteren

Exporteer de verrijkte resultaten naar een CSV-bestand.

Best practices

Praktijk	Waarom
Beperkte concurrency (5-10)	Rate limiting respecteren
Vertraging tussen batches	Belasting spreiden
Invoer normaliseren	Matchingspercentage maximaliseren
Fouten afhandelen	Niet het hele lot blokkeren

Conclusie

Batchverwerking is essentieel voor grootschalige projecten. Met goed debietbeheer kunt u tienduizenden bedrijven efficiënt verwerken. Bekijk ook de Node.js/TypeScript-integratiegids voor de KBO-API, het artikel over het automatiseren van leveranciersverificatie, de pagina over rate limits en caching en de CRM-pipeline voor B2B-prospectie in Belgie.

Veelgestelde vragen

Hoeveel Belgische bedrijven kan ik per uur in batch verwerken met de KBO/BCE-API?

Dit hangt af van uw tariefplan en uw concurrentiestrategie. Met een concurrentie van 5 gelijktijdige aanroepen en een vertraging van 200 ms tussen elke batch kunt u op een Pro-plan ongeveer 1 500 bedrijven per minuut verwerken. Voor grotere volumes optimaliseert u de cache (vermijd het meerdere keren opvragen van hetzelfde KBO-nummer) en gebruikt u batchverwerking met een wachtrij zoals BullMQ.

Hoe normaliseer ik KBO/BCE-nummers voor een batchverwerking?

Een Belgisch KBO-nummer heeft 10 cijfers in het formaat 0XXX.XXX.XXX. In uw brongegevens vindt u vaak varianten: zonder punten, met spaties, zonder het beginpunt. Verwijder alle niet-numerieke tekens, controleer of u 9 of 10 cijfers krijgt en formatteer opnieuw naar de standaard 0XXX.XXX.XXX. Dit maximaliseert het matchingspercentage bij het zoeken in de KBO-databank.

Hoe hervat ik een onderbroken batchverwerking met de KBO/BCE-API?

Sla resultaten stapsgewijs op in een bestand of databank en markeer elk verwerkt bedrijf. Bij een onderbreking filtert u al verwerkte bedrijven eruit voordat u de batch opnieuw start. Gebruik een herstelindex op basis van het KBO-nummer om duplicaten te vermijden en snel te identificeren waar u bent gebleven.

Wat is het verschil tussen batchverwerking en webhooks voor het monitoren van Belgische bedrijven?

Batchverwerking is geschikt voor eenmalige verwerking op grote volumes (migratie, audit, initiële verrijking). Webhooks zijn geschikt voor realtime monitoring van een specifieke portefeuille: Company Belgium meldt u zodra een bedrijf wijzigt (adres, status, bestuurder, NACE). Voor continue monitoring combineert u beide aanpakken: initieel batch, daarna webhooks voor updates.