Versions Compared

Old Version 8

changes.mady.by.user Bert Van Kets

Saved on

compared with

New Version Current

changes.mady.by.user Bert Van Kets

Saved on

Key

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

Algemeen

De afnemer stelt een vraag op met hierin al zeker volgende verplichte elementen:

  • INSZ: het INSZ van de persoon van wie de gegevens gewenst zijn

  • Periode: een begin- en einddatum waarbinnen de loopbaanonderbreking gegevens gevraagd worden.

De werking kan in grote lijnen opgedeeld worden in twee delen:

  • Of een bron (of bronnen) wordt opgegeven in de vraag

  • Of er wordt geen bron opgegeven in de vraag

Daarbij worden ook nog verschillende functionele / autorisatie validaties uitgevoerd op de vraag zelf.

Bron opgegeven in vraag

Wordt een bron opgegeven in de vraag – de afnemer kan tot vier verschillende bronnen opgegeven – worden enkel die bronnen opgeroepen, natuurlijk indien deze toegelaten zijn voor de afnemer.

Geeft de afnemer een niet toegelaten bron op, dan verkrijgt die een gepaste foutmelding.

Mag de afnemer de opgegeven bron oproepen, dan wordt zijn vraag doorgestuurd naar de opgegeven bron.

Geen bron opgegeven in vraag

Werd door de afnemer geen bron opgegeven in de vraag, dan worden al de voor hem toegelaten bronnen opgeroepen.

Periode opgegeven in vraag

Voor de periode opgegeven in de vraag, worden door zowel KSZ als WSE alle loopbaanonderbrekingen die minstens één dag in het gevraagde interval hebben liggen teruggegeven. Bij het bevragen van de KSZ mag de periode niet groter zijn dan 5 jaar.

Image RemovedImage Added

Als de rode lijn het zoekinterval representeert, en de blauwe lijnen de beschikbare voorkomens van loopbaanonderbrekingen, dan worden de volgende loopbaanonderbrekingen teruggegeven: B, C, D, F, G en H.

Functionele / autorisatie validaties

Op de vraag gebeuren enkele functionele validaties:

  • Indien het INSZ niet voldoet aan de checksum97-controle: 20002

  • Indien de begindatum niet kleiner is of gelijk aan de einddatum: 20003

De hier beschreven autorisatie validaties hebben enkel betrekking op bron-elementen / bron autorisaties:

Validatie

Foutcode

Heeft een afnemer in de vraag een bron opgegeven waarvoor geen toelating is, dan wordt de verwerking gestopt, ook al bevindt er zich in de vraag een andere bron waarvoor wel toelating is.

Indien er meerdere niet-toegelaten bronnen in de vraag opgenomen waren, wordt er toch maar één uitzondering aangemaakt.

40006

Is voor de afnemer geen bron geconfigureerd in de routeringtabel wordt fout 60011 op niveau 2 aangemaakt. De verwerking wordt stopgezet.

60011

Wordt eenzelfde bron meer dan één keer opgegeven in vraag, dan stopt de verwerking en wordt uitzondering 30032 gegeven op niveau 3.

30032

Oproepen achterliggende bronnen

In onderstaande tabel bevinden zich de vier mogelijke bronnen die aangeroepen kunnen worden.

Bron

Via

Achterliggende dienst

RVA

KSZ

CareerBreaks consult

Vlaanderen

WSE

GeefLoopbaanonderbrekingen 02.00

Brussel

KSZ

CareerBreaks consult

Wallonie

KSZ

CareerBreaks consult

De bronnen RVA, Brussel en Wallonië zijn niet rechtstreeks door MAGDA ontsloten maar worden via KSZ oproepen.

De MAGDA webservice zal elke achterliggende bron apart oproepen waarna de antwoorden gebundeld worden.

Bundeling antwoorden

Algemeen

Een belangrijke functie van de webservice is het bundelen van de antwoorden uit de verschillende opgeroepen bronnen. Op deze manier verkrijgt men de gegevens uit Vlaanderen, RVA, Wallonië en/of Brussel in eenzelfde formaat. Op basis van het element Bron kan men dan afleiden wie de beheerder is van de gegevens.

Bij het aanroepen van meerdere bronnen is het natuurlijk mogelijk dat een bron geen gegevens heeft, een timeout geeft, een technische fout optreedt, … .

In dat geval zal de webservice steeds de toch ontvangen loopbaanonderbreking gegevens teruggeven met, per bron waarbij de anomalie opgetreden is, een duidelijke uitzondering.

Voorbeelden

