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

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 Inhoud/			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.

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 niet gebruikt worden, is dit aangegeven in onderstaande tabel.

MAGDA Antwoord Inhoud/Persoon/			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. Het attribuut GebruikelijkeVoornaam op Voornaam 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. De elementen Verwerving en Tekst worden 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. Het attribuut DatumEinde wordt niet gebruikt. De elementen AanvullendRegister, Bewijsstuk en DabsDocumentReferte worden 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. Het attribuut DatumEinde wordt niet gebruikt. Elementen Aktenummer, AanvullendRegister, Beslissing en DabsDocumentReferte worden 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. Het attribuut Partner/Naam@DatumEinde wordt niet gebruikt. Het attribuut Partner/Naam/Voornaam@GebruikelijkeVoornaam wordt niet gebruikt. De elementen Partner/Geslacht en Partner/geboortedatum worden niet gebruikt. De elementen Aktenummer, AanvullendRegister en DabsDocumentReferte worden niet gebruikt. De elementen Uitspraak/Rechtbank, Uitspraak/PlaatsRechtbank, Uitspraak/Hof worden 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. Voor details zie Adressen/Hoofdverblijfplaats (PersoonType-02.02).
		@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

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

1 Algemeen
2 XSD Visueel
- 2.1 Overzicht
3 Detail
- 3.1 Antwoord in detail
- 3.2 Element Persoon
- 3.3 BeStAdd- en OSLO-adressen
- 3.4 Aanpassing van gegevens
4 Codetabellen Antwoord
- 4.1 Resultaat
- 4.2 Status

Binnen deze handleiding

Met vragen kunt u steeds terecht bij de MAGDA Service Desk.

MAGDA Gebruikersomgeving

Beschrijving Antwoord - WijzigKSZPersoon-02.02