De GeefJaarrekeningen 2.0 webservice maakt het mogelijk om op basis van een ondernemingsnummer de actuele jaarrekening op te vragen. Wordt er een boekjaar in de vraag meegegeven, dan verkrijgt de afnemer de jaarrekening die op het opgegeven boekjaar geldig was.

Situering

Deze dienst kadert binnen het domein Onderneming van MAGDA platform

Verwante diensten

• GeefBeschikbareJaarrekeningen 2.0 

• GeefDeelnemingen 2.0

• PubliceerJaarrekening

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 aansluitingsprocedure te doorlopen. Er is geen machtiging nodig.

Batch

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

Functionaliteiten

De dienst maakt het mogelijk om op basis van een ondernemingsnummer de actuele jaarrekening op te vragen. Wordt er een boekjaar in de vraag meegegeven, dan verkrijgt de afnemer de jaarrekening die op het opgegeven boekjaar geldig was.

Door een boekjaar in de vraag toe te voegen aan de GeefJaarrekeningen 2.0 was het mogelijk de GeefJaarrekeningOpTijdstip 01.01 te schrappen.

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, het boekjaar en daarbij verschillende vlag-elementen. De betekenis van deze vlaggen wordt verder in deze handleiding uit de doeken gedaan.

Antwoord

Als antwoord verkrijgt de afnemer de jaarrekening (actuele of op tijdstip) van de gevraagde onderneming, hierbij rekening houdend met de opgegeven vlaggen.

Werking

Aandachtspunten

• Nieuw in deze versie is dat de datum van neerlegging (indien beschikbaar) opgenomen wordt in het antwoord.

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.

Zijn er geen gegevens gevonden, dan verkrijgt de afnemer een Uitzondering. Is er minstens één jaarrekening gevonden, dan bevat het antwoord op zijn minst een hoofding. 

Het antwoord wordt gevalideerd waarna het aan de afnemer ter beschikking gesteld wordt.

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