Expand
titleLoopbaanonderbrekinggegevens vanuit KSZ (RVA) & WSE
Code Block
languagexml
<Inhoud>
	<Loopbaanonderbrekingen>
		<Loopbaanonderbreking>
			<Bron>Vlaanderen</Bron>
			<Dossiernummer>000001</Dossiernummer>
			<INSZ>00000000001</INSZ>
			…
			<BedragMaandelijksUitkering>99999999999999999</BedragMaandelijksUitkering>
		</Loopbaanonderbreking>
		<Loopbaanonderbreking>
			<Bron>RVA</Bron>
			<INSZ>00000000001</INSZ>
			…
			<BedragMaandelijksUitkering>99999999999999999</BedragMaandelijksUitkering>
		</Loopbaanonderbreking>
	</Loopbaanonderbrekingen>
</Inhoud>

Resultaat: Er wordt één Inhoud-element aangemaakt met een Loopbaanonderbrekingen-element. Elk Loopbaanonderbreking vanuit de bronnen wordt hierin opgenomen.

Expand
titleLoopbaangegevens vanuit WSE, functionele uitzondering vanuit KSZ (bron RVA)
Code Block
languagexml
<Antwoord>
	<Inhoud>
		<Loopbaanonderbrekingen>
			<Loopbaanonderbreking>
				<Bron>Vlaanderen</Bron>				
				<Dossiernummer>000001</Dossiernummer>
				<INSZ>00000000001</INSZ>
				<Periode>
					<Begin>2001-01-05</Begin>
					<Einde>20001-05-01</Einde>
				</Periode>
			...
				<BedragMaandelijksUitkering>99999999</BedragMaandelijksUitkering>
			</Loopbaanonderbreking>
		</Loopbaanonderbrekingen>
	</Inhoud>
	<Uitzonderingen>
		<Uitzondering>
			<Identificatie>30001</Identificatie>
			<Oorsprong>MAGDA</Oorsprong>
			<Type>FOUT</Type>
			<Tijdstip>
				<Datum>0000-00-00</Datum>
				<Tijd>00:00</Tijd>
			</Tijdstip>
			<Diagnose>Geen gegevens gevonden</Diagnose>
			<Omstandigheid>Foutcode van KSZ</Omstandigheid>
<Annotaties>
				<Annotatie>
					<Naam>Bron</Naam>
					<Waarde>RVA</Waarde>
				</Annotatie>
			</Annotaties>
		</Uitzondering>
	</Uitzonderingen>
</Antwoord>

Resultaat: Er wordt één Inhoud-element aangemaakt met een Loopbaanonderbrekingen-element. Elk Loopbaanonderbreking vanuit de bronnen wordt hierin opgenomen.

Expand
title4 bronnen, geen gegevens gevonden
Code Block
languagexml
<Antwoord>
	<Uitzonderingen>
		<Uitzondering>
			<Identificatie>30001</Identificatie>
			<Oorsprong>WSE</Oorsprong>
			<Type>FOUT</Type>
			<Tijdstip>
				<Datum>0000-00-00</Datum>
				<Tijd>00:00</Tijd>
			</Tijdstip>
			<Diagnose>Geen gegevens gevonden</Diagnose>
<Annotaties>
				<Annotatie>
					<Naam>Bron</Naam>
					<Waarde>Vlaanderen</Waarde>
				</Annotatie>
			</Annotaties>
		</Uitzondering>
		<Uitzondering>
			<Identificatie>30001</Identificatie>
			<Oorsprong>MAGDA</Oorsprong>
			<Type>FOUT</Type>
			<Tijdstip>
				<Datum>0000-00-00</Datum>
				<Tijd>00:00</Tijd>
			</Tijdstip>
			<Diagnose>Geen gegevens gevonden</Diagnose>
<Annotaties>
				<Annotatie>
					<Naam>Bron</Naam>
					<Waarde>RVA</Waarde>
				</Annotatie>
			</Annotaties>
		</Uitzondering>
		<Uitzondering>
			<Identificatie>30001</Identificatie>
			<Oorsprong>MAGDA</Oorsprong>
			<Type>FOUT</Type>
			<Tijdstip>
				<Datum>0000-00-00</Datum>
				<Tijd>00:00</Tijd>
			</Tijdstip>
			<Diagnose>Geen gegevens gevonden</Diagnose>
<Annotaties>
				<Annotatie>
					<Naam>Bron</Naam>
					<Waarde>Wallonie</Waarde>
				</Annotatie>
			</Annotaties>
		</Uitzondering>
<Uitzondering>
			<Identificatie>30001</Identificatie>
			<Oorsprong>MAGDA</Oorsprong>
			<Type>FOUT</Type>
			<Tijdstip>
				<Datum>000-00-00</Datum>
				<Tijd>00:00</Tijd>
			</Tijdstip>
			<Diagnose>Geen gegevens gevonden</Diagnose>
