Algemeen

Het antwoord bestaat uit één of meerder Persoon-elementen binnen het Personen-element en/of één of meerdere Uitzonderingen. Het is mogelijk dat, ook al komen er personen terug, het antwoord één of meerdere Uitzonderingen bevat. Afhankelijk van de verkregen machtiging zullen bepaalde gegevens niet in het antwoord opgenomen worden.

Het maximaal aantal personen, wanneer gezocht wordt via het Rijksregister, dat kan terugkomen in het antwoord is 20. Indien de fonetische ondervraging op basis van alle criteria meer dan 20 dossiers selecteert, zal het antwoord een uitzondering bevatten (zonder personen).

Wanneer gezocht wordt via de KSZ kunnen er tot maximaal 50 personen terugkomen. Vindt de KSZ echter meer dan 30 personen in het rijksregister of meer dan 50 in de door KSZ zelf beheerde registers of meer dan 50 in het Rijksregister en de KSZ registers samen, dan zal het antwoord ook een uitzondering bevatten zonder personen.

XSD Visueel

Hierna zijn alle elementen in de XSD van de Persoon gevisualiseerd. De webservice ZoekPersoonOpNaam zal echter enkel de volgende elementen bevatten: INSZ, Beheerder, Register, Naam, Geslacht, Geboorte(datum), BurgerlijkeStaten, Adressen, Nationaliteiten, Overlijden en indien het IT001 een speciale code bevat, dan zal dat in het element Statussen opgenomen zijn.

Detail

In dit overzicht wordt enkel die elementen besproken die in het antwoord terug kunnen komen.

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

Element	Cardinaliteit	Extra
INSZ	Verplicht	Bevat het INSZ van de gevonden persoon.
Naam	Optioneel	De verschillende voor- en achternamen van de persoon. Tot 15 achternamen en 14 voornamen mogelijk.
Geslacht	Optioneel	Het geslacht van de persoon: 1 = mannelijk, 2 = vrouwelijk
Beheerder	Optioneel	De gemeente of diplomatieke post die het dossier van de persoon beheert.
Status	Optioneel	Bevat meldingen als Overlijden.
Geboorte	Optioneel	De geboortedatum van de persoon
Adressen	Optioneel	De verschillende types van adressen van de persoon: - Hoofdverblijfplaats met referentieadres aanduiding - VerblijfplaatsBuitenland - AangifteAdreswijziging - AangifteAdresBuitenland
BurgerlijkeStaten	Optioneel	Burgerlijke staat gegevens van de opgevraagde persoon. Hier enkel mogelijk via KSZ en geen meerdere burgerlijke staten mogelijk.
Register	Optioneel	Het register waarin de persoon is ingeschreven (bevolkingsregister, wachtregister, …)
Nationaliteiten	Optioneel	De nationaliteiten van de persoon. Hier enkel mogelijk via KSZ en geen meerdere nationaliteiten mogelijk.
Overlijden	Optioneel	De datum en plaats van overlijden. Hier enkel mogelijk via KSZ

Voorbeeld

Dit voorbeeld is samengesteld door de antwoorden van twee verschillende vragen samen te voegen.

<Antwoorden>
	<Antwoord>
		<Referte>844-test-02151</Referte>
		<Inhoud>
			<Personen>
				<Persoon>
					<INSZ>67101927748</INSZ>
					<Naam>
						<Achternamen>
							<Achternaam>Theys</Achternaam>
						</Achternamen>
						<Voornamen>
							<Voornaam>Danny</Voornaam>
							<Voornaam>Alois</Voornaam>
							<Voornaam>Cecile</Voornaam>
						</Voornamen>
					</Naam>
					<Geslacht>
						<Code Beschrijving=”Mannelijk”>1</Code>
					</Geslacht>
					<Beheerder>
						<Plaats>
							<Gemeente>
								<NISCode>13049</NISCode>
								<Naam>Westerlo</Naam>
							</Gemeente>
							<Land>
								<NISCode>150</NISCode>
								<ISOCode>BEL</ISOCode>
								<Naam>BELGIE</Naam>
							</Land>
						</Plaats>
					</Beheerder>
					<Geboorte>
						<Datum>1967-10-19</Datum>
					</Geboorte>
					<Adressen>
						<Hoofdverblijfplaats>
							<Straat>
								<Naam>Voorteinde</Naam>
							</Straat>
							<Huisnummer>47</Huisnummer>
							<Gemeente>
								<NISCode>13049</NISCode>
								<PostCode>2260</PostCode>
								<Naam>Westerlo</Naam>
							</Gemeente>
							<Land>
								<NISCode>150</NISCode>
								<ISOCode>BEL</ISOCode>
								<Naam>BELGIE</Naam>
							</Land>
						</Hoofdverblijfplaats>
					</Adressen>
				</Persoon>
				<Persoon>
					<INSZ>57122842912</INSZ>
					<Naam>
						<Achternamen>
							<Achternaam>Theys</Achternaam>
						</Achternamen>
						<Voornamen>
							<Voornaam>Dominique</Voornaam>
							<Voornaam>Robert</Voornaam>
							<Voornaam>Jean</Voornaam>
							<Voornaam>Ghislain</Voornaam>
						</Voornamen>
					</Naam>
					<Geslacht>
						<Code Beschrijving=”Mannelijk”>1</Code>
					</Geslacht>
					<Beheerder>
						<Plaats>
							<Gemeente>
								<NISCode>25091</NISCode>
								<Naam>Rixensart</Naam>
							</Gemeente>
							<Land>
								<NISCode>150</NISCode>
								<ISOCode>BEL</ISOCode>
								<Naam>BELGIE</Naam>
							</Land>
						</Plaats>
					</Beheerder>
					<Geboorte>
						<Datum>1967-10-28</Datum>
					</Geboorte>
					<Adressen>
						<Hoofdverblijfplaats>
							<Straat>
								<Naam>Rue de l’Institut</Naam>
							</Straat>
							<Huisnummer>6</Huisnummer>
							<Busnummer>A000</Busnummer>
							<Gemeente>
								<NISCode>25091</NISCode>
								<PostCode>1330</PostCode>
								<Naam>Rixensart</Naam>
							</Gemeente>
							<Land>
								<NISCode>150</NISCode>
								<ISOCode>BEL</ISOCode>
								<Naam>BELGIE</Naam>
							</Land>
						</Hoofdverblijfplaats>
					</Adressen>
				</Persoon>
			</Personen>
		</Inhoud>
	</Antwoord>
