Versions Compared
Version | Old Version 16 | New Version Current |
---|---|---|
Changes made by | ||
Saved on |
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Algemeen
Het antwoord bestaat uit een Resultaat-element dat aangeeft of de wijziging al dan niet geslaagd is, en de gegevens van de persoon ná de wijziging, en/of één of meerdere Uitzonderingen. Het is mogelijk dat, ook al komen er persoonsgegevens terug, het antwoord één of meerdere Uitzonderingen bevat. Afhankelijk van de verkregen juridische toegang tot persoonsgegevens zullen bepaalde gegevens niet in het antwoord opgenomen worden.
XSD Visueel
Overzicht


Detail
Note |
---|
Opmerking:Het antwoord bestaat standaard uit Context, Referte en Antwoord zoals beschreven in het document Gebruik Magda Webservices 02.00. Verder zal enkel aandacht besteed worden aan het specifieke Antwoord-element. |
Antwoord in detail
MAGDA Antwoord | Omschrijving | ||||
---|---|---|---|---|---|
Resultaat | Aanduiding of de wijziging van de persoon al dan niet geslaagd is. | ||||
Code | De code van het resultaat (0 of 1). | ||||
Omschrijving | Omschrijving van de code in het resultaat, 0=’Niet geslaagd’, 1=’Wel geslaagd’ | ||||
@Taal | De taal van de omschrijving. Deze correspondeert met de Taal in de Vraag en is in dit geval altijd "nl". | ||||
Persoon | De persoonsgegevens na de wijziging. Zie voor verdere details zie Element Persoon hieronder. |
Anchor | ||||
---|---|---|---|---|
|
Element Persoon
XSD visueel


Element Persoon in detail
De onderstaande tabel verwijst voornamelijk naar de standaardtypes die MAGDA gebruikt voor de verschillende gegevensblokken over verschillende diensten heen. Het verschil met deze dienst is de toevoeging van het attribuut Status (daar waar toepasselijk). Dit attribuut bevat informatie over de status van de de gevraagde wijziging. Deze kan geslaagd, niet geslaagd, doorgestuurd, of niet aangevraagd zijn. De status kan per gegevensblok verschillen.
Daar waar in deze dienst bepaalde elementen of attributen van de standaard MAGDA-types nietgebruikt worden, is dit aangegeven in onderstaande tabel.
MAGDA Antwoord | Omschrijving | ||||
---|---|---|---|---|---|
@DatumBegin | |||||
@DatumEinde | |||||
@Bron | |||||
INSZ | Bevat het INSZ-nummer van de persoon. | ||||
Naam | De verschillende voor- en achternamen van de persoon. Tot 15 achternamen en 14 voornamen mogelijk. Voor details zie Naam (PersoonType-02.02). Het attribuut DatumEinde wordt niet gebruikt. | ||||
@Status | Een attribuut dat de status aangeeft van de wijziging. Zie voor mogelijke waarden Codetabellen: Status. | ||||
Geslacht | Geslacht van de persoon. Voor details zie Geslacht (PersoonType-02.02). Het attribuut DatumEinde wordt niet gebruikt. | ||||
@Status | Een attribuut dat de status aangeeft van de wijziging. Zie voor mogelijke waarden Codetabellen: Status. | ||||
Register | Het register waaruit de persoonsgegevens afkomstig zijn. Voor details zie Register (PersoonType-02.02). Het attribuut DatumEinde wordt niet gebruikt. | ||||
Nationaliteiten | De lijst van nationaliteiten van de persoon. Voor details zie Nationaliteiten/Nationaliteit (PersoonType-02.02). Het attribuut DatumEinde wordt niet gebruikt. | ||||
@Status | Een attribuut dat de status aangeeft van de wijziging. Zie voor mogelijke waarden Codetabellen: Status. | ||||
Geboorte | De geboortegegevens van de persoon. Voor details zie Geboorte (PersoonType-02.02). Het attribuut DatumBegin wordt niet gebruikt. | ||||
@Status | Een attribuut dat de status aangeeft van de wijziging. Zie voor mogelijke waarden Codetabellen: Status. | ||||
Overlijden | De overlijdensgegevens van de persoon. Voor details zie Overlijden (PersoonType-02.02). Het attribuut DatumBegin wordt niet gebruikt. | ||||
@Status | Een attribuut dat de status aangeeft van de wijziging. Zie voor mogelijke waarden Codetabellen: Status. | ||||
BurgerlijkeStaten | De lijst van burgerlijke staten van de persoon. Voor details zie BurgerlijkeStaten/BurgerlijkeStaat (PersoonType-02.02). Het attribuut DatumEinde wordt niet gebruikt. | ||||
@Status | Een attribuut dat de status aangeeft van de wijziging. Zie voor mogelijke waarden Codetabellen: Status. | ||||
Adressen | De geregistreerde adressen van de persoon. | ||||
Hoofdverblijfplaats | Hoofdadres van de persoon. | ||||
@Status | Een attribuut dat de status aangeeft van de wijziging. Zie voor mogelijke waarden Codetabellen: Status. | ||||
ContactAdres | Belgisch contactadres van een persoon in het KSZ RAD- of BIS-register. Voor details zie Adressen/Contactadres (PersoonType 02.02). | ||||
@Status | Een attribuut dat de status aangeeft van de wijziging. Zie voor mogelijke waarden Codetabellen: Status. |
BeStAdd- en OSLO-adressen
Hoofdverblijfplaats en Contactadres worden doorgegeven in een uitgebreide OSLO - adresvoorstelling formaat. Dit is de OSLO-Adresvoorstelling, zoals bepaald door het OSLO-team op hun website. Deze adresvoorstelling is uitgebreid met de adresdata die in de vorige versie van deze dienst werden doorgegeven plus de BeStAdd-identificatoren.
Bij de CreeerBIS dienst zal Hoofdverblijplaats steeds een buitenlands adres zijn en dus zullen de BeStAdd gegevens voor dit element bij deze dienst nooit ingevuld zijn!
KSZ zal enkel de identificator van het BeStAdd adres doorgeven. Deze zit in het VerwijstNaar element. De elementen GemeenteBeStAddId en StraatBeStAddId zullen door de KSZ nooit ingevuld worden. Dit was oorspronkelijk wel de bedoeling en deze elementen zijn enkel behouden owv legacy doeleinden.

