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. Deze datum mag niet in de toekomst liggen.
		@Op	Optionele aanduiding hoe de datum in de vraag moet geïnterpreteerd worden Mogelijke waarden: 0: historische gegevens vanaf datum 1: historische gegevens op datum Indien dit attribuut wordt weggelaten wordt een waarde = 0 verondersteld
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

Opmerkingen

Indien de gegevens via KSZ terugkomen bij een vraag op een specifieke datum, zorgt KSZ voor filtering van de gegevens o.b.v. de datum.

Indien de gegevens van RR terugkomen of de gegevens van KSZ komen vanaf een datum, gebeurt de filtering van de gegevens o.b.v. de datum in de Magda dienst.

Voorbeeld