Algemeen

De vraag bestaat uit:

de zoekparameters
- de achternaam
- tot drie voornamen indien het Rijksregister de bron is. Indien KSZ de bron is zie verder onder Opmerkingen.
- de geboortedatum waarbij het mogelijk is te werken met een tolerantie
- geslacht
- gemeente NIS-code van woonplaats (de beheerder van het dossier)
bron waar de gegevens opgehaald moeten worden
de taal waarin de gegevens terug moeten komen

XSD Visueel

Detail

MAGDA Inhoud/				Omschrijving
Criteria
	Naam
		Achternaam		Achternaam van de persoon. Maximaal 128 lang.
		Voornamen
			Voornaam	Mogelijkheid tot het ingeven van drie voornamen van elk maximaal 48 lang. Indien langer opgegeven wordt, zal er een Uitzondering terugkomen. Naar Rijksregister toe zullen enkel de eerste twee voornamen doorgegeven worden. De derde wordt volledig genegeerd. Zie onder de Belangrijke Opmerkingen hieronder hoe de KSZ omgaat met hetgeen ingegeven wordt.
	Geboorte
		Datum		De geboortedatum is optioneel bij zoekopdrachten die het Rijksregister als bron specificeren. Wordt er echter gekozen voor de KSZ, dan is dit een verplicht veld (anders foutmelding 40020). Geboortedatum van de op te zoeken persoon. Kan zijn onder de vorm: jjjj-mm-dd, jjjj-mm-00 en jjjj-00-00. Er vindt bij het Rijksregister geen validatie plaats of de datum al dan niet in de toekomst ligt. Bij een opzoeking via de KSZ zal er echter wel een check plaatsvinden: de geboortedatum dient voor de huidige dag te liggen. Ook indien er gewerkt wordt met een tolerantie dient er een mogelijke geboortedatum te zijn die voor de zoekdatum ligt.
		Tolerantie		Voor de werking van tolerantie, zie verder in dit document.
	Geslacht			1 = mannelijk; 2 = vrouwelijk
	Adres
		GemeenteNISCode		Door de NIS-code te gebruiken beperkt men de opzoeking in de dossiers die beheerd worden door deze gemeente. Wordt er een niet bestaande NIS-code opgegeven, bekomt men een Uitzondering.
		LandNISCode		NIS-code van het land waar de persoon woont. "150", de NIS-code van België, wordt gebruikt indien niet ingevuld.
Bron				Bron die gebruikt wordt voor de opzoekingen. Vaste waarden: KSZ RR Het element Bron is in tegenstelling tot later ontwikkelde 2.02 persoonsdiensten technisch niet verplicht, maar het wordt ten stelligste aanbevolen van dit toch expliciet mee te geven in het request. Indien geen bron wordt meegegeven in het request zal enkel de eerste bron volgens de configuratie opzet aangeroepen worden. Gewoonlijk zal dit de achterliggende KSZ dienst zijn om te vermijden dat er kosten worden aangerekend voor een request. Een niet toegelaten bron of een niet geconfigureerde bron in het request geeft aanleiding tot een uitzondering, resp. uitzondering 99982 of 60018.
Taal				Moet "nl" bevatten. MAGDA ondersteunt op dit moment enkel de Nederlandse taal. Indien iets anders opgegeven is, wordt uitzondering 25001, "De opgegeven taal wordt niet ondersteund door deze dienst", teruggegeven.

Opmerkingen

Voornamen voor KSZ

De KSZ gaat op een specifieke manier om met de voornamen en zoekt op een andere manier afhankelijk van het register dat geraadpleegd wordt:

bij het rijksregister wordt enkel de eerste en tweede voornaam in fonemen gebruikt.
bij het KSZ-register worden alle meegegeven voornamen (maximaal drie) in fonemen gebruikt.

Voor beide registers geldt dat de tweede voornaam genegeerd wordt en dat personen voor wie geen voornaam bekend is ook worden teruggegeven.

Naamsveranderingen bij zoeken via KSZ

Bij het gebruik van het zoeken via KSZ kan het gebeuren dat ZoekPersoonOpNaam ongewone resultaten geeft.
De dienst bij de KSZ zoekt immers ook in de historiek van personen. Zo kan het gebeuren dat iemand die vroeger een naam had die fonetisch overeenstemde met de zoekopdracht, maar ondertussen van naam is veranderd, toch wordt gegeven.

Achternaam en voornaam

De namen of voornamen mogen gans of gedeeltelijk in hoofdletters of in kleine letters ingebracht worden. De klinkers en de spaties mogen weggelaten worden.

Voor zover ze de uitspraak van de medeklinkers niet wijzigen, mogen de speciale tekens weggelaten of vervangen worden. Zo mag "François" ingevoerd worden onder de vorm "Fransois" (om de ç te ontwijken).

