DIGITAAL VLAANDEREN

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

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 webservice GeefDeelnemingen laat drie vraagstellingen toe: in welke ondernemingen heeft onderneming x een deelneming, welke ondernemingen hebben een deelneming in onderneming y en heeft onderneming x een deelneming in onderneming y.

Wijzigingshistoriek

DatumAanpassingen

 

Importeren van de handleiding in Confluence

Situering

Deze dienst kadert binnen het domein Onderneming van het MAGDA platform.

Verwante diensten

Gegevensbronnen

De authentieke bron van de gegevens is de Nationale Bank België.

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

Opmerking:

Agentschap Informatie Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens. 

Gebruiksvoorwaarden

Afnemers moeten aan volgende voorwaarden voldoen om deze dienst te mogen gebruiken:

  • Toelating tot het MAGDA platform


Informatie:

Meer informatie over deze voorwaarden is terug te vinden op de pagina “Machtigingen en toelatingen”.


Batch

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

Prefix
GDeD
Voorbeeld

GDeD _20131103115553530.

Functionaliteiten

Vraag

De webservice GeefDeelnemingen laat drie vraagstellingen toe:

  1. in welke ondernemingen heeft onderneming x een deelneming;
  2. welke ondernemingen hebben een deelneming in onderneming y;
  3. heeft onderneming x een deelneming in onderneming y.

Antwoord

Van deze vraagstellingen krijgt de afnemer steeds de laatst gekende gegevens. Het is mogelijk om een periode in de vraag op te geven. In dat geval verkrijgt men in het antwoord enkel de gegevens die vallen in die periode. Wordt de periode opgegeven, dan moet de einddatum gelijk of recenter zijn dan de begindatum.


De nodige xsd-validaties van de vraag en antwoord worden uitgevoerd. De gegevens bevinden zich in een MAGDA databank en worden geprovisioneerd vanuit de Nationale Bank België.


Zijn er geen gegevens gevonden verkrijgt men een gepaste foutmelding. Enkel geldige ondernemingsnummers zijn toegelaten (numeriek 10 lang, er is een controle op checksum 97).  Er wordt geen controle uitgevoerd of het een bestaand ondernemingsnummer betreft.



Werking

Aandachtspunten

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

  • Checksum 97 controle op het ondernemingsnummer (of ondernemingsnummers). Fout: 20007
  • Periode in de vraag: begindatum moet ouder of gelijk zijn aan de opgegeven einddatum. Fout: 20003
  • Indien twee keer “DeelnemingIn” of “Deelnemer” opgegeven werd. Fout: 30008

Indien aan één functionele validatie niet voldaan wordt stopt de verwerking en verkrijgt men een gepaste uitzondering.

Indien er geen functionele validatiefout is opgetreden zal de webservice de gegevens ophalen uit de MAGDA databank en omvormen tot een geldige xml. Indien er geen gegevens gevonden werden voor de vraag verkrijgt men als fout 30001.

Voor de ISOCode in het antwoord zal een NISCode toegevoegd worden. Indien dit niet mogelijk is wordt er uitzondering (van het type Waarschuwing) toegevoegd aan de deelneminggegevens.

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. Bij geplande onbeschikbaarheden worden de afnemers op de hoogte gebracht via mail.

Opmerking:

De MAGDA response tijden zijn heel sterk afhankelijk van de response tijden van de bron. Als de brongegevens heel traag worden aangeleverd kan het MAGDA antwoord niet snel worden aangeleverd. 

Logging

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


Op deze pagina

Binnen deze handleiding

Omgevingsinformatie

Functioneel DomeinOnderneming
ClassificatieNiet privacygevoelig

Verwante diensten

  • Page:
    Onderneming.GeefBeschikbareJaarrekeningen-02.00 (MAGDA Gebruikersomgeving) 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.
  • Page:
    Onderneming.GeefDeelnemingen-02.00 (MAGDA Gebruikersomgeving) — De webservice GeefDeelnemingen laat drie vraagstellingen toe: in welke ondernemingen heeft onderneming x een deelneming, welke ondernemingen hebben een deelneming in onderneming y en heeft onderneming x een deelneming in onderneming y.
  • Page:
    Onderneming.GeefJaarrekeningen-02.00 (MAGDA Gebruikersomgeving) — 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.
  • Page:
    Onderneming.PubliceerDeelnemingen-02.00 (MAGDA Gebruikersomgeving) — De PubliceerDeelnemingen 2.0 laat toe de NBB Deelneminggegevens te publiceren in xml- als in csv-formaat. Afnemers kunnen de gepubliceerde gegevens vervolgens via FTP opvragen.










  • No labels