Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Beschrijving Vraag - ZoekPersoonOpAdres-02.02

Algemeen

De vraag bestaat uit:

XSD Visueel

Detail

MAGDA

Inhoud/

Omschrijving

Criteria

-



Adres

-





PostCode

Een Belgische postcode van 4 lang, numeriek. Indien een ongekende postcode opgegeven wordt (bv. 9999), verkrijgt men 40012 als uitzondering.
Wordt een ongeldige postcode opgegeven (bv. 3 lang, karakters, …) bekomt men de uitzondering 60003.





StraatCode

Numerieke code van (4 lang) de straat zoals gekend in het Rijksregister.

Opmerking:

Rijksregister aanvaard enkel straatcodes van 4 cijfers, terwijl dit in de Magda vraag niet afgedwongen wordt.





Huisnummer

Het huisnummer. RR aanvaardt enkel numerische huisnummers. Indien het huisnummer niet numeriek is, bekomt men een uitzondering: 60003.
Het huisnummer mag maximaal 4 tekens lang zijn.





Busnummer

Busnummer, mag maximaal 4 lang zijn.
Mogelijkheid tot het opgeven van “XXXX” (RR) of het leeg laten van het veld (KSZ). Zie verder bij Opmerkingen.



EnkelReferentiepersoon

Mogelijke waardes: 0 of 1

  • 0: geeft alle personen van het opgegeven adres in het antwoord

  • 1: enkel de referentiepersonen van het opgegeven adres zullen in het antwoord voorkomen



Volgende

Dient opgegeven te worden indien de melding kwam dat er nog bijkomende resultaten zijn. (Uitzondering 40014). Zie Belangrijke opmerkingen.

Bron

Bron die gebruikt wordt voor de opzoekingen. Vaste waarden:

  • KSZ

  • RR

Mag leeg gelaten worden. In dit geval wordt de volgorde van de routering gebruikt volgens het aansluitingsproces.

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.

Validaties op vraag

Element

Omschrijving van de validatie

Mogelijke Foutcodes

PostCode

Indien een foute postcode wordt opgegeven, bv. 9999

40012

Volgende

Er zijn bijkomende resultaten beschikbaar voor de opgegeven zoekcriteria

40014

Huisnummer

Busnummer

Fout formaat in de vraag naar de bron toe

60003

Taal

De opgegeven taal wordt niet ondersteund door deze dienst

25001

Opmerkingen

Busnummer

Hierbij meer uitleg wat betreft het busnummer - ook wel index(nummer) genoemd - komende uit de onderrichtingen van het Rijksregister. Deze uitleg is opgenomen omdat het zoeken op busnummer niet eenduidig kan gebeuren.

Het busnummer wordt namelijk in het antwoord opgenomen zoals het werd gecodeerd door de gemeente. Om dubbelzinnigheden of betwistingen te voorkomen is het sinds maart/september 2006 niet langer zo dat busnummers met betekenisloze nullen aangevuld worden.

In het streven naar uniformiteit is het aangewezen dat de gemeenten voortaan volgende regels respecteren voor het toekennen van een indexnummer:

  • 1ste positie : eventueel een hoofdletter (zoniet Δ “spatie”) om een nummer te creëren voor een ander gebouw en alzo een hernummering van de volledige straat te vermijden;

  • 2de en 3de positie : aanduiding van de verdieping;

  • 4de positie :  nummer van de wooneenheid op die verdieping; gebruik van de cijfers 1 tot 9, en daarna de letters van het alfabet (kleine letters).

Bovendien moeten bij het invoeren van een indexveld nog twee andere principes gerespecteerd worden, met name:

  • de index volgt onmiddellijk na het huisnummer (het programma van het Rijksregister plaatst automatisch de schuine streep om de twee zones te scheiden).

  • indien nodig kunnen de 4 posities van het indexveld worden opgevuld met spaties (Δ).

 Voorbeelden:

  • Gebouw met huisnummer 52/A: huisnummer 0052 en als index de letter A gevolgd door 3 spaties 0052/AΔΔΔ.

  • Gebouw met huisnummer 52A, 3de verdieping, appartement nr. 2: huisnummer 0052 en als alfabetische index met appartementnummer A032 0052/A032.

  • Gebouw met huisnummer 52, 3de verdieping, appartement nr. 2: invoer van het huisnummer 0052 en Δ032 om het appartement in het gebouw aan te duiden 0052/Δ032.

  • Gebouw 52 bis naast het gebouw met huisnummer 52: invoer van het huisnummer 0052 en de index bisΔ

 Gelet op de gemeentelijke autonomie en rekening houdend met de vroegere instructies is het mogelijk dat de gemeente (in principe bij gemeentelijk reglement) een andere uniforme methode toepast om het indexnummer weer te geven door bijvoorbeeld de appartementen of de busnummers doorlopend te nummeren. Voorbeeld: 52/6 (appartement nr. 6 op 3 de  verdieping) of 52/b6.

