Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

SocZek.GeefVervangingsinkomenUitWerkloosheid-02.01

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

De webservice GeefVervangingsinkomenUItWerkloosheid 02.01 laat de gebruiker toe op basis van het INSZ gegevens met betrekking tot het vervangingsinkomen uit werkloosheid van een persoon op te vragen.

Een voorbeeld van toepassing waarvoor de dienst gebruikt wordt is de toepassing maatwerk van het beleidsdomein Werk en Sociale Economie. Binnen dit beleidsdomein streeft men naar maatwerk voor iedere werkzoekende. Daartoe wil men via maatwerk voor mensen met een grote afstand tot de arbeidsmarkt een transparant kader voor individuele ondersteuning creëren met het oog op latere inschakeling in de reguliere economie op maat van hun noden en mogelijkheden. Een belangrijke rol is daarbij weggelegd voor het Vlaams Subsidie Agentschap van WSE, die verantwoordelijk zijn voor de berekening en uitbetaling van zo een individueel ondersteuningspakket. Hiertoe wenst het VSAWSE gebruik te maken van verschillende authentieke gegevensbronnen, waaronder het vervangingsinkomen uit werkloosheid van de RVA. Deze gegevens zijn te verkrijgen via de online-diensten van de KSZ die via MAGDA aangesproken worden.

Verwante diensten

Om deze webservice te kunnen gebruiken moet er eerst een inschrijving in het MAGDA inschrijvingsrepertorium voor personen aangemaakt worden. Deze inschrijvingen kunnen toegevoegd, aangepast en verwijderd worden via de webservices Repertorium.RegistreerInschrijving en Repertorium.RegistreerUitschrijving.

Gegevensbronnen

Meer informatie over hoe deze bronnen gebruikt worden in de opbouw van het antwoord vindt u onder Opvraging.

Opmerking:

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

Gebruiksvoorwaarden

Afnemers moeten aan volgende voorwaarden voldoen om deze dienst te mogen gebruiken:

  • Toelating tot het MAGDA platform

  • Beraadslaging van de kamer sociale zekerheid en gezondheid van het Informatieveiligheidscomité.

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). Voor meer informatie: Webservice In Batch bevragen.

Prefix

SocZek.GeefVervinkomenUitWerkloosheid_02-01

Voorbeeld

SocZek.GeefVervinkomenUitWerkloosheid_02-01_20131103115553530

Functionaliteiten

De webservice GeefVervangingsinkomenUitWerkloosheid-02.01 laat de afnemer van het MAGDA-platform toe om de gegevens over het vervangingsinkomen uit werkloosheid van een persoon op te vragen. Deze gegevens komen van de RVA, welke de authentieke bron is, en worden ter beschikking gesteld aan MAGDA via KSZ.

In de vraag worden drie blokken data ter beschikking gesteld. De aansluitingsovereenkomst bepaalt welke blokken afnemer kan opvragen.

  • Uitbetaalde Sommen: Deze functie maakt het mogelijk om de bedragen die door de werkloosheidssector aan een persoon zijn betaald gedurende een bepaalde periode te vinden.

  • Situatie: Deze operatie maakt het mogelijk om de betalingssituatie van een persoon te doorzoeken op een bepaalde datum of de laatst bekende situatie.

  • Kwartaal Activeringsuitkeringen: Met deze operatie kunt u zoeken naar informatie (hoeveelheid - werkgevers, enz.) over activeringsallocaties die tijdens het gevraagde kwartaal aan een persoon zijn toegewezen.

In de vraag kan aangegeven worden welke gegevensblokken opgevraagd worden. Meer details zijn te vinden op de Vraag pagina.

Daarnaast bevat de brondienst nog acht andere datablokken die mits de nodige ontwikkelingen langs MAGDA-kant beschikbaar kunnen worden gesteld aan de afnemer. Het gaat over de volgende datablokken:

  • Rights: Deze operatie maakt het mogelijk om de situatie van het recht op werkloosheidsuitkering van een persoon te raadplegen.

  • ScheduledPayments: Met deze operatie kunt u zoeken naar informatie over de dagen waarop werkloosheidsuitkeringen werden betaald (werkloosheidsschema).

  • ScaleCodeHistory: Door het raadplegen van de geschiedenis van de baremiekcode kan de afnemer informatie verkrijgen over de baremiekcodes "werkloosheid" en de "andere premies" -codes van een persoon.

  • SanctionHistory: Deze operatie geeft de straffen en waarschuwingen die zijn gegeven aan een persoon tijdens de gevraagde periode.

  • ExemptionHistory: Deze operatie geeft de vrijstellingen die zijn verleend aan een persoon tijdens de gevraagde periode.

  • WorkDisabilityHistory: Deze operatie maakt het mogelijk de perioden te raadplegen waarin een persoon is erkend als zijnde arbeidsongeschikt en zijn mate van onvermogen.

  • NoEarningCapacityAndLawsuitMutuality: Deze raadpleging maakt het mogelijk om de huidige situatie van "onvermogen" en het "vonnis arbeidsongeschiktheid" te raadplegen.

  • YoungAvailabilityDecisionHistory: Deze operatie maakt het mogelijk om de beslissingen te raadplegen die door de RVA en / of de Gewesten zijn genomen in het kader van de controle van de beschikbaarheid op de arbeidsmarkt van de jongere.

Werking

Opvraging

Van zodra de vraag gesteld is, wordt er een XSD-validatie uitgevoerd. Is de ontvangen vraag-XML niet geldig tegenover het schema, dan stopt de verwerking en wordt een foutmelding aangemaakt, anders gaat de verwerking verder. Na de XSD-validatie vinden de nodige authenticatie- en autorisatiecontroles plaats. 
Hierna vindt er een functionele validatie plaats van de vraag. Nadien zal de webservice achterliggend UnemploymentDataV3 operaties van KSZ oproepen.

Ontvangt de webservice antwoorden – hetzij de gevraagde gegevens, hetzij een foutcode – wordt dit gevalideerd en omgezet in een MAGDA XML-formaat. Het antwoord wordt nogmaals gevalideerd waarna het aan de afnemer ter beschikking gesteld wordt.

Responsetijden & Beschikbaarheid

Logging

De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".

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.

Op deze pagina


Binnen deze handleiding


Omgevingsinformatie

Domein

SocZek

Classificatie

Persoonsgegevens


Verwante diensten


 


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