DIGITAAL VLAANDEREN
Beschrijving Antwoord (GeefJaarrekeningen-02.00)
Algemeen
De webservice maakt een response aan die op dezelfde manier opgebouwd is als de overige MAGDA-diensten.
Het antwoord bevat veelal één of meerdere jaarrekeningen van de opgegeven onderneming, rekening houdend met het opgegeven boekjaar. Indien gekend binnen MAGDA wordt ook de datum van laatste neerlegging opgenomen in het antwoord.
Het antwoord kan ook bestaan uit enkel datum van laatste neerlegging, dit indien er binnen MAGDA geen jaarrekening bekend is maar wel een neerleggingsdatum.
Indien het Paginatie element is opgegeven in de vraag zullen het aantal jaarrekeningen in het antwoord beperkt worden volgens de opgegeven paginatie waarden. Daarbij zullen ook in het antwoord de gegevens over de paginatie worden opgegeven.
XSD Visueel
Het antwoord volgende stukken stukken:
Lijst van jaarrekeningen
Het ondernemingsnummer met optioneel de datum van laatste neerlegging
In geval dat er een jaarrekening beschikbaar is:
De jaarrekening hoofding
meta-informatie (cf. Beschikbare JRK) nl. boekjaar, schema, aantal maanden, datum_AanmaakBestand_NBB)
De jaarrekening elementen
Rubriekcode
Bedragwaarde
Bedragtype (bedrag of aantal)
Bedrageenheid (EURO of andere eenheid bv. indien aantal)
Benaming
De optionele paginatie informatie
Detail
Opmerking:
Het antwoord bestaat standaard uit Context, Referte en Antwoord zoals beschreven in het document Gebruik Magda Webservices 02.00. Verder zal enkel aandacht besteed worden aan het specifieke Antwoord element.
Paginatie in detail
Element | Opmerking |
|---|---|
Huidig | Het huidige paginanummer. Komt overeen met het paginanummer in de vraag. |
Totaal | Het totaal aantal pagina’s waarvoor data beschikbaar is gebaseerd op het PaginaFormaat in de vraag. |
Indien paginatie gegevens worden opgegeven in de vraag en paginatie van toepassing is (de lijst van jaarrekeningen wordt ingekort owv de paginatie) zal een uitzondering 30107 “Gegevens beperkt door paginering“ van type INFORMATIE worden teruggegeven in het antwoord.
Indien in de vraag een pagina wordt opgevraagd die niet beschikbaar is zal de afnemer een uitzondering 30108 “Geen gegevens beschikbaar door paginering“ van type FOUT krijgen. Er is dan ook geen Inhoud element aanwezig in het antwoord.
Als bijvoorbeeld de afnemer pagina 3 opvraagt terwijl er maar 2 pagina’s aan data beschikbaar zijn, zal de uitzondering 30108 gegooid worden.
Jaarrekening in detail
Element | Opmerkingen | |
|---|---|---|
Ondernemingsnummer | De unieke identificatie van een onderneming, toegekend door KBO. Afhankelijk van de dienst en context staat het ondernemingsnummer soms ook voor de unieke identificatie van een vestigingseenheid (vestigingseenheidnummer). Komt steeds terug in het antwoord. | |
DatumLaatsteNeerlegging | Datum van de meest recente neerlegging bij de Nationale Bank België. Dit geeft een indicatie dat er een jaarrekening neergelegd werd. Veelal zal deze datum overeenkomen met de neerleggingsdatum in de hoofding. Is optioneel daar een neerleggingsdatum mogelijks niet gekend is. | |
Hoofding | Zie Hoofding hieronder. | |
Elementen | Bevat één tot n Element-elementen. | |
| Element | Zie Elementen hieronder. |
Hoofding in detail
Element | Opmerkingen | |||
|---|---|---|---|---|
AuthentiekeBron | Komt steeds terug in het antwoord. | |||
| Code | Bron van de gegevens. N voor Nationale Bank van België, G voor Graydon. Komt steeds terug in het antwoord. | ||
|
| @Beschrijving | Tekstuele beschrijving van de code. Zie Codetabellen. | |
| Omschrijving | Komt nooit terug in het antwoord | ||
|
| @Oorsprong | Komt nooit terug in het antwoord | |
|
| @TaalCode | Komt nooit terug in het antwoord | |
Boekjaar | Komt steeds terug in het antwoord. | |||
| Jaar | Jaar uit de ‘afsluitingsdatum van het boekjaar'. Onder de vorm van jjjj. Komt steeds terug in het antwoord. | ||
| Begin | Begindatum van het boekjaar. Onder de vorm jjjj-mm-dd. Komt steeds terug in het antwoord. | ||
| Einde | Afsluitingsdatum van het boekjaar. Onder de vorm jjjj-mm-dd. Komt steeds terug in het antwoord. | ||
| AantalMaanden | Aantal maanden van het boekjaar. Komt steeds terug in het antwoord. | ||
Schema | Komt steeds terug in het antwoord Zie Codetabellen | |||
| Code | Code van het neergelegde jaarrekeningschema | ||
|
| @Beschrijving | Code van het neergelegde jaarrekeningschema | |
| Omschrijving | Komt nooit terug in het antwoord | ||
|
| @Oorsprong | Komt nooit terug in het antwoord | |
|
| @TaalCode | Komt nooit terug in het antwoord | |
Kwaliteit | Komt steeds terug in het antwoord. Zie Codetabellen | |||
| Code | Externe vlag die de kwaliteit van de jaarrekening aangeeft. Mogelijke waardes: C, I, N, P. | ||
|
| @Beschrijving | Tekstuele beschrijving van de code | |
| Omschrijving | Komt nooit terug in het antwoord | ||
|
| @Oorsprong | Komt nooit terug in het antwoord | |
|
| @TaalCode | Komt nooit terug in het antwoord | |
NACE | Is optioneel daar een NACE code niet altijd gekend is. | |||
| Code | NACEBEL code die door de NBB aangereikt wordt. | ||
|
| @Beschrijving | Komt nooit terug in het antwoord | |
| Omschrijving | Komt nooit terug in het antwoord | ||
|
| @Oorsprong | Komt nooit terug in het antwoord | |
|
| @TaalCode | Komt nooit terug in het antwoord | |
| Versie | Versie (jjjj) van de NACEBEL code die door de NBB aangereikt wordt. 2003 of 2008. Zal altijd aanwezig zijn indien een NACE Code gekend is. | ||
ParitairComites | Is optioneel daar een paritair comité niet altijd gekend is. | |||
| ParitairComite | De NBB levert tot vijf paritaire comité codes aan per jaarrekening. | ||
|
| Code | Een paritair comité is een overlegorgaan tussen werkgevers en werknemers, voornamelijk met het oog op het onderhandelen van de collectieve arbeidsovereenkomst. Daaruit voortvloeiend ook het toezicht op de uitvoering ervan. | |
|
|
| @Beschrijving | Komt nooit terug in het antwoord |
|
| Omschrijving | Komt nooit terug in het antwoord | |
|
|
| @Oorsprong | Komt nooit terug in het antwoord |
|
|
| @TaalCode | Komt nooit terug in het antwoord |
SoortSchema | soort schema volgens hetwelk de jaarrekening is opgesteld, of het feit dat een oorspronkelijke neerlegging verbeterd wordt. Zie Codetabellen | |||
| Code | Lijst van mogelijke waarden kan je onderaan deze pagina terugvinden | ||
| Omschrijving | Bijhorende omschrijving kan je onderaan deze pagina terugvinden | ||
Aard | codes worden door de Balanscentrale toegekend in functie van de rechtsvorm, de aardcode en de tariefcode Zie Codetabellen | |||
| Code |
| ||
| Omschrijving |
| ||
NationaleBank | Komt altijd terug in het antwoord. | |||
| Referte | - | ||
|
| Deel1 | Eerste deel van het refertenummer dat aan de jaarrekening toegekend wordt in de NBB database | |
|
| Deel2 | Tweede deel van het refertenummer dat aan de jaarrekening toegekend wordt (volgnummer dat het veld nummer 15 vervolledigt) | |
| DatumAanmaakBestand | Datum van aanmaak van de kopie van het bestand. Onder de vorm jjjj-mm-dd | ||
| DatumModificatie | De datum waarop dit record (entiteit) het laatst gewijzigd werd bij de authentieke bron. Onder de vorm jjjj-mm-dd | ||
Munt | Muntcode. Komt steeds terug in het antwoord. | |||
Datum | - | |||
| VersieTaxonomie | Unieke identificatie van de versie van de ‘XBRL taxonomie voor gestandaardiseerde jaarrekeningen’ die in gebruik was op het moment dat de jaarrekening neergelegd werd. De datum van wanneer de taxonomie in voege treedt wordt als versie identificatie gebruikt, oorspronkelijk vanaf 1 april 2007. Maar voor het initiële laden en opstart zal de versie van 1 april 2008 gebruikt worden. Deze identificatie dient parameter gestuurd en wordt opgehaald bij de verwerking van de jaarrekeningen. Onder de vorm jjjj-mm-dd Komt steeds terug in het antwoord. | ||
| Neerlegging | Datum van neerlegging van de jaarrekening bij de nationale bank. Onder de vorm jjjj-mm-dd. Optioneel daar een neerleggingsdatum niet gekend kan zijn. | ||
| Goedkeuring | Datum van goedkeuring jaarrekening op de algemene vergadering. Onder de vorm jjjj-mm-dd. Optioneel daar een goedkeuringsdatum niet gekend kan zijn. | ||
| AkteOfStatus | Datum neerlegging oprichtingsakte of statuutwijziging. Onder de vorm jjjj-mm-dd. Optioneel, zal veelal niet terugkomen. | ||
Element in detail
Naam | Opmerking | |||
|---|---|---|---|---|
Naam | Naam van het element. Komt nooit terug in het antwoord. | |||
Volume |
| |||
| Deel | Positionering van het element binnen het jaarrekeningschema | ||
| Sectie | Sub-positionering van het element binnen het jaarrekeningschema, ‘0’ indien niet in gebruik | ||
| Subsectie | Sub-positionering van het element binnen het jaarrekeningschema, ‘0’ indien niet in gebruik | ||
| Volgorde | Volgorde van het element binnen het jaarrekeningschema. | ||
AantalBedrag | - | |||
| Waarde | Het bedrag dat dat teruggegeven wordt door de webservice. Negatieve bedragen of waarden worden voorafgegaan door een min teken ('-') | ||
| Type | Zie Codetabellen | ||
|
| Code | Code van het bedragtype van de rubriek: | |
|
|
| @Beschrijving | Beschrijving van de code. Zie Codetabellen. |
|
| Omschrijving | Komt nooit terug in het antwoord | |
|
|
| @Oorsprong | Komt nooit terug in het antwoord |
|
|
| @TaalCode | Komt nooit terug in het antwoord |
| Eenheid | Munteenheid (EUR) | ||
| DecimalenBetekenisvol | Duidt aan hoeveel van de impliciete decimale posities (de laatste twee cijfers in de waarde) echt in gebruik zijn. Bv. VTE's worden altijd gepreciseerd tot 1 cijfer na de komma: 2,5 VTE's zullen dus teruggegeven worden door de webservice met 250 als waarde en 1 als decimalen betekenisvol. De afnemer zou dit kunnen gebruiken om de betekenisloze decimale posities van de bedragen / waarden niet te tonen. Zo kan bij een DecimalenBetekenisvol = 0 de laatste twee cijfers van de waarde niet getoond worden daar deze 00 zullen zijn. Bij een DecimalenBetekenisvol = 2 zal het laatste cijfer van de waarde niet gelijk zijn aan 0. | ||
Rubriek | Code van de rubriek (het '/' teken dat in sommige rubriekcodes voorkomt, wordt opgenomen). Komt niet altijd terug. | |||
Benaming | Komt enkel terug indien opgegeven in de vraag. | |||
| Waarde | Waarde van de benaming voor deze rubriek | ||
| Stijl | Beschrijft de presentatie (ie. Heading0, Heading1, Heading2, Heading3, Heading4, Text1, Text2, Text3, Text4, nostyle. Nota: Heading0 is eigen creatie voor de hoofding van de delen, bestaat niet in de Taxonomie. nostyle indien geen style gedefinieerd werd in de Taxonomie) | ||
Titel |
| |||
| Code | ‘J’ > 1 = Element bevat enkel een titel ‘N’ > 0 = Element bevat naast de titel ook een aantal of bedrag | ||
|
| @Beschrijving | Zie Codetballen | |
| Omschrijving | Komt nooit terug in het antwoord | ||
|
| @Oorsprong | Komt nooit terug in het antwoord | |
|
| @TaalCode | Komt nooit terug in het antwoord | |
Kerngegeven |
| |||
| Code | ‘J’ > 1 = Element wordt beschouwd als een kerngegeven vanuit VKBO traditie ‘N’ > 0 = Element wordt niet beschouwd als een kerngegeven vanuit VKBO traditie | ||
| ||||