Nouveau : analyse financière des entreprises belges via les comptes annuels de la BNB

En bref

L'API Company Belgium propose désormais l'analyse financière multi-années des entreprises belges via les comptes annuels officiels déposés à la Centrale des bilans de la BNB. Un seul appel suffit pour obtenir jusqu'à 10 exercices d'historique avec les ratios de solvabilité, d'endettement, de marge nette et de ROE déjà calculés.

Une nouvelle dimension pour vos données d'entreprise

Jusqu'à présent, l'API Company Belgium vous permettait de retrouver l'identité d'une entreprise belge : numéro BCE, dénomination, adresse, activités NACE, établissements, statut. Nous ajoutons aujourd'hui une brique attendue depuis longtemps : l'analyse financière basée sur les comptes annuels officiels déposés à la Centrale des bilans de la Banque nationale de Belgique (BNB). Pour rappel, l'API BCE Company Belgium permet déjà d'interroger les données d'identité de plus de 1,9 million d'entreprises.

Cette nouveauté vous permet, en un seul appel API, de récupérer plusieurs années d'historique financier pour n'importe quelle entreprise soumise à l'obligation de dépôt.

D'où viennent les données ?

Toutes les sociétés belges doivent déposer leurs comptes annuels auprès de la Centrale des bilans (CBSO) de la BNB. Ces comptes sont publics et constituent la source officielle de l'information financière des entreprises en Belgique.

Nous interrogeons directement l'API officielle de la CBSO pour récupérer, pour chaque dépôt :

• Le XBRL JSON structuré lorsque le format est disponible (depuis les dépôts récents)

• Le PDF original pour les dépôts plus anciens, avec extraction automatique des rubriques clés lorsque c'est possible

Seuls les dépôts de type Initial sont pris en compte (les corrections sont ignorées), et nous conservons un seul dépôt par exercice fiscal pour éviter les doublons.

Le nouvel endpoint

1

GET /api/companies/{enterpriseNumber}/financials?years=5

Exemple :

1

GET /api/companies/0403170701/financials?years=5

Le paramètre years permet de demander entre 1 et 10 exercices (5 par défaut). La réponse contient l'historique trié du plus récent au plus ancien.

Les rubriques extraites

Pour chaque exercice disponible, l'API retourne les rubriques standards du schéma comptable belge :

Les ratios calculés automatiquement

En plus des rubriques brutes, l'API calcule pour chaque année quatre ratios financiers clés :

• Ratio de solvabilité = Capitaux propres / Total de l'actif

• Ratio d'endettement (debt / equity) = Dettes / Capitaux propres

• Marge nette = Résultat de l'exercice / Chiffre d'affaires

• Rentabilité des capitaux propres (ROE) = Résultat de l'exercice / Capitaux propres

Plus besoin de parser vous-même le bilan : vous récupérez directement les indicateurs sur lesquels vos équipes risque, crédit ou commerciale vont réellement travailler.

Exemple de réponse

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

{
  "success": true,
  "data": {
    "enterpriseNumber": "0403170701",
    "enterpriseName": "SOCIETE EXEMPLE SA",
    "currency": "EUR",
    "yearsRequested": 5,
    "yearsAvailable": 5,
    "yearsWithXbrl": 4,
    "data": [
      {
        "year": 2024,
        "source": "xbrl",
        "turnover": 12500000,
        "profitLoss": 820000,
        "equity": 4200000,
        "totalAssets": 9800000,
        "debts": 5600000,
        "employees": 42
      }
    ],
    "ratios": [
      {
        "year": 2024,
        "solvencyRatio": 42.86,
        "debtToEquityRatio": 1.33,
        "netMarginRatio": 6.56,
        "returnOnEquityRatio": 19.52
      }
    ],
    "pdfOnlyDeposits": []
  }
}

Le champ pdfOnlyDeposits liste les exercices pour lesquels seul un PDF est disponible : vous pouvez alors télécharger le document original via /api/companies/{enterpriseNumber}/financials/pdf/{reference}.

Rapport PDF prêt à l'emploi

Pour les cas où vous avez besoin d'un livrable présentable (dossier client, comité de crédit, due diligence), l'API sait également générer un rapport financier PDF complet avec graphiques d'évolution, ratios et commentaires automatiques :

1

GET /api/companies/{enterpriseNumber}/financials/report

Performances et cache

Charger cinq années de comptes pour une entreprise implique plusieurs appels à la CBSO. Pour garder des temps de réponse raisonnables :

• Les dépôts sont chargés en parallèle par lots de 4, en respectant les limites de la BNB

• Chaque analyse est mise en cache côté serveur ; les requêtes suivantes sont quasi instantanées

• Les erreurs ponctuelles de la BNB (format indisponible, timeout) sont gérées sans casser l'analyse globale

Cas d'usage

• Scoring crédit et assurance-crédit : automatiser l'évaluation du risque fournisseur ou client

• KYC / due diligence renforcée : enrichir vos dossiers de conformité AML avec des indicateurs financiers — pour les obligations légales, consultez notre guide sur la vérification KYC automatisée par API

• CRM et outils commerciaux : qualifier vos prospects par taille, rentabilité, solvabilité

• Comptabilité et révision : consulter rapidement les comptes d'une contrepartie sans ouvrir le site de la BNB

• Recherche et statistiques : agréger des indicateurs sectoriels sur le tissu économique belge

Comment y accéder

L'endpoint est disponible dès aujourd'hui pour tous les comptes disposant d'une clé API active. Aucune configuration supplémentaire n'est requise : vous utilisez les mêmes en-têtes X-API-Key et X-API-Secret que pour le reste de l'API.

Pour démarrer, consultez la documentation de l'API ou testez directement l'endpoint depuis votre tableau de bord.

Et ensuite ?

Cette première version se concentre sur les rubriques standards et les ratios les plus utilisés. Nous préparons déjà :

• Une comparaison sectorielle automatique (percentiles NACE) — en attendant, découvrez comment comprendre les codes NACE belges pour interpréter les secteurs

• Des alertes sur les variations importantes d'une année à l'autre — combinables avec la veille BCE sur les mouvements d'entreprises

• L'export CSV / Excel des séries financières

• Un endpoint de recherche par critères financiers (CA, effectif, rentabilité)

Comme toujours, vos retours nous aident à prioriser. N'hésitez pas à nous écrire depuis votre espace support.