Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Werk.GeefLoopbaanonderbrekingen-02.00

Informatie:

Voor de ontsluiting van een MAGDA 2.0 webservice, alsook het generieke proces binnen een 2.0 webservice, wordt verwezen naar Werking en gebruik MAGDA 2.0 Webservices.

Situering

Dit document beschrijft het gebruik en de werking van de webservice GeefLoopbaanonderbrekingen 2.0 zoals deze door Agentschap Digitaal Vlaanderen op het MAGDA platform aangeboden wordt.

Door de zesde staatshervorming zijn verschillende federale bevoegdheden overgedragen aan de regio’s, zo ook de loopbaanonderbrekingen. Dit betekent dat waar vroeger één authentieke bron was, nml. de RVA, heeft men nu drie (vier als je RVA ook meetelt) verschillende bronnen: Vlaanderen, RVA, Brussel en Wallonië.

Deze webservice stelt de gebruikers van het MAGDA platform in staat om met één bevraging de gegevens te bekomen van al de bronnen, dit in één formaat.

Meer informatie over het Vlaams zorgkrediet is terug te vinden op https://www.vlaanderen.be/vlaams-zorgkrediet .

Informatie rond loopbaanonderbreking, tijdskrediet en thematische verloven is beschikbaar op http://www.rva.be/nl/burgers/loopbaanonderbreking-tijdskrediet-en-thematische-verloven.

Verwante diensten

De mutatiegegevens komende via KSZ - het gaat hier bijgevolg over de gegevens vanuit RVA, Wallonië en Brussel - worden beschikbaar gesteld in een bestand “PubliceerMutatieAttestLoopbaanonderbreking 2.0” (Van KSZ). Dit bestand bevat de gemuteerde gegevens alsook aanduiding welk type mutatie.

Het mutatiebestand is enkel beschikbaar in xml-formaat.

Gegevensbronnen

Vlaanderen : De gegevens rond het Vlaams zorgkrediet worden beheerd bij WSE. Hiervoor roept de VDI de GeefLoopbaanonderbrekingen (zorgkrediet) 2.0 op bij WSE. 

RVA, Wallonië, Brussel (via KSZ)

De gegevens beheerd door RVA, Wallonië en Brussel worden bevraagd via de KSZ. Hiervoor roept de VDI de careerBreaks consult webservice op beheerd door KSZ.

Opmerking:

Agentschap Digitaal Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens. 

Overlap inschrijvingscontrole

Naast de standaard actieve inschrijving is deze dienst ook beschikbaar met overlap inschrijvingscontrole. Hierbij wordt een periode uit de vraag vergeleken met de periode die gebruikt is bij de dienst. Er moet minimaal 1 dag overlap zijn tussen beide periodes. Bij een actieve inschrijvingscontrole dient het INSZ actief te zijn in het inschrijvingsrepertorium op het moment van verwerking van de vraag.

Begin- en eindatum van de periode uit de vraag

Volgende elementen worden gebruikt als begin- en einddatum

 

Pad

Opmerking

Begindatum

/Inhoud/Criteria/Periode/Begin

 

Einddatum

/Inhoud/Criteria/Periode/Einde

 

Overlap inschrijvingscontrole

Naast de standaard actieve inschrijving is deze dienst ook beschikbaar met overlap inschrijvingscontrole. Hierbij wordt een periode uit de vraag vergeleken met de periode die gebruikt is bij de dienst. Er moet minimaal 1 dag overlap zijn tussen beide periodes. Bij een actieve inschrijvingscontrole dient het INSZ actief te zijn in het inschrijvingsrepertorium op het moment van verwerking van de vraag.

Begin- en eindatum van de periode uit de vraag

Volgend element wordt gebruikt als begin- en einddatum

 

Pad

Opmerking

Begindatum

/Inhoud/Criteria/Jaar

“01/01/” + Jaar

Einddatum

/Inhoud/Criteria/Jaar

“31/12/” + Jaar

Gebruiksvoorwaarden

Voor de zorgkredietgegevens komende uit Vlaanderen moet de afnemer aan volgende voorwaarden voldoen om deze webservice te mogen gebruiken:

  • Toelating tot het MAGDA platform

  • Machtiging van de Vlaamse Toezichtcommissie

Voor de gegevens beheerd door de RVA en andere regio’s (te bevragen via KSZ) zijn bijkomende machtigingen vereist.

Informatie:

Meer informatie over deze voorwaarden is terug te vinden op de pagina “Machtigingen en toelatingen”.

Meer informatie over het aansluitingsproces is terug te vinden op deze webpagina.

Batch

Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML).

Hiervoor moet men de Service-xsd gebruiken en niet de Webservice. Door de Service-xsd te gebruiken zijn er meerdere vragen mogelijk in één bestand. De vraag-bestanden worden op de MAGDA FTP geplaatst in een afnemer specifieke folder. Deze folder wordt tijdens het aansluitingsproces toegekend.

Prefix voor de batchbestanden: GLBO (GeefLoopbaanonderbrekingen)

Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.

Prefix

Werk.GLBO_02.00

Voorbeeld

Werk.GLBO_02.00_20131103115553530

Functionaliteiten

Een basisopvraging gebeurt aan de hand van het INSZ en een periode (begin- en einddatum) waarna de toegelaten bronnen bevraagd worden.

Voor de afnemer is het ook mogelijk één of meerdere bronnen op te geven waarna enkel de opgegeven bronnen bevraagd worden. Op de opgegeven bronnen vindt natuurlijk een controle plaats of deze toegelaten zijn voor de afnemer.

De afnemer verkrijgt de gegevens uit de verschillende bevraagde bronnen in één formaat. Natuurlijk zijn gepaste foutmeldingen voorzien zoals onder andere “geen gegevens gevonden” en “geen antwoord van bron ontvangen”.

De webservice zal steeds al de gegevens teruggeven die werden ontvangen, ook al trad een fout op bij het aanroepen van één van de bronnen.

Voor meer informatie, zie Werking en gebruik MAGDA 2.0 Webservices.

Werking

Responsetijden & Beschikbaarheid

Magda platform : 

De webservice op het MAGDA platform is 24 uur op 24 en 7 dagen op 7 beschikbaar.

Bij geplande onbeschikbaarheden worden de afnemers op de hoogte gebracht.

WSE :

De beschikbaarheid is afhankelijk van de beschikbaarheid bij de bron. Op dit moment is nog geen informatie gekend rond de beschikbaarheden van WSE.

KSZ (en achterliggende bronnen) :

Op dit moment geen informatie beschikbaar.

Logging

De gegevens in de vraag en het antwoord van deze dienst worden bewaard zoals beschreven op de pagina “MAGDA logging”. Ook de afnemer van persoonsgegevens dient zich verplicht te houden aan de wettelijke loggingsplicht.

Ondersteunde talen

MAGDA ondersteunt de Nederlandse taal.

Indien in de brongegevens de Nederlandse tekst niet beschikbaar is voor een bepaald element zal de eerste vertaling van de tekst in de brongegevens gebruikt worden, onafhankelijk van de taal waarin dit gegeven beschikbaar is.


Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren

De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid

uitgegeven door Digitaal Vlaanderen