De samengestelde voornamen mogen ingevoerd worden als afzonderlijke voornamen.

Werking tolerantie

Indien de geboortedatum niet volledig is (dus jjjj-mm-00 of jjjj-00-00) kan men gebruik maken van de tolerantie. Bij het gebruik van een volledige geboortedatum mag geen tolerantie worden opgegeven.

Indien gezocht wordt via de KSZ is bij zulke onvolledige opgaves van de geboortedatum de tolerantie een verplicht in te vullen veld.

Onderstaande tabel biedt een overzicht van de werking van de tolerantie. Voor de verduidelijking: EE = eeuw; JJ = jaar; MM = maand; DD = dag.

Opgelet : indien bij het gebruik van KSZ als bron de tolerantie te groot wordt genomen zal dit resulteren in een aantal resultaten groter dan 50. Er worden dan geen resultaten terug gegeven met een uitzondering 30005 ()Te veel gegevens gevonden, verfijn de zoekcriteria)

KSZ als bron

Geboortedatum	Tolerantie	Toegelaten	Antwoord
Volledig (EEJJMMDD)	Geen of 00	Ja	Geeft alle personen geboren op de ingevoerde datum.
	01 tot en met 99	Neen	FOUT (40009)
Onvolledig (EEJJMM00) MM > 0	Geen, 00 tot en met 99 Personen uit RR : 00 tot en met 06	Ja	Indien geen tolerantie wordt opgegeven, zal tolerantie 00 worden verondersteld. Geeft al de personen geboren tussen EEJJMM + tolerantie en EEJJMM - tolerantie. Bij gebruik van 00 gebeurt de opzoeking op de aangegeven maand. Er wordt geen rekening gehouden met dag.
Onvolledig (EEJJ0000) MM & DD = 00	Geen, 00 tot en met 99	Ja	Indien geen tolerantie wordt opgegeven, zal tolerantie 00 worden verondersteld. Geeft al de personen geboren tussen EEJJ + tolerantie en EEJJ - tolerantie.
Onvolledig (EEJJ00DD) JJ > 0	Geen, 00 tot en met 99	Neen	FOUT (40008).

RR als bron

Geboortedatum	Tolerantie	Toegelaten	Antwoord
Volledig (EEJJMMDD)	Geen	Ja	Geeft alle personen geboren op de ingevoerde datum.
	00 tot 99	Neen	FOUT (40009) indien gezocht wordt met een tolerantie
Onvolledig (EEJJMM00) MM > 0	Geen	Neen	FOUT (40009)
	00	Ja	Geeft de personen geboren op het jaar en maand van ingave. Er wordt geen rekening gehouden met dag.
	01 tot en met 12	Ja	Geeft al de personen geboren tussen EEJJMM + tolerantie en EEJJMM - tolerantie. Er wordt geen rekening gehouden met dag.
	13 tot en met 99	Neen	FOUT (40017)
Onvolledig (EEJJ0000) MM & DD = 00	Geen	Ja	Enkel de personen met 00 in de maand van het INSZ worden opgezocht Meer informatie over de opmaak en het INSZ kan gevonden worden op de pagina Identificatienummer (Persoon-02.02).
	00	Ja	Geeft als antwoord al de personen geboren in het jaar EEJJ. Er wordt geen rekening gehouden met de maand en dag.
	01 tot 99 (aantal jaren omhoog of omlaag)	Ja	Antwoord is gelijk aan al de personen geboren in EEJJ + tolerantie en EEJJ – tolerantie.
Onvolledig (EEJJ00DD) JJ > 0	Geen of 00 tot 99	Neen	FOUT (40008).

Validaties op vraag

Element	Omschrijving van de validatie	Mogelijke Foutcodes
Naam/Voornamen/Voornaam	Gegevens van de bron ingekort wegens te lang	30030
Naam/Achternaam	Gegevens van de bron ingekort wegens te lang	30030
Geslacht	Fout in opgegeven zoekcriteria: geslacht	45617
Geboorte/Tolerantie	Fout in opgegeven zoekcriteria: tolerantie	40009
Geboorte/Tolerantie	Fout in opgegeven zoekcriteria: Tolerantie > 12 met een geboortedatum van het type JJJJ-MM-00	40017
Geboorte/Tolerantie	Fout in opgegeven zoekcriteria: geboortedatum	40008
Geboorte/Datum	Geboortedatum is verplicht bij raadplegen KSZ	40020
Geboorte/Datum	Geboorte: De ingangsdatum ligt in de toekomst	48023
Taal	De opgegeven taal wordt niet ondersteund door deze dienst	25001

Op deze pagina

Binnen deze handleiding

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

Beschrijving Vraag - ZoekPersoonOpNaam-02.02