> ## Documentation Index
> Fetch the complete documentation index at: https://docs.otbstudio.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# De data correct lezen

> Belgische ondernemingsdata correct lezen: codes zonder label, afsluitdatums, VTE-werknemers, geschrapte ondernemingen, adressen, lopende mandaten, verbeterde neerleggingen en de datum van eigendomsgegevens.

Ze staan hier en in de beschrijvingen van de MCP-tools, omdat een agent ze even hard nodig heeft als een ontwikkelaar.

> **1. statusCode en juridicalFormCode zijn ruwe codes zonder label**
>
> Labels worden nog niet meegeleverd. Toon de code, of vertaal ze met de referentielijsten van de KBO.

> **2. closingDate is geen kalenderjaar**
>
> De cijfers komen uit één neerlegging, en de afsluitdatum is de laatste dag van de periode waarop ze betrekking heeft, vaak niet 31 december. Het record heeft geen begindatum van de periode, dus beschrijf de cijfers niet als die van een bepaald jaar. Vermeld de afsluitdatum naast het cijfer.

> **3. employees is een gemiddeld aantal VTE, geen aantal personen**
>
> Het is een decimaal getal: 19,7 is een echte waarde. Afronden naar 19 suggereert een precisie die de bron niet heeft.

> **4. Een geschrapte onderneming wordt teruggegeven, niet verborgen**
>
> `deleted: true` betekent dat de entiteit in het bronregister als geschrapt gemarkeerd is en dat haar gegevens historisch zijn. Zoeken laat ze weg. Een opzoeking op nummer niet.

> **5. Adressen zijn niet altijd volledig**
>
> Van veel ondernemingen is geen straatadres bekend. De postcode is er bijna altijd. Behandel het straatadres als aanwezig of afwezig, niet als gegarandeerd.

> **6. Lees current bij een mandaat, nooit de datums**
>
> Bijna de helft van de bekende mandaten is beëindigd, en `endDate` is meestal het einde van de termijn, zodat een zittende raad vaak is neergelegd met een einddatum jaren in de toekomst. Iemand als bestuurder noemen van een onderneming die hij verlaten heeft, is precies de fout die `current` moet voorkomen. Vroegere mandaten blijven bewaard, want "wie leidde dit in 2019" is een terechte vraag.

> **7. Een verbetering is het cijfer, geen dubbel**
>
> De route voor financiële gegevens geeft één neerlegging per periode terug. Werd een neerlegging verbeterd, dan geeft ze de verbetering terug, met de vlag `corrected`. Een rij met de vlag `comparative` is overgenomen uit de kolom van het vorige boekjaar in een latere neerlegging: behoud de cijfers, maar citeer de referentie niet, want die kan niet worden opgezocht.

> **8. Een eigendomsitem draagt zijn eigen ouderdom en betrouwbaarheid**
>
> Lees `asOf` en `exact` voor u een belang als actueel behandelt. Een item zonder percentage, zonder datum en met `exact: false` is meestal een oud record uit een ander systeem. `stakePercent` is een echt percentage: 50 is de helft van de onderneming.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.