Quelle est la difference entre l'API officielle KBO et une API tierce comme Company Belgium ?

L'API officielle du SPF Economie (KBOPublicSearch) est gratuite mais en SOAP/XML, sans documentation OpenAPI, sans webhooks et sans SLA. Une API tierce comme Company Belgium expose les memes donnees BCE en REST/JSON avec webhooks, cascade UBO, verification Peppol et support developpeur, ce qui reduit le temps d'integration de 3 a 5 jours a moins d'une journee.

Peut-on utiliser l'API officielle BCE pour un projet en production ?

Oui, c'est possible pour des usages simples comme la verification ponctuelle de numeros TVA ou le traitement bulk hebdomadaire. Mais pour un projet avec un SLA client, du KYC/AML ou du suivi de changements en temps reel, les couts caches de l'API SOAP (developpement, polling, croisements manuels UBO) depassent rapidement le tarif d'une API tierce.

Qu'est-ce que KBOPublicSearch et comment y acceder ?

KBOPublicSearch est le service SOAP officiel du SPF Economie accessible sur kbopub.economie.fgov.be. Il est gratuit, sans cle API, mais retourne du XML. L'acces necessite la generation d'un client SOAP (wsdl2java, suds, etc.) et la gestion des envelopes XML avec espaces de nommage, ce qui ajoute plusieurs jours de developpement sur une stack moderne.

L'API BCE Open Data est-elle differente de KBOPublicSearch ?

Oui. BCE Open Data est un telechargement FTP de fichiers CSV compresses (full + delta quotidien, ~500 Mo) tandis que KBOPublicSearch est un service SOAP pour les requetes en temps reel. Open Data est ideal pour alimenter un data warehouse ou faire du traitement bulk, mais inadapte pour des verifications ponctuelles ou des applications en ligne.

API officielle KBO vs API tierces : 6 limites a connaitre

En bref

L'API officielle SOAP du SPF Economie est gratuite et fiable, mais elle impose un cout technique eleve en 2026 : pas de REST/JSON, pas de webhooks, pas d'UBO, pas de Peppol, pas de SLA. Pour les projets en production avec un SLA client ou des besoins KYC/AML, migrer vers une API tierce moderne est economiquement plus avantageux des qu'on integre les couts caches.

Ce que personne ne vous dit sur l'API officielle

Avant de creuser : l'API officielle du SPF Économie est un service public gratuit et précieux. Sans elle, l'écosystème entier de la donnée d'entreprise belge n'existerait pas. Tout le reste, y compris Company Belgium, en dépend.

Mais en 2026, démarrer un projet sérieux directement contre l'API officielle, c'est s'imposer un poids technique et fonctionnel inutile. Voici précisément pourquoi.

Ce que propose l'API officielle

Le SPF Économie expose trois canaux :

KBOPublicSearch — un service SOAP pour la recherche d'entreprises et la consultation de leur fiche

EnterpriseRegister — un service SOAP authentifié pour les acteurs accrédités (notaires, greffes, banques)

BCE Open Data — un téléchargement FTP quotidien de fichiers CSV ZIP (full + delta)

Le tout est gratuit et alimenté quotidiennement. Source officielle, donnée fiable.

Les 6 limites concrètes

1. SOAP en 2026

KBOPublicSearch est en SOAP/XML. Votre stack moderne (Node.js, Python, Go, Ruby) devra :

Générer un client SOAP (wsdl2java, suds-jurko, gsoap, etc.)

Parser des envelopes XML avec espaces de nommage

Gérer des codes d'erreur SOAP, pas HTTP

Sérialiser les requêtes manuellement

Coût : +3 à 5 jours sur l'intégration initiale, et un cluster permanent de bugs lors des mises à jour de schéma.

2. Pas de webhooks

Si vous voulez réagir au changement (un client devient inactif, un nouvel administrateur est nommé, un dépôt de comptes apparaît), il faut poller. Pour 10 000 clients suivis :

Polling toutes les heures = 240 000 requêtes/jour

Détection avec un délai moyen de 30 minutes

Quota officiel souvent atteint

Avec une API à webhooks, vous recevez une seule notification HTTP quand l'événement se produit.

3. Pas de UBO enrichi

L'API officielle expose les données BCE (entreprise, adresse, dirigeants, NACE, établissements). Mais le registre UBO est un service distinct (MyMinFin), avec :

