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: 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), 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

<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

1 Algemeen
2 XSD Visueel
3 Detail
4 Opmerkingen
5 Validaties op vraag
6 Voorbeeld

Binnen deze handleiding

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

MAGDA Gebruikersomgeving

Beschrijving Vraag (GeefPersoon-02.02)

Algemeen

XSD Visueel

Detail

Opmerkingen

Validaties op vraag

Voorbeeld

De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid