Algemeen
Om deze dienst te bevragen dient de afnemer te beschikken over het INSZ-nummer van de persoon waarvoor gegevens moeten opgevraagd worden.
Bijkomend dient een datum te worden meegegeven waarop of vanaf wanneer de historische gegevens gewenst zijn; het verschil tussen beide situaties kan worden aangegeven met het extra attribuut "Op" bij deze datum.
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. | ||
| Datum | Datum waarop of vanaf wanneer de gegevens opgevraagd worden | ||
| @Op | Aanduiding hoe de datum in de vraag moet geïnterpreteerd worden Mogelijke waarden:
| ||
| Bron | Enkel “RR” of “KSZ” mogelijk als bron. Indien er een andere bron opgegeven wordt, bekomt men een validatie fout. 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. | ||
Validaties op vraag
Element | Omschrijving van de validatie | MAGDA Uitzondering | Annotatie | |
|---|---|---|---|---|
| Criteria/INSZ | INSZ Checksum 97 validatie | 20002 | INSZ in de vraag heeft een ongeldige structuur | niet van toepassing |
| Criteria/Datum | Kleiner dan of gelijk aan systeemdatum | 20006 | Een datum in de vraag valt buiten de toegelaten datumrange | niet van toepassing |
| Bron | enkel "RR" of "KSZ toegelaten | 50000 | Ongeldige gegevens in de vraag | Naam: "Bron" Waarde: waarde in element Bron |
| Taal | enkel "nl" toegelaten | 25001 | De opgegeven taal wordt niet ondersteund door deze dienst | niet van toepassing |
| Element | Omschrijving van de validatie | Mogelijke Foutcodes |
|---|---|---|
Opmerkingen
Indien de gegevens via KSZ terugkomen, zorgt KSZ voor filtering van de gegevens o.b.v. de datum.
Indien de gegevens van RR terugkomen, gebeurt de filtering van de gegevens o.b.v. de datum in de Magda dienst.
Voorbeeld
Bevraging via KSZ voor persoonsgegevens vanaf een bepaalde datum
<Vraag> <Referte>123456</Referte> <Inhoud> <Criteria> <INSZ>01010199797</INSZ> <Datum Op="0">1957-08-13</Datum> </Criteria> <Bron>KSZ</Bron> <Taal>nl</Taal> </Inhoud> </Vraag>
Bevraging via KSZ voor persoonsgegevens op een bepaalde datum
<Vraag> <Referte>123456</Referte> <Inhoud> <Criteria> <INSZ>01010199797</INSZ> <Datum Op="1">1957-08-13</Datum> </Criteria> <Bron>KSZ</Bron> <Taal>nl</Taal> </Inhoud> </Vraag>
Bevraging RR voor historische persoonsgegevens vanaf een bepaalde datum
<Vraag> <Referte>123456</Referte> <Inhoud> <Criteria> <INSZ>01010199797</INSZ> <Datum Op="0">1957-08-13</Datum> </Criteria> <Bron>RR</Bron> <Taal>nl</Taal> </Inhoud> </Vraag>
Bevraging RR voor historische persoonsgegevens op een bepaalde datum
<Vraag> <Referte>123456</Referte> <Inhoud> <Criteria> <INSZ>01010199797</INSZ> <Datum Op="1">1957-08-13</Datum> </Criteria> <Bron>RR</Bron> <Taal>nl</Taal> </Inhoud> </Vraag>
Op deze pagina
Binnen deze handleiding
