Versions Compared

Old Version 6

changes.mady.by.user Bart Olaerts

Saved on

compared with

New Version 7

changes.mady.by.user Bart Olaerts

Saved on

Key

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

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 mininum betalingen + aanduiding of de betalingen op de referteperiode dan wel de betalingsperiode betrekking hebben
    • pensioenrechten en maxinum betalingen + aanduiding of de betalingen op de referteperiode dan wel de betalingsperiode betrekking hebben

XSD Visueel

Detail


Element

../Vraag/

KardinaliteitBeschrijving
Referte1

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.

Inhoud1

Criteria1



INSZ1

Identificatienummer van de sociaal verzekerde.

Periode1

Consultatie periode van de vraag (begin- en einddatum verplicht).


Begin1

Begindatum van de consultatieperiode

Formaat: JJJJ-MM-DD

Einde1

Einddatum van de consultatieperiode

Formaat: JJJJ-MM-DD

Pijler1

De gewenste pensioenpijler gebruikt bij de opzoeking.

Mogelijke waarden:

  • 1: eerste pijler (wettelijk pensioen)
  • 2: tweede pijler (aanvullend pensioen)
  • 3: eerste en tweede pijler
Taal1

Taal waarin de afnemer de omschrijvingen in het antwoord wenst te ontvangen.

Enkel "nl" wordt ondersteund.

RechtenInfo1Verplicht element dat toelaat om aan te duiden welke informatie m.b.t. pensioenrechten gewenst zijn in het antwoord.



KEUZE 1

EnkelRechten0..1

De afnemer wenst enkel pensioen rechten op te vragen die voldoen aan de vraag criteria.

Mogelijke waarde:

"1"

KEUZE 2RechtenMetBetalingen0..1Extra specificaties voor het opvragen van pensioenrechten met betalingsgegevens.


KEUZE 2.1aRechtenMetMinimumBetalingen0..1

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.1bRechtenMetMaximumBetalingen0..1

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.2aZoekOpReferteperiode0..1

De afnemer wenst de betalingsgegevens op te vragen die betrekking hebben tot de referteperiode van de pensioenbetaling.

Mogelijke waarde:

"1"

KEUZE 2.2bZoekOpBetalingsperiode0..1

De afnemer wenst de betalingsgegevens op te vragen die betrekking hebben tot de betalingsperiode van de pensioenbetaling.

Mogelijke waarde:

"1"

Validaties op vraag

ElementOmschrijving van de validatie

MAGDA
Uitzondering

Type
Uitzondering		Oorsprong
uitzondering		DiagnoseAnnotaties
Criteria/INSZINSZ Checksum 97 validatie20002FOUTMAGDAINSZ in de vraag heeft een ongeldige structuurniet van toepassing
Criteria/Periode/BeginKleiner dan of gelijk aan systeemdatum20006FOUTMAGDAEen datum in de vraag valt buiten de toegelaten datumrangeniet van toepassing
Criteria/Periode/EindeKleiner dan of gelijk aan systeemdatum20006FOUTMAGDAEen datum in de vraag valt buiten de toegelaten datumrangeniet van toepassing
Criteria/PeriodeCriteria/Periode/Begin <= Criteria/Periode/Einde20003FOUTMAGDABegindatum van de periode moet kleiner of gelijk zijn aan de einddatumniet van toepassing

Opmerkingen

Voorbeeld

Vraagcriteria voor het opvragen van enkel de pensioenrechten


Code Block
languagexml
titleVoorbeeld xml vraag criteria GeefPensioen
<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


Code Block
languagexml
titleVoorbeeld xml vraag criteria GeefPensioen
<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


Code Block
languagexml
titleVoorbeeld xml vraag criteria GeefPensioen
<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

Bron dienstnaamElementVan codeNaar codeConsultPensionRegisterService

Pijler (Criteria/Pijler)

ConsultPensionRegisterService
Code
1FIRST
Criteria/Pijler2SECONDConsultPensionRegisterServiceCriteria/Pijler
3FIRST_AND_SECOND
ConsultPensionRegisterServiceCriteria/RechtenInfo/RechtenMetBetalingen/ZoekOpReferteperiode1REFERENCE_PERIOD
ConsultPensionRegisterServiceCriteria/RechtenInfo/RechtenMetBetalingen/ZoekOpBetalingsperiode1MONTH_OF_PAYMENT


Op deze pagina

Table of Contents
maxLevel2

Binnen deze handleiding

Page Tree
root@parent