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. Bij gebruik van "RR" als bron worden deze waarden genegeerd. | ||
| BasisPersoonsgegevens | Opvraging van de basisgegevens van de persoon Mogelijke waarden:
| ||
| 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:
| ||
| Bron | Enkel “RR” of “KSZ” mogelijk als bron. Indien er een andere bron opgegeven wordt, bekomt men een XSD validatie fout (SOAP Fault). 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.
Een niet toegelaten bron of een niet geconfigureerde bron in het request geeft aanleiding tot een uitzondering, resp. uitzondering 99982 of 60018. | ||
| 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. | ||
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.Opmerkingen
Bij het gebruik van KSZ als bron moet er minsten 1 element in de OpvragingenKSZ blok worden aangevlagd. Dit betekent dat ook de basisgegevens van een persoon optioneel geworden zijn. De reden hiervoor is dat gebruikers eerst de basisgegevens van een persoon opvragen en pas daarna de details (vb. Gezinssamenstelling) opvragen. Bij die extra opvraging is het niet nodig om opnieuw de basisgegevens van de persoon door te geven, die zijn reeds opgevraagd. Daarom is het nu mogelijk om verdere details op te vragen zonder de basisgegevens.
Indien "RR" als bron wordt gebruikt worden de parameters onder OpvragingenKSZ genegeerd.
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>00000000100</INSZ>
</Criteria>
<Bron>RR</Bron>
<Taal>nl</Taal>
</Inhoud>
</Vraag>
<Vraag>
<Referte>120fdaff-538f-4ca1-afba-b96dbce5cb58</Referte>
<Inhoud>
<Criteria>
<INSZ>00000000100</INSZ>
<ExtraOpvragingen>
<AfstammingDalendeLijn>1</AfstammingDalendeLijn>
<Identiteitsbewijs>1</Identiteitsbewijs>
</ExtraOpvragingen>
</Criteria>
<Bron>KSZ</Bron>
<Taal>nl</Taal>
</Inhoud>
</Vraag>
Op deze pagina
Binnen deze handleiding
