Onderneming.GeefJaarrekeningen-02.00
Informatie:
Voor de ontsluiting van een MAGDA 2.0 webservice, alsook het generieke proces binnen een 2.0 webservice, wordt verwezen naar Werking en gebruik MAGDA 2.0 Webservices.
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
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.
Opmerking:
Agentschap Digitaal Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens.
Gebruiksvoorwaarden
Om gebruik te kunnen maken van deze dienst dient men een aansluitingsprocedure te doorlopen. Er is geen machtiging nodig.
Informatie:
Meer informatie over het aansluitingsproces is terug te vinden op deze webpagina.
Batch
Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.
Prefix | GJRK |
---|---|
Voorbeeld | GJRK_20131103115553530.xml |
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
Domein | Onderneming |
---|---|
Classificatie | Geen persoonsgegevens |
Verwante diensten
Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren
De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid
uitgegeven door Digitaal Vlaanderen