Busnummer XXXX (Rijksregister) of leeg (KSZ)

Het is voor de afnemer mogelijk als busnummer XXXX op te geven wanneer gezocht wordt bij het Rijksregister. Wanneer XXXX opgegeven wordt, worden al de personen op het opgegeven adres teruggegeven in het antwoord, zonder rekening te houden met het busnummer. Een blanco (leeg) busnummer heeft bij de KSZ dezelfde functionaliteit. Het antwoord bevat wel het werkelijke busnummer van de persoon.

Een blanco (leeg) busnummer geeft bij het Rijksregister enkel die personen terug waarvoor geen busnummer in het adres aanwezig is.

<Vraag> <Referte>XE:48:936:933</Referte> <Inhoud> <Criteria> <Adres> <PostCode>2650</PostCode> <Straatcode>2150</Straatcode> <Huisnummer>1</Huisnummer> <Busnummer>XXXX</Busnummer> </Adres> <EnkelReferentiepersoon>0</EnkelReferentiepersoon> </Criteria> <Bron>RR</Bron> <Taal>nl</Taal> </Inhoud> </Vraag>

Werking Volgende

Dit geldt enkel wanneer een zoekopdracht wordt gedaan bij het Rijksregister. Bij een zoekopdracht bij de KSZ wordt dit veld genegeerd.

Het antwoord van het Rijksregister bevat maximaal 20 personen. Indien de zoekcriteria toch meer dan 20 personen oplevert zal, in combinatie met de eerste 20 personen, een Uitzondering (40014) terugkomen. Deze Uitzondering bevat de melding dat er nog bijkomende resultaten beschikbaar zijn voor de opgegeven zoekcriteria.

Om de volgende personen op te vragen, moet een nieuwe vraag uitgevoerd worden met dezelfde parameters maar met in <Volgende> een paginanummer. Het huidige paginanummer komt als annotatie terug in de Uitzondering. Het Volgende-element moet het volgende paginanummer bevatten. Het volgende paginanummer is altijd het huidige paginanummer + 1.

Voorbeeld:

  • Huidige paginanummer = 01, volgende = 02

  • Huidige paginanummer = 02, volgende = 03

Bij een initiële zoekopdracht mag een paginanummer (01) ingegeven worden maar het is niet verplicht.

<Vragen> <Vraag> <Referte>XE:48:919:918</Referte> <Inhoud> <Criteria> <Adres> <PostCode>2100</PostCode> <Straatcode>4458</Straatcode> <Huisnummer>60</Huisnummer> </Adres> <EnkelReferentiepersoon>1</EnkelReferentiepersoon> <Volgende>01</Volgende> </Criteria> <Bron>RR</Bron> <Taal>nl</Taal> </Inhoud> </Vraag> </Vragen>
<Uitzonderingen> <Uitzondering> <Identificatie>40014</Identificatie> <Oorsprong>MAGDA</Oorsprong> <Type>WAARSCHUWING</Type> <Tijdstip> <Datum>2012-01-01</Datum> <Tijd>12:12:12.111</Tijd> </Tijdstip> <Diagnose>Er zijn bijkomende resultaten beschikbaar voor de opgegeven zoekcriteria</Diagnose> <Annotaties> <Annotatie> <Naam>Huidige pagina</Naam> <Waarde>01</Waarde> </Annotatie> </Annotaties> </Uitzondering> </Uitzonderingen>

Referentiepersoon

Dit veld is enkel belangrijk indien een opzoeking gedaan wordt bij het Rijksregister. Indien dit veld de waarde 1 heeft, wordt enkel de referentiepersoon, d.i. het gezinshoofd, op het gevraagde adres gezocht. Het is echter niet noodzakelijk dat op het gevraagde adres een referentiepersoon ingeschreven is in het Rijksregister, waardoor in dergelijke gevallen geen personen zullen gevonden worden op het gevraagde adres. Dit is bv. het geval voor personen die als alleenstaand ingeschreven zijn in het Rijksregister.

Het veld is een verplicht veld, dus ook bij een opzoeking bij de KSZ dient hier een waarde te worden ingevuld (0 of 1), al wordt dit dus genegeerd indien de opzoeking bij de KSZ gebeurt.

Voorbeeld

Op deze pagina


Binnen deze handleiding


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

 


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