Situering

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

Verwante diensten

Om deze webservice te kunnen gebruiken moet er eerst een inschrijving in het MAGDA inschrijvingsrepertorium voor personen aangemaakt worden. Deze inschrijvingen kunnen toegevoegd, aangepast en verwijderd worden via de webservices Repertorium.RegistreerInschrijving en Repertorium.RegistreerUitschrijving.

Gegevensbronnen

De authentieke bron van de gegevens is het Rijksregister. 

Voor meer informatie met betrekking tot de inhoud van de persoonsgegevens wordt verwezen naar de Rijksregister onderrichtingen terug te vinden via volgende URL: http://www.ibz.rrn.fgov.be/index.php?id=2485&L=1.

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

Gebruiksvoorwaarden

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

• Toelating tot het MAGDA platform

• Machtiging van het sectoraal comité van het Rijksregister

Batch

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

Functionaliteiten

De webservice GeefHistoriekPersoon 2.0 laat de afnemer van het MAGDA platform toe historische gegevens van een persoon op te halen.

Vraag

De vraag van de afnemer dient het INSZ van de persoon en een datum te bevatten.  Er is de mogelijkheid om de gegevensevolutie op te vragen vanaf een bepaalde datum of de toestand van de gegevens op een bepaalde datum.

Antwoord

Eens de afnemer de request gelanceerd heeft wordt de vraag doorgestuurd naar het Rijksregister.

MAGDA ontvangt het antwoord en transformeert dit naar een ‘HistoriekPersoon.’ Afhankelijk van de verkregen machtigingen worden bepaalde gegevens al dan niet gefilterd.

In onderstaande "Uitbreid"-weergave vindt u een tabel die een overzicht van de in GeefHistoriekPersoon 2.0 beschikbare persoonsgegevens en hun relatie met de informatietypes van het Rijksregister weergeeft.

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

Anchor
opvraging opvraging

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, bijvoorbeeld de inschrijvingscontrole.

Hierna vindt er een functionele validatie plaats van de vraag (bijvoorbeeld checksum 97 op het INSZ). Nadien zal de webservice achterliggend het Rijksregister oproepen. Ontvangt de webservice een antwoord – hetzij de persoonsgegevens, hetzij een foutcode – wordt dit gevalideerd en omgezet in een MAGDA XML formaat. Het antwoord wordt nogmaals 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 beschikbaarheid van de gegevens is echter volledig afhankelijk van Rijksregister dat in principe 24/7 beschikbaar is.

Bij geplande onbeschikbaarheden van het Rijksregister worden de afnemers op de hoogte gebracht via mail. Bij een onverwachte onbeschikbaarheid wordt in het mate van het mogelijk een mail uitgestuurd (dit is als Digitaal Vlaanderen zelf op de hoogte gebracht wordt door Rijksregister).

Logging

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