<Annotaties>
				<Annotatie>
					<Naam>Bron</Naam>
					<Waarde>Brussel</Waarde>
				</Annotatie>
			</Annotaties>
		</Uitzondering>
	</Uitzonderingen>
</Antwoord>

Resultaat: een Antwoord-element wordt aangemaakt zonder Inhoud-element, er worden 4 Uitzondering-elementen aangemaakt.

Bundeling antwoorden

Algemeen

Een belangrijke functie van de webservice is het bundelen van de antwoorden uit de verschillende opgeroepen bronnen. Op deze manier verkrijgt men de gegevens uit Vlaanderen, RVA, Wallonië en/of Brussel in eenzelfde formaat. Op basis van het element Bron kan men dan afleiden wie de beheerder is van de gegevens.

Bij het aanroepen van meerdere bronnen is het natuurlijk mogelijk dat een bron geen gegevens heeft, een timeout geeft, een technische fout optreedt, … .

In dat geval zal de webservice steeds de toch ontvangen loopbaanonderbreking gegevens teruggeven met, per bron waarbij de anomalie opgetreden is, een duidelijke uitzondering.

Voorbeelden

Expand
titleLoopbaanonderbrekinggegevens vanuit KSZ (RVA) & WSE
Code Block
languagexml
<Inhoud>
	<Loopbaanonderbrekingen>
		<Loopbaanonderbreking>
			<Bron>Vlaanderen</Bron>
			<Dossiernummer>000001</Dossiernummer>
			<INSZ>00000000001</INSZ>
			…
			<BedragMaandelijksUitkering>99999999999999999</BedragMaandelijksUitkering>
		</Loopbaanonderbreking>
		<Loopbaanonderbreking>
			<Bron>RVA</Bron>
			<INSZ>00000000001</INSZ>
			…
			<BedragMaandelijksUitkering>99999999999999999</BedragMaandelijksUitkering>
		</Loopbaanonderbreking>
	</Loopbaanonderbrekingen>
</Inhoud>

Resultaat: Er wordt één Inhoud-element aangemaakt met een Loopbaanonderbrekingen-element. Elk Loopbaanonderbreking vanuit de bronnen wordt hierin opgenomen.

Expand
titleLoopbaangegevens vanuit WSE, functionele uitzondering vanuit KSZ (bron RVA)
Code Block
languagexml
<Antwoord>
	<Inhoud>
		<Loopbaanonderbrekingen>
			<Loopbaanonderbreking>
				<Bron>Vlaanderen</Bron>				
				<Dossiernummer>000001</Dossiernummer>
				<INSZ>00000000001</INSZ>
				<Periode>
					<Begin>2001-01-05</Begin>
					<Einde>20001-05-01</Einde>
				</Periode>
			...
				<BedragMaandelijksUitkering>99999999</BedragMaandelijksUitkering>
			</Loopbaanonderbreking>
		</Loopbaanonderbrekingen>
	</Inhoud>
	<Uitzonderingen>
		<Uitzondering>
			<Identificatie>30001</Identificatie>
			<Oorsprong>MAGDA</Oorsprong>
			<Type>FOUT</Type>
			<Tijdstip>
				<Datum>0000-00-00</Datum>
				<Tijd>00:00</Tijd>
			</Tijdstip>
			<Diagnose>Geen gegevens gevonden</Diagnose>
			<Omstandigheid>Foutcode van KSZ</Omstandigheid>
<Annotaties>
				<Annotatie>
					<Naam>Bron</Naam>
					<Waarde>RVA</Waarde>
				</Annotatie>
			</Annotaties>
		</Uitzondering>
	</Uitzonderingen>
</Antwoord>

Resultaat: Er wordt één Inhoud-element aangemaakt met een Loopbaanonderbrekingen-element. Elk Loopbaanonderbreking vanuit de bronnen wordt hierin opgenomen.

Expand
title4 bronnen, geen gegevens gevonden
Code Block
languagexml
<Antwoord>
	<Uitzonderingen>
		<Uitzondering>
			<Identificatie>30001</Identificatie>
			<Oorsprong>WSE</Oorsprong>
			<Type>FOUT</Type>
			<Tijdstip>
				<Datum>0000-00-00</Datum>
				<Tijd>00:00</Tijd>
			</Tijdstip>
			<Diagnose>Geen gegevens gevonden</Diagnose>
<Annotaties>
				<Annotatie>
					<Naam>Bron</Naam>
					<Waarde>Vlaanderen</Waarde>
				</Annotatie>
			</Annotaties>
		</Uitzondering>
		<Uitzondering>
			<Identificatie>30001</Identificatie>
			<Oorsprong>MAGDA</Oorsprong>
			<Type>FOUT</Type>
			<Tijdstip>
				<Datum>0000-00-00</Datum>
				<Tijd>00:00</Tijd>
			</Tijdstip>
			<Diagnose>Geen gegevens gevonden</Diagnose>
