De webservice GeefPersoon 2.0 laat de afnemer van het MAGDA platform toe de actuele gegevens van een persoon op te halen, dit op basis van het INSZ van deze persoon, bij het Rijksregister of via KSZ.

Situering

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

Gegevensbronnen

Open

De authentieke bron van de gegevens is het Rijksregister of de KSZ.

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/nl/rijksregister/reglementering/onderrichtingen/

De KSZ heeft de services om persoonsgegevens op te halen gemoderniseerd en zich daarbij meer gealigneerd op de gegevens beschikbaar in het Rijksregister. De gemoderniseerde diensten vervangen de bestaande diensten niet, maar worden additioneel aangeboden door de KSZ. De gemoderniseerde diensten worden door KSZ aangeboden op hun SOA omgeving. De bestaande diensten zijn de SSDN diensten.

Met de MAGDA diensten kunnen zowel de gemoderniseerde als de bestaande diensten van KSZ opgeroepen worden.

Voor de KSZ wordt verwezen naar de documenten beschikbaar op hun website:

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

Vraag

De webservice GeefPersoon 2.0 laat de afnemer van het MAGDA platform toe de actuele gegevens van een persoon op te halen, dit op basis van het INSZ van deze persoon.

Antwoord

Eens de afnemer de request gelanceerd heeft wordt de vraag doorgestuurd naar het Rijksregister of de kruispuntbank van de Sociale Zekerheid, de KSZ. Dit is afhankelijk van de machtigingen van de afnemer en de bronkeuze in de vraag. (Deze bronkeuze wordt nader besproken verder op deze pagina)

MAGDA ontvangt het antwoord en transformeert dit naar een Persoon.

Onderstaande tabel geeft een overzicht van de in de GeefPersoon 2.0 beschikbare persoonsgegevens en hun relatie met de informatietypes van het Rijksregister. Persoonsgegevens via de KSZ zijn beperkter, hier is opgenomen of ze potentieel beschikbaar zijn.

Werking

Opties

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

• Op te roepen bron: tot twee bronnen kunnen geconfigureerd worden

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 transactie 25 bij het Rijksregister of de IdentifyPerson service van KSZ 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.

Werking met betrekking tot de bronnen

In principe gebeurt de opzoeking bij de in de vraag gekozen bron; het Rijksregister of de KSZ.

KSZ is dan weer onder te verdelen in twee ‘bronnen’

• KSZ: de oude ‘SSDN’ omgeving van de Kruispuntbank. Deze diensten zullen op termijn uitgefaseerd worden door KSZ maar KSZ heeft hierover nog geen beslissing genomen

• KSZ SOA: de nieuwe Service Oriented Architecture omgeving van de Kruispuntbank Sociale Zekerheid.

Afhankelijk van de machtigingen van de afnemer en in samenspraak met de afnemer is het echter mogelijk dat beide bronnen toegankelijk zijn, waarvan één als primaire en één als secundaire bron voor de afnemer ingesteld is.

In theorie kan een afnemer toegang verkrijgen tot drie bronnen: KSZ,SOA, RR. In praktijk zal KSZ en SOA nooit samen geconfigureerd worden als beschikbare bronnen voor een afnemer.

Indien er voor de afnemer een primaire en een secundaire bron geconfigureerd is én indien de vraag bij de primaire bron geen resultaat geeft, zal de dienst automatisch een bevraging doen bij de secundaire bron.

Echter, indien er een bron opgegeven wordt in de vraag, dan geldt deze automatische doorschakeling niet, ook al is de bron in de vraag de primaire bron! 

Volgende stappen worden dus doorlopen:

Is er een bron ingevuld in de vraag?

               Ja           →           enkel deze bron wordt geraadpleegd.

               Neen      →          doe eerst de bevraging bij de primaire bron en vervolgens:

                                            Zijn er resultaten?

                                                           Ja           →           verder geen eventuele secundaire bron raadplegen.

                                                           Neen     →           indien er een secundaire bron is, dan deze raadplegen.

Responsetijden & Beschikbaarheid

Logging

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

Op deze pagina

Binnen deze handleiding

Omgevingsinformatie