DIGITAAL VLAANDEREN
Beschrijving Vraag - ZoekPersoonOpNaam-02.02
- Bert Van Kets
- Pedro Devogelaere (Deactivated)
- Bart Olaerts (Unlicensed)
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 | 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. | |||
Geboorte | ||||
Datum | 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. | |||
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:
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 |
Related content
Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren
De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid
uitgegeven door Digitaal Vlaanderen