Authentification eID séparée

Pas d'API REST publique

Limitation à la consultation manuelle pour la plupart des accès professionnels

Pour faire un KYC complet, vous avez besoin de croiser BCE + UBO. L'API officielle ne le fait pas pour vous.

4. Pas de Peppol

Vérifier si une entreprise est enregistrée sur Peppol (pour lui envoyer une facture électronique) nécessite d'interroger un répertoire distinct (SMP/SML Peppol). Pas exposé par l'API officielle.

5. Pas de support développeur

L'API officielle ne propose ni :

Documentation OpenAPI/Swagger maintenue

Sandbox de test

Chat ou email de support développeur

SLA contractuel

Statut public (uptime, incidents)

Si vous avez un bug à 3 h du matin un vendredi, vous êtes seul.

6. Pas d'enrichissement métier

L'API officielle expose la donnée brute. Pas de :

Score de qualité de la donnée (incohérences signalées)

Indicateurs financiers calculés (taille d'entreprise selon la définition européenne)

Recherche full-text sémantique

Filtrage avancé (par chiffre d'affaires, effectif, etc.)

Cartographie des établissements

Suivi des changements (timeline)

Quand l'API officielle reste le bon choix

Soyons honnêtes — il y a des cas où l'API officielle suffit largement :

Projet académique : étudiants, recherche, mémoires

Traitement bulk hebdomadaire : exécuter un script du dimanche soir qui ingère le full dump et écrit dans votre data warehouse

Outil interne très basique : une moulinette qui vérifie 5 numéros TVA par jour

Backup / source de vérité : croiser une API tierce avec la source officielle pour audit

Dans ces cas, payer pour une API tierce serait du gaspillage.

Quand migrer vers une API tierce

À l'inverse, migrer fait sens dès que :

Vous êtes en production avec un SLA client : votre revenu dépend de la disponibilité

Vous faites du KYC ou de l'AML : besoin de cascade UBO, d'archivage, de traces

Vous facturez en Peppol : vérification de l'enregistrement et de la capacité de réception

Vous suivez des changements : monitoring, alertes, webhooks

Vous avez un volume > 1000 req/jour : la SOAP officielle commence à coincer

Votre équipe n'a pas de compétence SOAP : coût de formation > coût d'API

Vous voulez OpenAPI / SDK officiels : indispensable pour les nouvelles intégrations

Le coût caché de "rester gratuit"

Un calcul honnête sur 12 mois pour un projet en prod :

Poste	API officielle	API tierce (200€/mois)
Dev initial (SOAP, parsing)	5 j × 600 € = 3 000 €	1 j × 600 € = 600 €
Polling (200 000 req/jour, infra)	80 €/mois × 12 = 960 €	0 €
Bugs SOAP (1 j/trimestre)	4 × 600 € = 2 400 €	0 €
Cascade UBO manuelle (KYC)	30 min/dossier × 200 dossiers = 6 000 €	0 €
Abonnement API	0 €	200 € × 12 = 2 400 €
Total	12 360 €	3 000 €

L'écart est systématiquement en faveur de l'API tierce dès qu'on intègre les coûts cachés.

Comment Company Belgium remplit ces lacunes

Pour les projets sérieux, Company Belgium propose les briques absentes de l'API officielle :

REST/JSON moderne avec doc OpenAPI à jour — voir la référence des endpoints

Webhooks : recevez une notification dès qu'une entreprise change (nouveau dirigeant, dépôt de comptes, modification d'objet social, déclaration UBO)

Cascade UBO automatique, croisée avec le registre UBO

Peppol check intégré

SDK Python / Node.js / TypeScript (voir le tuto Python)

SLA contractuel sur les plans payants

Caching, rate limits transparents — voir l'architecture de référence

Le tout, en restant synchronisé avec la BCE officielle (donc la source de vérité légale ne se perd pas).

En résumé

L'API officielle reste un outil essentiel : c'est la source. Mais pour la majorité des projets en production qui font plus que lire des numéros TVA, elle impose un coût caché (SOAP, polling, croisements manuels) qui dépasse rapidement le tarif d'une API tierce.

Le bon réflexe : démarrer avec l'API officielle si vous prototypez, puis migrer vers une API enrichie dès qu'un client réel attend un SLA. Ce n'est pas un choix idéologique, c'est un calcul économique.