Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

INSZHierop zal er een checksum 97 validatie plaatsvinden. Indien het nummer niet voldoet aan deze validatie zal er een uitzondering aangemaakt worden.
DatumDatum waarop of vanaf wanneer de gegevens opgevraagd worden

@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.

TaalToegelaten 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/INSZINSZ Checksum 97 validatie20002INSZ in de vraag heeft een ongeldige structuurniet van toepassing
Criteria/DatumKleiner dan of gelijk aan systeemdatum20006Een datum in de vraag valt buiten de toegelaten datumrangeniet van toepassing
Bronenkel "RR" of "KSZ toegelaten50000Ongeldige gegevens in de vraag

Naam: "Bron"

Waarde: waarde in element Bron

Taalenkel "nl" toegelaten25001De opgegeven taal wordt niet ondersteund door deze dienstniet 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

Bevraging via KSZ voor persoonsgegevens vanaf een bepaalde datum

Code Block
languagexml
titleVoorbeeld
linenumberstrue
<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 vanaf een bepaalde datum zonder Op attribuut

Code Block
languagexml
titleVoorbeeld
linenumberstrue
<Vraag>
	<Referte>123456</Referte>
	<Inhoud>
		<Criteria>
			<INSZ>01010199797</INSZ>
			<Datum>1957-08-13</Datum>
		</Criteria>
		<Bron>KSZ</Bron>
		<Taal>nl</Taal>
	</Inhoud>
</Vraag>

Bevraging via KSZ voor persoonsgegevens op een bepaalde datum

Code Block
languagexml
titleVoorbeeld
linenumberstrue
<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

Code Block
languagexml
titleVoorbeeld
linenumberstrue
<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

Code Block
languagexml
titleVoorbeeld
linenumberstrue
<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

Table of Contents
maxLevel2

Binnen deze handleiding

Page Tree
root@parent