Nieuw: financiële analyse van Belgische bedrijven via de jaarrekeningen van de NBB

In het kort

De Company Belgium API biedt nu meerjarige financiële analyse van Belgische bedrijven via de officiële jaarrekeningen bij de Balanscentrale van de NBB. Eén aanroep volstaat voor maximaal 10 boekjaren historiek met solvabiliteits-, schuld-, nettomarge- en ROE-ratio's al berekend.

Een nieuwe dimensie voor uw bedrijfsgegevens

Tot nu toe liet de Company Belgium API u de identiteit van een Belgisch bedrijf opvragen: KBO-nummer, benaming, adres, NACE-activiteiten, vestigingen, status. Vandaag voegen we een langverwachte bouwsteen toe: financiële analyse op basis van de officiële jaarrekeningen die zijn neergelegd bij de Balanscentrale van de Nationale Bank van België (NBB). Ter herinnering: de BCE Company Belgium API laat al toe de identiteitsgegevens van meer dan 1,9 miljoen ondernemingen op te vragen.

Met deze nieuwigheid kunt u, via één enkele API-aanroep, meerdere jaren financiële historiek opvragen voor elke onderneming met deponeringsplicht.

Waar komen de gegevens vandaan?

Alle Belgische vennootschappen moeten hun jaarrekeningen neerleggen bij de Balanscentrale (CBSO) van de NBB. Deze rekeningen zijn openbaar en vormen de officiële bron van financiële bedrijfsinformatie in België.

Wij bevragen rechtstreeks de officiële CBSO-API om voor elke neerlegging op te halen:

• De gestructureerde XBRL JSON wanneer het formaat beschikbaar is (voor recente neerleggingen)

• Het originele PDF-bestand voor oudere neerleggingen, met automatische extractie van de belangrijkste rubrieken waar mogelijk

Enkel neerleggingen van het type Initial worden verwerkt (correcties worden genegeerd), en we behouden één neerlegging per boekjaar om duplicaten te vermijden.

Het nieuwe endpoint

1

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

Voorbeeld:

1

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

Met de parameter years kunt u tussen 1 en 10 boekjaren opvragen (standaard 5). Het antwoord bevat de historiek van het meest recente naar het oudste boekjaar.

De geëxtraheerde rubrieken

Voor elk beschikbaar boekjaar retourneert de API de standaardrubrieken uit het Belgische boekhoudschema:

Automatisch berekende ratio's

Naast de ruwe rubrieken berekent de API voor elk jaar vier belangrijke financiële ratio's:

• Solvabiliteitsratio = Eigen vermogen / Totaal activa

• Schuldgraad (debt / equity) = Schulden / Eigen vermogen

• Nettomarge = Resultaat van het boekjaar / Omzet

• Rendement op eigen vermogen (ROE) = Resultaat van het boekjaar / Eigen vermogen

U hoeft de balans niet meer zelf te parseren: u krijgt rechtstreeks de indicatoren waar uw risk-, krediet- of salesteams effectief mee werken.

Voorbeeldantwoord

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": "VOORBEELD NV",
    "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": []
  }
}

Het veld pdfOnlyDeposits toont de boekjaren waarvoor enkel een PDF beschikbaar is: u kunt het originele document dan downloaden via /api/companies/{enterpriseNumber}/financials/pdf/{reference}.

Kant-en-klaar PDF-rapport

Voor situaties waarin u een presentabel document nodig heeft (klantendossier, kredietcomité, due diligence) kan de API ook een volledig financieel PDF-rapport genereren met evolutiegrafieken, ratio's en automatische commentaren:

1

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

Prestaties en caching

Vijf jaar jaarrekeningen laden voor één bedrijf vereist meerdere oproepen naar de CBSO. Om de responstijden redelijk te houden:

• De neerleggingen worden parallel per 4 geladen, met respect voor de NBB-limieten

• Elke analyse wordt server-side gecached; volgende verzoeken zijn vrijwel onmiddellijk

• Tijdelijke fouten bij de NBB (ontbrekend formaat, timeout) worden afgehandeld zonder de volledige analyse te breken

Gebruiksscenario's

• Krediet- en kredietverzekeringsscoring: automatiseer de risicobeoordeling van leveranciers of klanten

• KYC / verscherpte due diligence: verrijk uw AML-dossiers met financiële indicatoren — voor de wettelijke verplichtingen, lees onze gids over geautomatiseerde KYC-verificatie via API

• CRM en salestools: kwalificeer uw prospects op grootte, winstgevendheid, solvabiliteit

• Boekhouding en audit: raadpleeg snel de jaarrekeningen van een tegenpartij zonder de NBB-site te openen

• Onderzoek en statistieken: aggregeer sectorindicatoren over het Belgische economische weefsel

Hoe toegang krijgen

Het endpoint is vanaf vandaag beschikbaar voor alle accounts met een actieve API-sleutel. Er is geen bijkomende configuratie nodig: u gebruikt dezelfde X-API-Key- en X-API-Secret-headers als voor de rest van de API.

Om te starten, raadpleeg de API-documentatie of test het endpoint rechtstreeks vanuit uw dashboard.

En daarna?

Deze eerste versie richt zich op de standaardrubrieken en de meest gebruikte ratio's. We werken reeds aan:

• Een automatische sectorvergelijking (NACE-percentielen) — in afwachting, ontdek hoe NACE-codes in België werken

• Waarschuwingen bij belangrijke schommelingen van jaar tot jaar — te combineren met KBO-monitoring voor bedrijfsbewegingen

• CSV / Excel-export van financiële reeksen

• Een endpoint voor zoeken op financiële criteria (omzet, personeel, winstgevendheid)

Zoals altijd helpt uw feedback ons prioriteiten te stellen. Aarzel niet om ons te contacteren via uw supportruimte.