Element | Omschrijving |
---|---|
LokaleIdentificator | Het ID van het BeStAdd adres |
Naamruimte | URI die aantoont welke de authentieke bron is van het ID. Dit kan Vlaanderen, Walonië of Brussel zijn |
VersieIdentificator | De versie van het ID. |
Meer informatie kan gevonden worden op de pagina met wijzigingen voor de Versie 02.02 diensten.
Aanpassing van gegevens
Voor BIS nummers:
Bij aanpassingen die onmiddellijk gebeuren (bv adres, burgerlijke staat,...) geeft KSZ een bevestiging mee in het antwoordbericht.
Indien je achternaam, voornaam, geboortedatum, overlijdensdatum wil aanpassen, kan dit niet zomaar, dit moet via de cel identificatie gebeuren
Als cel identificatie aanpassing doet, komt er een persoon notificatie in de Persoon.GeefPersoonMutatiesNotificaties-02.00 dienst. Als cel identificatie niets doet wordt geen notificatie gegeven.
Het vervangen van een BISnr door een ander BISnr of RRnr moet altijd via de cel identificatie gebeuren.
Codetabellen Antwoord
Anchor | ||||
---|---|---|---|---|
|
Codetabellen zijn opgenomen in de respectievelijke detailpagina's van de gegevensblokken.
Resultaat
Element | Code | Omschrijving |
---|---|---|
Resultaat/Code | 0 | Niet geslaagd |
Resultaat/Code | 1 | Wel geslaagd |
Status
Strikt genomen is Status geen codetabel, maar de mogelijke waarden die het attribuut status kan aannemen zijn de volgende:
Status | Omschrijving |
---|---|
Geslaagd | De bijwerking is geslaagd |
Niet geslaagd | De bijwerking is niet gelukt |
Geen aanpassing gevraagd | Voor deze gegevensgroep werd geen aanpassing gevraagd |
Doorgestuurd | Het voorstel tot bijwerking werd doorgestuurd ter bijwerking |
Op deze pagina
Table of Contents | ||||
---|---|---|---|---|
|
Binnen deze handleiding
Child pages (Children Display) | ||
---|---|---|
|
Info |
---|
Met vragen kunt u steeds terecht bij de MAGDA Service Desk. |