Algemeen

De vraag wordt op dezelfde manier opgebouwd als de overige MAGDA diensten.

De vraag bestaat uit volgende criteria:

een verplicht identificatienummer van de sociaal verzekerde
een verplichte consultatieperiode waarbij zowel begin als einddatum moeten worden meegegeven
de gewenste pensioenpijler
de taal waarin eventuele code omschrijvingen getoond moeten worden
een aanduiding van welke gegevens gewenst zijn:
- enkel pensioenrechten
- pensioenrechten en minimum betalingen + aanduiding of de betalingen op de referteperiode dan wel de betalingsperiode betrekking hebben
- pensioenrechten en maximum betalingen + aanduiding of de betalingen op de referteperiode dan wel de betalingsperiode betrekking hebben

XSD Visueel

Detail

Element ../Vraag/						Beschrijving
Referte						Unieke referte die de vraag identificeert, bij voorkeur een UUID. Bij gebruik via de webservice kan dit worden overgenomen uit ../Context/Bericht/Afzender/Referte; voor de batch variant, dient elke individuele vraag in het aangeleverde bestand een unieke referte te bevatten.
Inhoud
	Criteria
		INSZ				Identificatienummer van de sociaal verzekerde.
		Periode				Consultatie periode van de vraag (begin- en einddatum verplicht).
			Begin			Begindatum van de consultatieperiode Formaat: JJJJ-MM-DD
			Einde			Einddatum van de consultatieperiode (einddatum mag in de toekomst) Formaat: JJJJ-MM-DD
		Pijler				De gewenste pensioenpijler gebruikt bij de opzoeking. Mogelijke waarden: 1: eerste pijler (wettelijk pensioen) 2: tweede pijler (aanvullend pensioen) 3: eerste en tweede pijler
		Taal				Taal waarin de afnemer de omschrijvingen in het antwoord wenst te ontvangen. Enkel "nl" wordt ondersteund.
		RechtenInfo				Verplicht element dat toelaat om aan te duiden welke informatie m.b.t. pensioenrechten gewenst zijn in het antwoord.
			_{KEUZE 1}	EnkelRechten		De afnemer wenst enkel pensioen rechten op te vragen die voldoen aan de vraag criteria. Mogelijke waarde: "1"
			_{KEUZE 2}	RechtenMetBetalingen		Extra specificaties voor het opvragen van pensioenrechten met betalingsgegevens.
				_{KEUZE 2.1a}	RechtenMetMinimumBetalingen	De afnemer wenst pensioen rechten met een minimum set aan betalingsgegevens op te vragen die voldoen aan de vraag criteria. Mogelijke waarde: "1"
				_{KEUZE 2.1b}	RechtenMetMaximumBetalingen	De afnemer wenst pensioen rechten met de maximum set aan betalingsgegevens op te vragen die voldoen aan de vraag criteria. Mogelijke waarde: "1"
				_{KEUZE 2.2a}	ZoekOpReferteperiode	De afnemer wenst de betalingsgegevens op te vragen die betrekking hebben tot de referteperiode van de pensioenbetaling. Mogelijke waarde: "1"
				_{KEUZE 2.2b}	ZoekOpBetalingsperiode	De afnemer wenst de betalingsgegevens op te vragen die betrekking hebben tot de betalingsperiode van de pensioenbetaling. Mogelijke waarde: "1"

Validaties op vraag

Element	Omschrijving van de validatie	MAGDA Uitzondering	Type Uitzondering	Oorsprong uitzondering	Diagnose	Annotaties
Criteria/INSZ	INSZ Checksum 97 validatie	20002	FOUT	MAGDA	INSZ in de vraag heeft een ongeldige structuur	niet van toepassing
Criteria/Periode	Criteria/Periode/Begin <= Criteria/Periode/Einde	20003	FOUT	MAGDA	Begindatum van de periode moet kleiner of gelijk zijn aan de einddatum	niet van toepassing

Opmerkingen

Voorbeeld

Vraagcriteria voor het opvragen van enkel de pensioenrechten

<Criteria>
	<INSZ>01010199797</INSZ>
	<Periode>
		<Begin>2018-01-01</Begin>
		<Einde>2018-12-31</Einde>
	</Periode>
	<Pijler>3</Pijler>
	<Taal>nl</Taal>
	<RechtenInfo>
		<EnkelRechten>1</EnkelRechten>
	</RechtenInfo>
</Criteria>

Vraagcriteria voor het opvragen van de pensioenrechten en de minimum set betalingsgegevens m.b.t. de referteperiode

<Criteria>
	<INSZ>01010199797</INSZ>
	<Periode>
		<Begin>2018-01-01</Begin>
		<Einde>2018-12-31</Einde>
	</Periode>
	<Pijler>3</Pijler>
	<Taal>nl</Taal>
	<RechtenInfo>
		<RechtenMetBetalingen>
			<RechtenMetMinimumBetalingen>1</RechtenMetMinimumBetalingen>
			<ZoekOpReferteperiode>1</ZoekOpReferteperiode>
		</RechtenMetBetalingen>
	</RechtenInfo>
</Criteria>

Vraagcriteria voor het opvragen van de pensioenrechten en de maximum set betalingsgegevens m.b.t. de betalingsperiode

<Criteria>
	<INSZ>01010199797</INSZ>
	<Periode>
		<Begin>2018-01-01</Begin>
		<Einde>2018-12-31</Einde>
	</Periode>
	<Pijler>3</Pijler>
	<Taal>nl</Taal>
	<RechtenInfo>
		<RechtenMetBetalingen>
			<RechtenMetMaximumBetalingen>1</RechtenMetMaximumBetalingen>
			<ZoekOpBetalingsperiode>1</ZoekOpBetalingsperiode>
		</RechtenMetBetalingen>
	</RechtenInfo>
</Criteria>

Codetabellen Vraag

Pijler (Criteria/Pijler)

Code
1
2
3

Op deze pagina

1 Algemeen
2 XSD Visueel
3 Detail
4 Validaties op vraag
5 Opmerkingen
6 Voorbeeld
7 Codetabellen Vraag
- 7.1 Pijler (Criteria/Pijler)

Binnen deze handleiding

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

MAGDA Gebruikersomgeving

Beschrijving Vraag (GeefPensioen-02.00)