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.

Om een nieuwe persoon te registeren in de KSZ-registers kan de dienst Persoon.CreeerBIS-02.02 worden gebruikt.

Gegevensbronnen

De authentieke bron van de gegevens is de KSZ (BIS/RAD/RAN).

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

• Juridische toegang tot persoonsgegevens

Batch

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

Functionaliteiten

De webservice WijzigKSZPersoon-02.02 laat de afnemer van het MAGDA-platform toe om de persoonsgegevens van een persoon in de KSZ-registers (BIS, RAD of RAN) te wijzigen. Deze wijziging gebeurt op basis van een INSZ-nummer, aangevuld met de gegevens van de persoon. 

Eens de afnemer de request gelanceerd heeft, wordt de vraag doorgestuurd naar de KSZ. De KSZ voert de wijziging uit en retourneert daarna de huidige staat van de persoonsgegevens, inclusief een status met informatie of de wijziging al dan niet gelukt is. Deze status wordt doorgegeven op het niveau van individuele gegevensblokken. MAGDA ontvangt het antwoord en transformeert dit naar een Antwoord voor de afnemer. Afhankelijk van de verkregen juridische toegang tot persoonsgegevens worden bepaalde gegevens al dan niet gefilterd. 

Werking

Opties

Volgende configuratieparameters kunnen op het MAGDA-platform ingesteld worden in functie van de verkregen juridische toegang tot persoonsgegevens door de afnemer 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 Person.searchPersonBySsin operatie van de KSZ oproepen. MAGDA doet dit om de huidige gegevens van de persoon op te vragen (de KSZ vereist zowel een set huidige gegevens als een set gewijzigde gegevens voor de wijziging).

Als blijkt dat de persoon in kwestie van INSZ is veranderd, dan stopt de verwerking hier al, en zal MAGDA geen wijzigingsverzoek aan de KSZ sturen middels de CbssPerson.updatePerson operatie van de KSZ. Het is dan aan de afnemer om eerst zijn lokale registers up-to-date te brengen, alvorens de wijzigingsvraag opnieuw te sturen (ditmaal met het nieuwe INSZ-nummer).

Wanneer MAGDA succesvol de huidige gegevens van een persoon heeft kunnen bekomen, dan volgt een wijzigingsverzoek naar de KSZ met de gewijzigde gegevens zoals doorgegeven door de afnemer.

Ontvangt de webservice een antwoord – hetzij de nieuwe 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.

Responstijden & Beschikbaarheid

Logging

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

Op deze pagina

Binnen deze handleiding

Omgevingsinformatie