Beschrijving Vraag (GeefPersoon-02.02)
Algemeen
Om deze dienst te bevragen dient de afnemer te beschikken over het INSZ-nummer van de persoon waarvoor gegevens moeten opgevraagd worden.
XSD Visueel
Detail
MAGDA Vraag/Inhoud/ | Opmerkingen | ||
---|---|---|---|
Criteria | |||
INSZ | Hierop zal er een checksum 97 validatie plaatsvinden. Indien het nummer niet voldoet aan deze validatie zal er een uitzondering aangemaakt worden. | ||
OpvragingenKSZ | Enkel van toepassing voor bron "KSZ". Minstens 1 selectie moet gemaakt worden. | ||
BasisPersoonsgegevens | Deze parameter moet steeds op 1 staan daar de mapping van het INSZ onderdeel uitmaakt van dit deel en INSZ een verplicht element is. | ||
Afstamming | Opvragen van afstammingsgegevens in stijgende lijn Mogelijke waarden:
| ||
AfstammingDalendeLijn | Opvragen van afstammingsgegevens in dalende lijn Mogelijke waarden:
| ||
Identiteitsbewijs | Opvragen van identiteitsbewijs Mogelijke waarden:
| ||
Beroepskaart | Opvragen van beroepskaart Mogelijke waarden:
| ||
Arbeidskaart | Opvragen van arbeidskaart Mogelijke waarden:
| ||
WettigVerblijf | Opvragen van informatie i.v.m. wettig verblijf Mogelijke waarden:
| ||
AdministratieveToestand | Opvragen van de administratieve toestand van de persoon die opgenomen is in het wachtregister. Mogelijke waarden:
| ||
PlaastInschrijving | Opvragen van de verplichte plaats van inschrijving – O.C.M.W. waarvan de betrokken vreemdeling afhangt. Mogelijke waarden:
| ||
|
| WettelijkeVertegenwoordiging | Opvragen van de wettelijke vertegenwoordiging van de persoon. Mogelijke waarden:
|
Bron | Enkel “RR” of “KSZ” mogelijk als bron. Indien er een andere bron opgegeven wordt, bekomt men een XSD validatie fout (SOAP Fault). Er moet een Bron opgegeven worden. Geeft men een niet toegelaten bron op, dan bekomt men een uitzondering. | ||
Taal | Toegelaten talen: nl (Nederlands), fr (Frans), de (Duits). Enkel “nl” zal in eerste instantie mogelijk zijn. Indien er een andere taal opgegeven wordt verkrijgt men een uitzondering. |
Opmerkingen
Bij het gebruik van KSZ als bron moet minstens het element BesisPersoonGegevens in de OpvragingenKSZ blok worden aangevlagd. De andere elementen kunnen optioneel opgevraagd worden. Bij extra opvragingen is het niet nodig om telkens alle data op te vragen, maar buiten de BasisPersoonGegevens kunnen de andere gegevens geoptimaliseerd worden.
Validaties op vraag
Element | Omschrijving van de validatie | Mogelijke Foutcodes |
---|---|---|
Criteria/INSZ | Checksum 97 | 20002 |
Bron | Enkel "RR" of "KSZ" zijn toegelaten | 50000 |
Taal | Enkel "nl" is toegelaten | 25001 |
Voorbeeld
Bij het gebruik van KSZ als bron kan eerst de basisgegevens van de persoon opgevraagd worden. In tweede instantie wordt dan voor deze persoon extra data opgevraagd. Zie tweede voorbeeld hieronder. Op deze manier kan de hoeveelheid data die opgevraagd wordt geminimaliseerd worden en beter afgestemd op de gebruikersinterface.
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