</Antwoorden>

Opmerkingen

Gegevens via KSZ of Rijksregister

Zoals in de tabel hierboven onder ‘2.2 Functionaliteiten’ aangegeven, kan er een verschil zijn tussen eenzelfde persoon die via het Rijksregister of via de KSZ wordt opgevraagd. Bepaalde elementen die als ‘-’in de kolom Rijksregister informatietype staan aangemerkt zullen dan immers ontbreken indien als bron ‘RR’ wordt genomen.

Voornamen

Zoals in het overzicht hierboven vermeld kunnen er maximaal tot 14 voornamen terugkomen. Hier is een belangrijk verschil aan te merken hoe het Rijksregister en de KSZ SSDN-dienst met deze namen omgaan en dit heeft een effect op hoe de voornamen van de persoon worden teruggeven:

Dit is een typisch voorbeeld van iemand met drie voornamen uit het Rijksregister:

<Voornamen>
	<Voornaam>Karel </Voornaam>
	<Voornaam>Boudewijn</Voornaam>
	<Voornaam>Albert</Voornaam>
</Voornamen>

Dezelfde persoon opgevraagd via KSZ SSDN-dienst zal echter zo worden weergegeven:

<Voornamen>
	<Voornaam>KAREL BOUDEWIJN</Voornaam>
</Voornamen>

De KSZ SSDN-dienst geeft tot twee voornamen terug in één element wanneer de persoon uit het Rijksregister afkomstig is. De derde voornaam valt dus weg. Dit geldt ook voor de naam van een eventuele partner.

Zou deze persoon echter beheerd worden door de KSZ, bijvoorbeeld omdat het een geradieerde persoon is, dan zal de persoon door de KSZ SSDN-dienst op deze manier teruggegeven worden:

Voor personen die de KSZ zelf beheert wordt de voornaam in één element teruggeven en de tweede en eventueel volgende voornamen worden in een tweede element teruggegeven.

Begin- en einddatum

De verschillende segmenten binnen de Persoon hebben allen een Begin-en Einddatum als attribuut.

Deze twee datums zijn toegevoegd om rekening te houden met eventuele historische opvragingen via de GeefHistoriekPersoon 2.0. De datums worden van de bron overgenomen. Veelal zal de DatumBegin overeenkomen met de datum waarop het feit/gebeurtenis, geboortedatum, plaatsvond… . DatumEinde is de datum waarop het feit/gebeurtenis gesupprimeerd wordt. Bvb wanneer het postadres in het buitenland niet langer van toepassing is.

De datums worden van de bron overgenomen. Bij personen opgevraagd via de KSZ worden door de KSZ bij de elementen geen specifieke begin- of einddatums gegeven maar enkel een datum van de laatste wijziging. Dit wordt door de ZoekPersoonOpNaam 2.0 teruggeven als de DatumBegin.

Zowel DatumBegin als DatumEinde hebben als formaat jjjj-mm-dd en kunnen onvolledig zijn. Met onvolledig wordt bedoeld: jjjj-mm-00 of jjjj-00-00 of 0000-00-00.

Opmerking: DatumEinde komt in deze webserive nooit terug in het antwoord.

Op deze pagina

1 Algemeen
2 XSD Visueel
3 Detail
- 3.1 Antwoord in detail
4 Opmerkingen
- 4.1 Gegevens via KSZ of Rijksregister
- 4.2 Voornamen
- 4.3 Begin- en einddatum

Binnen deze handleiding

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

MAGDA Gebruikersomgeving

Beschrijving Antwoord (ZoekPersoonOpNaam-02.00)