De GeefBeschikbareJaarrekeningen 2.0 businessdienst maakt het mogelijk om op basis van een ondernemingsnummer een overzicht van de beschikbare jaarrekeningen te verkrijgen. Van de jaarrekeningen komen enkel de hoofdingen terug evenals de neerleggingsdatums. Om de jaarrekeningelementen op te vragen dient men een oproep uit te voeren via de GeefJaarrekeningen 2.0.

Situering

Deze dienst kader binnen het domein Onderneming van MAGDA platform.

Verwante diensten

De afnemer kan na opvraging via GeefBeschikbareJaarrekeningen 02.00 met de dienst GeefJaarrekeningen 02.00 de eigenlijke elementen van de jaarrekening opvragen.

Gegevensbronnen

De gegevens zijn afkomstig uit de Balanscentrale van de Nationale Bank van België (NBB).

MAGDA heeft een eigen jaarrekening-databank opgebouwd, via een initiële oplaad-oefening van 5 jaargangen (2004-2008), gevolgd door een wekelijkse provisionering vanaf 2009 (vanuit NBB naar MAGDA). 

MAGDA onderhoudt deze eigen kopie van de jaarrekeningen, als optionele verrijking bij de KBO basisidentificatiegegevens van een onderneming.
Het dient gezegd dat de jaarrekeninggegevens ook raadpleegbaar zijn –via pdf- vanop de website van de NBB. De MAGDA-dienstverlening biedt daarentegen het voordeel dat deze data op elektronische wijze worden aangeboden, en rechtstreeks aanwendbaar zijn in een administratief proces.

Meer informatie over hoe deze bronnen gebruikt worden in de opbouw van het antwoord vindt u onder Opvraging.

Gebruiksvoorwaarden

Om gebruik te kunnen maken van deze dienst dient men een machtiging te hebben die toegang geeft tot deze gegevens en een aansluitingsprocedure te doorlopen.

Batch

Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.

Functionaliteiten

De GeefBeschikbareJaarrekeningen 2.0 businessdienst zal het mogelijk maken om op basis van een ondernemingsnummer een overzicht van de beschikbare jaarrekeningen te verkrijgen. Het antwoord bevat enkel de jaarrekeninghoofding, de jaarrekeningelementen worden niet in het xsd-schema opgenomen. 
Het antwoord bevat eveneens de neerleggingdatums van de jaarrekeningen. Indien een jaarrekening binnen VKBO niet beschikbaar is, maar er is wel een neerleggingsdatum bekend, dan heeft de afnemer toch een indicatie dat er een jaarrekening neergelegd is bij de NBB. 
De gegevens bevinden zich in de MAGDA database maar zijn afkomstig van de NBB en worden elke week geprovisioneerd.

Vraag

De vraag bestaat uit een verplicht ondernemingsnummer.

Antwoord

Als antwoord verkrijgt de afnemer een overzicht van de beschikbare jaarrrekeningen en/of neerleggingsdatums. Van de jaarrekeningen komen enkel de hoofdingen terug. Om de jaarrekeningelementen op te vragen dient men een oproep uit te voeren via de GeefJaarrekeningen 2.0.

Werking

Opties

Volgende configuratieparameters kunnen ingesteld worden in functie van de machtigingen en de wensen van de afnemer:

• Configuratieparameters op het MAGDA platform zijn voor deze dienst niet van toepassing

Opvraging

Van zodra de vraag gesteld is wordt er een XSD-validatie uitgevoerd. Is de ontvangen vraag XML niet geldig tegenover het schema, dan stopt de verwerking en wordt een foutmelding aangemaakt, anders gaat de verwerking verder. Na de XSD-validatie vinden de nodige authenticatie- en autorisatiecontroles plaats. 
Hierna vindt er een functionele validatie plaats van de vraag. Nadien zal de webservice achterliggend gegevens bewaard in de MAGDA database ophalen. 
Het ophalen gebeurt als volgt:

1. De webservice controleert in de databank of er jaarrekeningen beschikbaar zijn voor het opgegeven ondernemingsnummer

   • Is er geen jaarrekening gevonden, ga naar 4

   • Is er minstens één jaarrekening gevonden, ga naar 2

2. Haal de hoofdingen van de gevonden jaarrekeningen op. Ga naar drie

3. Van de gevonden jaarrekeningen worden eveneens de neerleggingsdatums opgehaald (indien beschikbaar). Ga naar 4.

4. De neerleggingsdatums van de onderneming worden opgehaald. Neerleggingsdatums die al opgehaald zijn in 3 worden niet meer opgehaald. Indien er geen neerleggingsdatums zijn worden deze niet opgenomen in het antwoord.

5. Sorteer het resultaat aflopend op neerleggingsdatum, boekjaar. Zijn er geen jaarrekeningen noch neerleggingsdatums gevonden verkrijgt de afnemer een uitzondering "geen gegevens gevonden."

Responsetijden & Beschikbaarheid

De webservice op het MAGDA platform is 24 uur op 24 en 7 dagen op 7 beschikbaar. De jaarrekeninggegevens worden wekelijks (op maandag) geprovisioneerd, de neerlegginggegevens elke werkdag. 
Bij geplande onbeschikbaarheden worden de afnemers op de hoogte gebracht.

Logging

De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".

Op deze pagina

Binnen deze handleiding

Omgevingsinformatie

Verwante diensten