Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

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

image-20240108-092649.png

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:

  • 0: opvraging niet uitvoeren

  • 1: opvraging uitvoeren

AfstammingDalendeLijn

Opvragen van afstammingsgegevens in dalende lijn

Mogelijke waarden:

  • 0: opvraging niet uitvoeren

  • 1: opvraging uitvoeren

Identiteitsbewijs

Opvragen van identiteitsbewijs

Mogelijke waarden:

  • 0: opvraging niet uitvoeren

  • 1: opvraging uitvoeren

Beroepskaart

Opvragen van beroepskaart

Mogelijke waarden:

  • 0: opvraging niet uitvoeren

  • 1: opvraging uitvoeren

Arbeidskaart

Opvragen van arbeidskaart

Mogelijke waarden:

  • 0: opvraging niet uitvoeren

  • 1: opvraging uitvoeren

WettigVerblijf

Opvragen van informatie i.v.m. wettig verblijf

Mogelijke waarden:

  • 0: opvraging niet uitvoeren

  • 1: opvraging uitvoeren

AdministratieveToestand

Opvragen van de administratieve toestand van de persoon die opgenomen is in het wachtregister.

Mogelijke waarden:

  • 0: opvraging niet uitvoeren

  • 1: opvraging uitvoeren

PlaastInschrijving

Opvragen van de verplichte plaats van inschrijving – O.C.M.W. waarvan de betrokken vreemdeling afhangt.

Mogelijke waarden:

  • 0: opvraging niet uitvoeren

  • 1: opvraging uitvoeren

 

 

WettelijkeVertegenwoordiging

Opvragen van de wettelijke vertegenwoordiging van de persoon.

Mogelijke waarden:

  • 0: opvraging niet uitvoeren

  • 1: opvraging uitvoeren

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). Merk op dat Frans momenteel enkel ondersteund wordt voor de bron KSZ.

Opmerkingen

Bij het gebruik van KSZ als bron moet minstens het element BasisPersoonGegevens 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

Voorbeeld

<Vraag> <Referte>120fdaff-538f-4ca1-afba-b96dbce5cb58</Referte> <Inhoud> <Criteria> <INSZ>01234567894</INSZ> </Criteria> <Bron>RR</Bron> <Taal>nl</Taal> </Inhoud> </Vraag>

Dit data voorbeeld is gepseudonimiseerd, alle overeenkomsten met werkelijke data berusten puur op toeval.

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.

<Vraag> <Referte>120fdaff-538f-4ca1-afba-b96dbce5cb58</Referte> <Inhoud> <Criteria> <INSZ>01234567894</INSZ> <OpvragingenKSZ> <BasisPersoonsgegevens>1</BasisPersoonsgegevens> </OpvragingenKSZ> </Criteria> <Bron>KSZ</Bron> <Taal>nl</Taal> </Inhoud> </Vraag>

Dit data voorbeeld is gepseudonimiseerd, alle overeenkomsten met werkelijke data berusten puur op toeval.

<Vraag> <Referte>120fdaff-538f-4ca1-afba-b96dbce5cb58</Referte> <Inhoud> <Criteria> <INSZ>01234567894</INSZ> <OpvragingenKSZ> <BasisPersoonsgegevens>1</BasisPersoonsgegevens> <AfstammingDalendeLijn>1</AfstammingDalendeLijn> <Identiteitsbewijs>1</Identiteitsbewijs> </OpvragingenKSZ> </Criteria> <Bron>KSZ</Bron> <Taal>nl</Taal> </Inhoud> </Vraag>

Dit data voorbeeld is gepseudonimiseerd, alle overeenkomsten met werkelijke data berusten puur op toeval.

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