<Annotaties>
				<Annotatie>
					<Naam>Bron</Naam>
					<Waarde>RVA</Waarde>
				</Annotatie>
			</Annotaties>
		</Uitzondering>
		<Uitzondering>
			<Identificatie>30001</Identificatie>
			<Oorsprong>MAGDA</Oorsprong>
			<Type>FOUT</Type>
			<Tijdstip>
				<Datum>0000-00-00</Datum>
				<Tijd>00:00</Tijd>
			</Tijdstip>
			<Diagnose>Geen gegevens gevonden</Diagnose>
<Annotaties>
				<Annotatie>
					<Naam>Bron</Naam>
					<Waarde>Wallonie</Waarde>
				</Annotatie>
			</Annotaties>
		</Uitzondering>
<Uitzondering>
			<Identificatie>30001</Identificatie>
			<Oorsprong>MAGDA</Oorsprong>
			<Type>FOUT</Type>
			<Tijdstip>
				<Datum>000-00-00</Datum>
				<Tijd>00:00</Tijd>
			</Tijdstip>
			<Diagnose>Geen gegevens gevonden</Diagnose>
<Annotaties>
				<Annotatie>
					<Naam>Bron</Naam>
					<Waarde>Brussel</Waarde>
				</Annotatie>
			</Annotaties>
		</Uitzondering>
	</Uitzonderingen>
</Antwoord>

Resultaat: een Antwoord-element wordt aangemaakt zonder Inhoud-element, er worden 4 Uitzondering-elementen aangemaakt.

Geannuleerd INSZ & INSZ wijzigingen

Geannuleerd INSZ

Heeft de afnemer de request uitgevoerd met een geannuleerd INSZ, en als achterliggende bronnen werden Wallonië, RVA of Brussel aangeroepen, dan zal het antwoord een uitzondering 30002 bevatten. Vanuit bron Vlaanderen kan deze melding niet terugkomen.

INSZ Wijzigingen

Heeft de afnemer de request uitgevoerd met een oud INSZ, en als achterliggende bronnen werden Wallonië, RVA of Brussel aangeroepen, dan kan het zijn dat de melding terugkomt dat het INSZ gewijzigd is. Vanuit deze bronnen bekomt men dan geen gegevens maar een foutmelding (30002) samen met de annotaties “Oud INSZ” en “Nieuw INSZ”.

Vanuit bron Vlaanderen kan deze melding niet terugkomen. Bijgevolg is het mogelijk dat er toch gegevens uit Vlaanderen terugkomen maar vanuit de KSZ-bronnen de melding komt dat het INSZ gewijzigd is.

XSD validaties

MAGDA garandeert dat het uitwisselcontract (xsd) niet geschonden worden door bij elk ontvangen en uitgaand bericht een xsd validatie uit te voeren.

Foutcodes

In onderstaande tabel een overzicht van de functionele (business) foutcodes.

Foutcode

Beschrijving

10501

Fout formaat in de vraag (XSD validatie)

12001

Niet bestaande dienst

20001

Ongeldig datumformaat in vraag

20002

INSZ in de vraag heeft een ongeldige structuur

20003

Begindatum van de periode moet kleiner of gelijk zijn aan de einddatum

30001

Geen gegevens gevonden voor de vraag

30002

INSZ geannuleerd

30003

Onbestaand persoonsnummer

30004

Persoon heeft een nieuw Persoonsnummer verkregen.

30032

Eenzelfde bron werd meer dan één keer opgegeven

40001

Er werd geen geldige wettelijke context opgegeven

40003

Geen inschrijving aanwezig voor het INSZ in de vraag

40006

Fout in autorisatie

40041

Niet alle gegevens konden opgehaald worden

60003

Fout formaat in de vraag naar de bron toe

60006

Geen antwoord van bron ontvangen

60007

Kan antwoord bron niet interpreteren

60008

Fout bij validatie antwoord(XSD validatie)

60009

Er heeft zich een technisch probleem voorgedaan

60010

Dienst is tijdelijk niet beschikbaar

60011

Toegangsparamaters voor bron niet opgezet in autorisatiedatabase

99983

Magda code niet aanwezig voor terug gekomen broncode, contacteer VIP

99984

Magda beschrijving voor code niet aanwezig, contacteer VIP

99986

Ongekende foutcode van de bron, contacteer VIP

Opgelet, tijdens de levensloop van de dienst kunnen foutcodes bijkomen en/of aangepast worden.

Op deze pagina

Table of Contents
maxLevel2
minLevel1

Binnen deze handleiding

Child pages (Children Display)
pageWerk.GeefLoopbaanonderbrekingen-02.00
Info

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