Algemeen

De vraag bestaat uit het INSZ-nummer van de persoon waarvan de gegevens gevraagd worden. Naast dit nummer is er ook een periode voor de opzoeking vereist. Voor deze periode is het verplicht een begindatum in te vullen, deze mag niet voor 1 juli 1956 liggen.

Een einddatum is niet verplicht, bij het niet invullen van dit element wordt de datum van de opzoeking gebruikt.

XSD Visueel

Detail

Element	Opmerkingen
Referte	De Referte bevat een unieke code die de Vraag identificeert. Deze code wordt overgenomen in het Referte element van het Antwoord, zodat Vraag en Antwoord éénduidig aan elkaar gelinkt kunnen worden. Omdat deze referte uniek moet zijn wordt aanbevolen om als een referte een UUID te gebruiken. Zie hiervoor ook de Acceptatiecriteria MAGDA – controles en aandachtspunten pagina.
Taal	Taal waarin de omschrijvingen van codes in het antwoord wordt gevraagd. Deze moet één van de ondersteunde talen zijn. Momenteel wordt enkel taalcode ‘nl’ ondersteund.
INSZ	Het INSZ van de persoon voor wie loopbaan/banen worden opgevraagd. Op dit element wordt een checksum 97-validatie op toegepast.
Periode	De Periode waarvoor de opzoeking moet gebeuren. Alle loopbanen worden teruggegeven waarvan de periode minstens 1 dag overlapt met de opgevraagde periode. Indien periode niet meegegeven dan wordt de volledige periode vanaf 1/7/1956 gebruikt.
Periode.Begin	De begindatum van de Periode. Deze mag niet voor 1 juli 1956 liggen. (zie verder Validaties op de vraag)
Periode.Einde	De einddatum van de periode, niet verplicht. Indien niet ingevuld, kunnen loopbanen met periode in de toekomst teruggegeven worden.

Validaties op vraag

Element	Omschrijving van de validatie	Mogelijke Foutcodes
Criteria/INSZ	Checksum 97 validatie	20002
Criteria/Periode	Begindatum (Begin) moet kleiner zijn of gelijk aan de einddatum (Eind)	20003
Criteria/Periode/Begin	De begindatum mag niet voor 01/07/1956 liggen	30022
Taal	Taal moet een ondersteunde taal zijn (momenteel enkel ‘nl’)	25001

Voorbeeld

<n1:GeefLoopbaanARZA>
	<Verzoek>
		<Context>
			<Naam>GeefLoopbaanARZA</Naam>
			<Versie>02.01.0000</Versie>
			<Bericht>
				<Type>VRAAG</Type>
				<Tijdstip>
					<Datum>2018-12-15</Datum>
					<Tijd>09:23</Tijd>
				</Tijdstip>
				<Afzender>
					<Identificatie>Afzender-A</Identificatie>
					<Referte>8d08fba0-844a-11e4-b4a9-0800200c9a66</Referte>
				</Afzender>
			</Bericht>
		</Context>
		<Vragen>
			<Vraag>
				<Referte>1254-7896-541</Referte>
				<Inhoud>
					<Criteria>
						<INSZ>XXXXXXXXXXX</INSZ>
						<Periode>
							<Begin>2010-10-10</Begin>
							<Einde>2015-10-10</Einde>
						</Periode>
					</Criteria>
				</Inhoud>
			</Vraag>
		</Vragen>
	</Verzoek>
</n1:GeefLoopbaanARZA>

Codetabellen Vraag

Er komen in de Vraag geen codes voor.

Op deze pagina

1 Algemeen
2 XSD Visueel
3 Detail
4 Validaties op vraag
5 Voorbeeld
6 Codetabellen Vraag

Binnen deze handleiding

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

MAGDA Gebruikersomgeving

Beschrijving Vraag (GeefLoopbaanARZA-02.01)