Wijzigingshistoriek

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.

Na het ontvangen van de gezinssamenstelling kan indien gewenst de volledige informatie van een individueel gezinslid opgevraagd worden via de /wiki/spaces/MDI/pages/174030851 of /wiki/spaces/MDI/pages/1006668903 dienst

Gegevensbronnen

De authentieke bron van de gegevens is KSZ/RAD dat achterliggend ook het Rijksregister gebruikt.

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 de Sociale Zekerheid

Batch

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

Functionaliteiten

De webservice GeefGezinssamenstelling 2.02 laat de afnemer van het MAGDA platform toe om de gezinssamenstelling van een persoon op te vragen bij de KSZ. Deze bevraging gebeurt op basis van een INSZ-nummer. 

Eens de afnemer de request gelanceerd heeft wordt de vraag doorgestuurd naar de KSZ. MAGDA ontvangt het antwoord en transformeert dit naar een lijst van één of meerdere gezinsleden. Afhankelijk van de verkregen machtigingen worden bepaalde gegevens al dan niet gefilterd. De lijst van gezinsleden kan maximaal 250 afzodnerlijke gezinsleden bevatten.

In de v3 service van KSZ kon gekozen worden om naast de gegevens omtrent de gezinssamenstelling ook de persoonsgegevens van elk gezinslid op te vragen. De v4 service upgrade biedt deze mogelijk niet meer. KSZ retourneert altijd een (beperkte) set persoonsgegevens.

Naast de relationele gegevens van een Gezinslid (de Positie in het gezin en de Woonvorm), bevat het antwoord ook voor ieder Gezinslid bovengenoemde beperkte set persoonsgegevens. Onderstaande tabel geeft een overzicht van deze (potentieel) beschikbare persoonsgegevens:

Werking

Opties

Volgende configuratieparameters kunnen op het MAGDA platform 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 de FamilyComposition.searchFamilyCompositionBySsin operatie 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.

Responsetijden & Beschikbaarheid

Logging

De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina Logging diensten.