Jaarrekening.be
Votre CRM doit compléter le nom officiel et l'adresse de chaque nouveau client. Votre politique de crédit veut les derniers chiffres de chaque débiteur sans que personne ne les retape. Ou vous construisez un produit qui affiche des entreprises belges. Vous ne voulez alors pas rechercher les données, mais les récupérer automatiquement. En Belgique, il existe trois voies pour cela, chacune avec son prix en argent et en maintenance.
La réponse courte
- BCE Open Data
- Gratuit, CSV quotidien
- Services web BNB
- Comptes annuels, base gratuite
- API traitée
- BCE, chiffres et ratios en un
De quoi avez-vous vraiment besoin ?
Le choix dépend moins de la technique que de trois questions.
- Identité ou chiffres ? Nom, adresse, forme juridique, situation juridique et activité figurent à la BCE. Capitaux propres, bénéfice et dettes figurent dans les comptes annuels à la Banque nationale. La BCE ne contient pas de chiffres, la Banque nationale pas de fiche d'identité complète.
- Toutes les entreprises ou les vôtres ? Qui veut tout le pays dans sa propre base de données regarde du côté des fichiers. Qui suit quelques milliers de clients ou recherche une entreprise quand un utilisateur le demande, se contente d'une interrogation par entreprise.
- Brut ou traité ? Des comptes annuels sont une liste de codes de rubriques dans l'un de plusieurs schémas. Pour obtenir une solvabilité ou un Score de santé, quelqu'un doit lire ces codes et calculer : vos développeurs, ou votre fournisseur.
Trois manières de récupérer les données de la BCE
La Banque-Carrefour des Entreprises du SPF Économie met ses données publiques à disposition de trois manières pour la réutilisation. Ce qui figure ou non à la BCE, vous le lisez dans rechercher un numéro d'entreprise BCE.
| Service | Ce que vous recevez | Coût |
|---|---|---|
| BCE Open Data | Des fichiers CSV avec les données actives de toutes les entreprises et unités d'établissement actives. Chaque jour un fichier complet et un fichier de mise à jour, disponibles chacun 31 jours. | Gratuit, après inscription |
| Service web Public Search | Des interrogations par entreprise dans votre propre application : par numéro, nom, adresse, activité ou autorisation. Les données nouvelles ou modifiées sont disponibles le lendemain. | Compte gratuit, après inscription |
| Fichier complet de réutilisation | Des données détaillées sur les entreprises actives et arrêtées. Un fichier complet chaque mois, les modifications chaque jour. Sur demande et avec un contrat de licence. | Gratuit pour un usage non commercial, 30 000 euros par an pour un usage commercial |
BCE Open Data est la voie la plus connue, et suffit pour de nombreuses applications. Comptez toutefois du travail de votre côté. Le fichier se compose de plusieurs tables CSV (entreprises, adresses, dénominations, activités, coordonnées) que vous reliez vous-même par le numéro d'entreprise, avec des codes que vous traduisez via une table de codes séparée. Vous devez charger les mises à jour chaque jour, car un fichier ne reste en ligne que 31 jours : si vous manquez un mois, vous repartez du fichier complet. Et Open Data ne contient que les entreprises actives : celle qui s'arrête sort du fichier, sans historique.
Les comptes annuels via la Banque nationale
La Centrale des bilans de la Banque nationale propose des services web aux utilisateurs professionnels. Vous vous inscrivez au moyen d'un formulaire, votre utilisateur technique crée un profil sur le developer portal et, après approbation, le produit est lié à votre clé. Les principaux produits :
- Interrogation des données authentiques (gratuit) : par numéro d'entreprise, d'abord la liste des dépôts (les références), ensuite les documents de chaque dépôt. Ce sont le PDF, le fichier XBRL pour les dépôts depuis 2007 et, pour les dépôts XBRL depuis avril 2022, un document JSON avec les rubriques et les participations.
- Extrait quotidien des données authentiques (gratuit) : tous les dépôts publiés un jour donné, en fichiers zip avec PDF, XBRL et JSON. Les fichiers ne sont pas cumulatifs et restent disponibles pendant une période limitée.
- Données améliorées (3 300 euros par an) : ce que la Banque nationale a elle-même amélioré. Des dépôts PDF convertis en données structurées, des dépôts en devise étrangère convertis en euros, et des corrections des données comptables.
Vous disposez alors de la source officielle, mais pas encore de chiffres à afficher à l'écran. Vous lisez les codes des rubriques, et ceux-ci diffèrent entre les schémas micro, abrégé et complet et les modèles des ASBL. Une entreprise peut redéposer des comptes annuels, et il faut alors savoir quelle version compte. Les dépôts arrivés uniquement en PDF ne sont pas structurés sans le produit payant. Les ratios, vous les calculez vous-même. Et vous reliez chaque dépôt aux données de la BCE, car la Banque nationale ne fournit pas l'adresse, l'activité ou la situation juridique comme le fait la BCE.
À lire aussi Consulter les comptes annuels d'une entreprise en Belgique, et ce que vous y voyezUne API traitée
La troisième voie est une API qui a déjà relié et traité les sources. Vous interrogez une entreprise et recevez identité, chiffres et ratios en une réponse, sans charger vous-même des fichiers ni traduire des codes de rubriques. Vous payez par requête plutôt qu'en temps de développement, et vous dépendez de la manière dont ce fournisseur traite les données.
Ce que renvoie l'API de Jaarrekening.be
Jaarrekening.be charge chaque jour les modifications de la BCE, les nouveaux dépôts à la Banque nationale et les publications au Moniteur belge. L'API fournit les mêmes données que celles que vous voyez sur les pages entreprise, pour les entreprises belges :
| Endpoint | Ce que vous recevez |
|---|---|
| /v1/search | Une recherche comme dans la barre de recherche du site : tolérante aux fautes de frappe et à l'ordre des mots, jusqu'à 50 résultats. Pratique pour savoir quelle entreprise un utilisateur veut dire. |
| /v1/enterprises | Une liste paginée par nom ou numéro d'entreprise. |
| /v1/enterprises/{numéro} | Nom, forme juridique, situation juridique, date de début, activité principale, adresse et coordonnées, avec les chiffres clés et ratios des derniers comptes annuels : capitaux propres, bénéfice, EBITDA, solvabilité, current ratio, crédit clients, Score de santé et limite de crédit. |
| /financials | Les chiffres de chaque compte annuel déposé, éventuellement limités à certains exercices. |
| /directors | Les administrateurs tels qu'ils figurent dans les comptes annuels. |
| /investments et /investors | Les participations de l'entreprise dans d'autres sociétés, et les sociétés qui détiennent des actions de l'entreprise, pour autant qu'elles les mentionnent comme participation dans leurs propres comptes annuels. |
| /activities, /establishments, /publications, /lookalikes | Les activités NACE, les unités d'établissement, les publications au Moniteur belge et des entreprises comparables. |
Vous vous authentifiez avec un token que vous créez sous Paramètres, API. Avec le paramètre lang, vous recevez des codes comme la forme juridique et la situation juridique en français, en néerlandais ou en anglais. La description complète se trouve dans la documentation de l'API.
Ce que cela coûte
Chaque plan comprend un crédit mensuel de requêtes, qui se recharge le premier du mois. Une équipe partage un seul crédit.
- 10
- requêtes par mois avec un compte gratuit
- 500
- requêtes par mois avec Starter
- 2 500
- requêtes par mois avec Pro
Si vous avez besoin de plus, vous achetez un pack : 25 000 requêtes pour 2 500 euros, 50 000 pour 4 000 euros ou 100 000 pour 6 000 euros, hors TVA. Les requêtes achetées n'expirent pas et ne sont utilisées qu'une fois le crédit mensuel épuisé. Pour de plus grands volumes, vous demandez une proposition sur mesure. Quand tout est épuisé, l'API répond avec le code 429 et la date à laquelle le crédit se recharge. Les plans figurent sur la page des tarifs.
Les trois voies côte à côte
| BCE (Open Data, Public Search) | Services web BNB | API traitée | |
|---|---|---|---|
| Contenu | Identité, adresse, activité, situation | Comptes annuels par dépôt | Les deux, plus ratios, administrateurs et publications |
| Forme | Tables CSV ou interrogation par entreprise | PDF, XBRL, JSON avec codes de rubriques | JSON par entreprise, déjà traité |
| Coût | Gratuit, fichier complet commercial 30 000 euros par an | Gratuit, données améliorées 3 300 euros par an | Par requête |
| Travail de votre côté | Charger chaque jour, relier les tables, traduire les codes | Lire XBRL ou JSON par schéma, gérer les versions, calculer les ratios, relier à la BCE | Envoyer des requêtes et suivre le crédit |
| Adapté pour | Un registre propre de toutes les entreprises | Qui veut analyser lui-même les comptes annuels | Des données d'entreprises dans un CRM, une politique de crédit ou un produit |
Conditions et données à caractère personnel
Des données publiques ne sont pas libres de règles. Lisez les conditions avant de développer, car elles déterminent ce que vous pouvez faire des données.
- Pas de marketing direct avec des données personnelles de la BCE. Pour les trois services de la BCE, le SPF Économie indique que les données à caractère personnel ne peuvent pas être réutilisées à des fins de marketing direct. Cela vise en particulier toutes les données des entreprises qui sont des personnes physiques, comme les indépendants.
- Le RGPD s'applique aux noms. Un administrateur ou un gérant est une personne physique, même si son nom figure dans des comptes annuels publics. Qui conserve ou utilise des noms a besoin d'une base légale et doit respecter les droits de ces personnes.
- Licence et inscription. BCE Open Data et Public Search demandent une inscription et l'acceptation de conditions d'utilisation. Le fichier complet de la BCE demande un contrat de licence. Les services web de la BNB ont leurs propres conditions d'abonnement.
- Les conditions d'un fournisseur. Chez Jaarrekening.be, vous pouvez afficher et traiter les données récupérées dans votre propre produit ou vos systèmes internes. Revendre l'accès, partager votre clé avec des tiers ou republier de grandes parties de la base de données comme produit concurrent est interdit. Extraire systématiquement des données du site avec des scripts est interdit ; c'est à cela que sert l'API.
Développer soi-même ou acheter ?
-
Avez-vous seulement besoin de données d'identité ?
Alors la BCE suffit. Public Search pour des interrogations par entreprise, Open Data si vous voulez toutes les entreprises dans votre propre base de données et que quelqu'un peut suivre les mises à jour quotidiennes. -
Voulez-vous analyser vous-même les comptes annuels ?
Alors vous les récupérez à la Banque nationale. Prévoyez du temps de développement pour lire XBRL ou JSON par schéma et pour le couplage avec la BCE, et prenez Données améliorées si vous voulez aussi les dépôts PDF sous forme structurée. -
Voulez-vous des chiffres et ratios prêts à l'emploi pour une entreprise ?
Alors une API traitée revient généralement moins cher que de tout développer. Comptez combien d'entreprises vous interrogez par mois : quelques centaines tiennent dans un crédit mensuel, des dizaines de milliers dans un pack. -
Testez d'abord
Avec un compte gratuit, vous avez 10 requêtes par mois. Assez pour voir si les champs correspondent à ce dont votre logiciel a besoin, avant de choisir un plan ou un pack.
En résumé
Les données d'entreprises belges sont publiques, et les sources officielles les donnent gratuitement : la BCE l'identité, la Banque nationale les comptes annuels. Ce qu'elles ne donnent pas, c'est le travail qui suit : charger des fichiers chaque jour, lire les codes des rubriques par schéma, calculer les ratios et tout relier. Si vous préférez ne pas le faire vous-même, vous récupérez le tout traité via une API et payez par requête. Quelle que soit la voie choisie, la règle sur les données personnelles vaut partout : pas de marketing direct avec les données de personnes issues de la BCE.