Situering

De dienst ‘WijzigKSZPersoon 2.0’ geeft de afnemer de mogelijkheid een persoon te wijzigen in de registers van KSZ.

Gegevensbronnen

De authentieke bron van de gegevens is de KSZ.

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 webservice te mogen gebruiken:

• Toelating tot het MAGDA platform

• Machtiging van het sectoraal comité van het Rijksregister

• EN/OF Machtiging van het sectoraal comité van de Sociale Zekerheid

Batch

Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML).

Hiervoor moet men de Service-XSD gebruiken en niet de Webservice. Door de Service-XSD te gebruiken zijn er meerdere vragen mogelijk in één bestand. De vraag-bestanden worden op de MAGDA FTP geplaatst in een afnemer specifieke folder. Deze folder wordt tijdens het aansluitingsproces toegekend.

Als prefix voor de batchbestanden wordt WKPD gebruikt.

Meer informatie hierover kan u vinden via “Aansluiting op het MAGDA-platform” in het document “MS – Gebruikershandleiding_WebserviceInBatch”, of neem contact op met de MAGDA Service Desk.

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

Functionaliteiten

De request bestaat uit de te wijzigen gegevens van een persoon en diens INSZ-nummer. Het is niet mogelijk om personen met een rijksregisternummer te wijzigen. Wijzigingen zijn enkel mogelijk om personen uit de eigen KSZ-registers aan te passen (RAD-register, BIS-register).

De mogelijk te wijzigen gegevens zijn:

• Naam

• Nationaliteiten

• Geboorte

• Overlijden

• Geslacht

• BurgerlijkeStaten

• Hoofdverblijfplaats

Indien een wijziging niet slaagt krijgt de afnemer een uitzondering terug met de reden waarom de wijziging niet geslaagd is.

Het antwoord bevat de persoon met de gewijzigde gegevens

Opvraging

Van zodra de vraag (in deze dienst is dat de wijziging van de gegevens van een persoon) 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 de functionele validatie plaats (bijvoorbeeld Checksum 97 op het INSZ).

Eens al deze controles geslaagd zijn wordt achterliggend de GeefPersoon-dienst opgeroepen, deze vult de bestaande persoonsgegevens aan in de vraag.

Op deze wijze ontstaat er een structuur met een nieuwe persoon (de gewijzigde gegevens) en een oude persoon (de gegevens opgehaald met GeefPersoon 2.0). Deze samengestelde vraag wordt doorgestuurd naar KSZ.

Bij KSZ gebeurd er een controle op de gegevens om te kijken of deze niet conflicteren met de bestaande gegevens in de registers. Indien niet geeft KSZ in het antwoord terug dat de wijziging geslaagd is, indien er een conflict opgetreden is stuurt KSZ een uitzondering in het antwoord met de reden waarom de wijziging niet geslaagd is.

Dit antwoord wordt gevalideerd tegenover de XSD 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.

Logging

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

Ondersteunde talen

MAGDA ondersteunt de Nederlandse taal.

Indien in de brongegevens de Nederlandse tekst niet beschikbaar is voor een bepaald element zal de eerste vertaling van de tekst in de brongegevens gebruikt worden, onafhankelijk van de taal waarin dit gegeven beschikbaar is.

Op deze pagina

Binnen deze handleiding

Omgevingsinformatie