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

Image Modified

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

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

Bevraging via KSZ voor persoonsgegevens vanaf een bepaalde datum

linenumbers
Code Blockexpand
languagexml
titleVoorbeeld
Code Block
<!-- Dit data voorbeeld is gepseudonimiseerd, alle overeenkomsten met werkelijke data berusten puur op toeval -->
language
true
xml
<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>

Dit data voorbeeld is gepseudonimiseerd, alle overeenkomsten met werkelijke data berusten puur op toeval.

Bevraging via KSZ voor persoonsgegevens vanaf een bepaalde datum zonder Op attribuut

linenumbers
Code Blockexpand
languagexml
titleVoorbeeld
Code Block
<!-- Dit data voorbeeld is gepseudonimiseerd, alle overeenkomsten met werkelijke data berusten puur op toeval -->
language
true
xml
<Vraag>
	<Referte>123456</Referte>
	<Inhoud>
		<Criteria>
			<INSZ>01010199797</INSZ>
			<Datum>1957-08-13</Datum>
		</Criteria>
		<Bron>KSZ</Bron>
		<Taal>nl</Taal>
	</Inhoud>
</Vraag>

Dit data voorbeeld is gepseudonimiseerd, alle overeenkomsten met werkelijke data berusten puur op toeval.

Bevraging via KSZ voor persoonsgegevens op een bepaalde datum

xmllinenumbers
Code Block
language
Expand
titleVoorbeeld
Code Block
<!-- Dit data voorbeeld is gepseudonimiseerd, alle overeenkomsten met werkelijke data berusten puur op toeval -->
language
true
xml
<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>

Dit data voorbeeld is gepseudonimiseerd, alle overeenkomsten met werkelijke data berusten puur op toeval.

Bevraging RR voor historische persoonsgegevens vanaf een bepaalde datum

language
Code Block
Expand
linenumbers
xmltitleVoorbeeld
<!-- Dit data voorbeeld is gepseudonimiseerd, alle overeenkomsten met werkelijke data berusten puur op toeval -->
Code Block
language
true
xml
<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>

Dit data voorbeeld is gepseudonimiseerd, alle overeenkomsten met werkelijke data berusten puur op toeval.

Bevraging RR voor historische persoonsgegevens op een bepaalde datum

language
Code Block
Expand
linenumbers
xmltitleVoorbeeld
<!-- Dit data voorbeeld is gepseudonimiseerd, alle overeenkomsten met werkelijke data berusten puur op toeval -->
Code Block
language
true
xml
<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>

Dit data voorbeeld is gepseudonimiseerd, alle overeenkomsten met werkelijke data berusten puur op toeval.

Op deze pagina

Table of Contents
maxLevel2
minLevel1

Binnen deze handleiding

Page Treeroot@parent

Child pages (Children Display)
pagePersoon.GeefHistoriekPersoon-02.02

Info

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