Raadpleging van het vervangingsinkomen uit werkloosheid

Transcriptie

1 Raadpleging van het vervangingsinkomen uit werkloosheid UnemploymentDataService Raadpleging bij de RVA van de gegevens betreffende het vervangingsinkomen uit werkloosheid Auteur: Vincent Turine Laatste wijziging: 17 september 2013 UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 1 / 34

2 Historiek Datum Versie Opmerking Verspreiding 16/07/ Eerste versie van het document Website UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 2 / 34

3 Inhoudsopgave 1. Situering van het project Inleiding Machtiging van het Sectoraal Comité van de sociale zekerheid 4 2. Architectuur van de gegevensstroom Formaat Gegevensgedeelte 5 Raadpleging van de bedragen die tijdens een bepaalde periode werden uitbetaald 5 Raadpleging van de laatst gekende periode of van de situatie op een bepaalde datum 11 Raadpleging van de bedragen die werden uitbetaald in het kader van de activeringsuitkeringen Consultatiestroom Gegevensstroom 25 De consultatiestroom gebeurt volledig online 25 De raadplegingsstroom verloopt in batch Integratiecontrole 26 Specifieke gevallen Verwerking Scenario s 27 Verwerping van de vraag door de KSZ 27 Aanvaarding van de vraag door de RVA 27 Verwerping van de vraag door de RVA 28 Gegevens die resulteren uit de verwerking 28 Technische fout Prefix 30 Voorleggingsprefix 30 Antwoordprefix Bijlagen Lijst codes aard werkloosheid (RVA) Lijst returncodes (RVA) 34 Technische codes in SOAP Fault 34 Codes in de blok status 34 UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 3 / 34

4 1. Situering van het project 1.1. Inleiding Verschillende instellingen hebben laten weten dat ze behoefte hebben aan informatie met betrekking tot het vervangsinkomen werkloosheid. Daarom werd een gegevensstroom ontwikkeld. Dankzij deze stroom kunnen gegevens van de RVA ter beschikking worden gesteld van het netwerk van de sociale zekerheid. Het gaat om de stroom A 1 L035 L. Sommige partners waaronder de OCMW's hebben vervolgens laten weten dat ze behoefte hebben aan de raadpleging van deze stroom via een webservice. Deze webservice wordt in dit document beschreven. Deze webservice gebruikt dus de stroom L035 L in de back-end. Maar alle functies van de stroom L035 werden niet als dusdanig overgenomen. De linken met en de verschillen tussen deze dienst en de L035 L worden aangeduid bij de beschrijving van elke functie van deze dienst. Indien sommige partners laten weten dat ze behoefte hebben aan andere functies via deze webservice, kunnen nieuwe bewerkingen die aan deze behoeften voldoen, worden toegevoegd. Voor zover de instellingen daartoe werden gemachtigd door het Sectoraal Comité van de Sociale Zekerheid en van de Gezondheid kunnen zij deze gegevens krijgen via deze dienst of de stroom L035 L. De raadpleging van deze gegevens zal via de KSZ verlopen Machtiging van het Sectoraal Comité van de sociale zekerheid Vermits het gaat om een uitwisseling van sociale persoonsgegevens vanuit instellingen die behoren tot het netwerk de sociale zekerheid, moet een machtiging worden aangevraagd bij het Sectoraal Comité van de Sociale Zekerheid en van de Gezondheid voor de toegang tot deze gegevens. TODO ajouter délibérations. Beraadslagingen voor deze nieuwe gegevensstroom vermelden. UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 4 / 34

5 2. Architectuur van de gegevensstroom 2.1. Formaat Deze stroom volgt het principe van de webservices. De gegevens worden dus uitgewisseld in XML, ofwel online (https 2 ways), ofwel in batch (BatchSOAP) Gegevensgedeelte In dit punt worden de gegevens van deze dienst nader toegelicht. De technische gegevens die gewoonlijk aanwezig zijn in een webservice (legalcontext, informationcustomer, ) worden niet hier maar wel in het gedeelte "Prefix" beschreven. Een gedetailleerde beschrijving ervan staat in het document CBSS service definition_nl.doc». Drie bewerkingen zijn op dit ogenblik mogelijk: 1) de raadpleging van de bedragen die tijdens een bepaalde periode werden uitbetaald; 2) de raadpleging van de laatst gekende periode of van de situatie op een bepaalde datum; 3) de raadpleging van de bedragen die werden uitbetaald in het kader van de activeringsuitkeringen. In elk antwoord worden de gegevens uit het verzoek en het element status opgenomen. Dit element status geeft een aanwijzing over de status van het antwoord. Het wordt beschreven in het gedeelte "Scenario". Raadpleging van de bedragen die tijdens een bepaalde periode werden uitbetaald Deze raadpleging heeft betrekking op alle uitkeringen, ongeacht het type werkloosheid. In zijn antwoord zal de RVA, per maand waarvoor hij over gegevens beschikt, de volgende gegevens meedelen: - de maand waarop de betaling betrekking heeft; - het bedrag dat de uitbetalingsinstelling heeft uitbetaald (= ingediend bij RVA) - het bedrag dat de RVA heeft goedgekeurd; - een aanduiding van de vordering van het dossier bij de RVA. Bij de opvraging van de uitbetaalde bedragen zal het antwoord het bedrag bevatten dat is uitbetaald door de uitbetalingsinstelling en eventueel het bedrag dat goedgekeurd is door RVA. De uitbetalingen door de uitbetalingsinstellingen worden gecontroleerd door RVA. De KSZ zal de gegevens die door de RVA werden overgemaakt, filteren en via de webservice enkel de maanden meedelen waarin het uitbetaalde bedrag > 0. Indien de verificatieprocedure nog niet werd opgestart, kan er nog geen bedrag worden meegedeeld dat door de RVA werd goedgekeurd. Indien de verificatieprocedure loopt, zal een goedgekeurd bedrag worden meegedeeld dat al dan niet definitief is. De verificatieprocedure start 2 maanden na de uitbetaling door de uitbetalingsinstelling en kan tot 13 maanden in beslag nemen. Gedurende deze periode kunnen de uitbetalingsinstellingen het bedrag dat door de RVA is goedgekeurd, betwisten. Na UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 5 / 34

6 deze verificatieperiode stemt in 99% van de gevallen het uitbetaalde bedrag overeen met het goedgekeurde bedrag. De gevraagde gegevens kunnen dus enkel betrekking hebben op gegevens uit het verleden. De informatie betreffende een betaling is immers pas beschikbaar vanaf de 20 ste van de maand volgend op de uitbetaling. Een uitkering in de maand december 2012 zal bijvoorbeeld pas vanaf 20 januari 2013 opvraagbaar zijn. Voor een derde van de werkloosheidsuitkeringen gebeuren de betalingen met 1 maand vertraging. De uitkering voor de maand november 2012 wordt pas in december 2012 uitbetaald en zal dus pas opvraagbaar zijn vanaf 20 januari Indien de raadplegingsperiode dus loopt van 06/2012 tot 02/2013 en de huidige datum is 15/02/2013, dan zullen de gegevens met betrekking tot de maanden 06, 07, 08, 09, 10 en 11/2012 beschikbaar zijn. De gegevens van de maand 12/2012 zullen misschien beschikbaar zijn. Indien dit niet het geval is, zullen ze beschikbaar zijn vanaf 20/02/2013. De gegevens van de maand 01/2013 zullen niet beschikbaar zijn. Ze zullen beschikbaar zijn vanaf 20/02/2013 of 20/03/2013. En de gegevens van de maand 02/2013 zullen zeker niet beschikbaar zijn omdat de maand nog niet uit is! Verschillen ten opzichte van de stroom L035 Het aantal meegedeelde maanden is op dit ogenblik beperkt tot drie, terwijl er 48 maanden kunnen worden meegedeeld in de stroom L035. Deze beperking houdt een controle van de verzoeken door de KSZ in. In de stroom L035 worden de maanden meegedeeld waarvoor de uitbetaalde bedragen gelijk zijn aan 0 terwijl de KSZ deze maanden uitfiltert in de webservice. In de stroom L035 is de keuze mogelijk tussen het opvragen: van alle uitkeringen ongeacht het type werkloosheid; van enkel de uitkeringen volledige werkloosheid en de uitkeringen inkomensgarantie. UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 6 / 34

7 Verzoek Zone Beschrijving M/C 1 XML INSZ sociaal verzekerde INSZ van de werkloze M searchcriteria\ssin Beginmaand raadplegingsperiode Beginmaand van de periode waarvoor de gegevens worden opgevraagd C searchcriteria\period\startmonth Controle: De beginmaand kan tot maximaal 4 jaar in het verleden liggen. Formaat: YYYY-MM Eindmaand raadplegingsperiode Eindmaand van de periode waarvoor de gegevens worden opgevraagd C searchcriteria\period\endmonth Controle: Eindmaand kan maximaal 3 maanden na de beginmaand van de periode liggen Formaat: YYYY-MM 1 Mandatory / conditional UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 7 / 34

8 Figuur 1 - XSD van het verzoek UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 8 / 34

9 Antwoord Zone Beschrijving M/C 2 XML Het antwoord bevat de gegevens per maand en heeft een maximale frequentie van 3 (maximum 3 maanden per antwoord). Maand waarop de betaling betrekking heeft Maand waarop de betaling betrekking heeft Formaat: YYYY-MM M payedsums\payedsum\month Brutobedrag dat door de uitbetalingsinstelling is uitbetaald en bij de RVA is ingediend Brutobedrag dat door de uitbetalingsinstelling is uitbetaald en bij de RVA is ingediend Uitgedrukt in eurocent. Beperking: 0 < bedrag < eurocent M payedsums\payedsum\payedamount Aanduiding van de vordering van het dossier bij de RVA Aanduiding van de vordering van het dossier bij de RVA M payedsums\payedsum\approvalstatus Mogelijke waarden: COMPLETED = definitief, de verificatieprocedure is voltooid en het goedgekeurde bedrag wordt meegedeeld PROVISIONAL = de procedure loopt nog, maar het voorlopig goedgekeurde bedrag zal worden meegedeeld NOT_STARTED = de procedure moet nog worden opgestart, het goedgekeurde bedrag wordt niet ingevuld Bedrag dat de RVA heeft goedgekeurd Bedrag dat de RVA heeft goedgekeurd. Uitgedrukt in eurocent. C payedsums\payedsum\approvedamount Aanwezig indien vordering dossier = 2 Mandatory / conditional UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 9 / 34

10 COMPLETED of PROVISIONAL Beperking: 0 < bedrag < eurocent Figuur 2 - XSD van het verzoek UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 10 / 34

11 Raadpleging van de laatst gekende periode of van de situatie op een bepaalde datum Bij de raadpleging op een bepaalde datum wordt de uitbetaling en het recht indien ze bestaan op de betrokken datum opgevraagd. Bij de raadpleging van de laatst gekende situatie wordt de laatst gekende betaling opgehaald en het recht op de laatste dag van de maand waarin de betaling is gekend. In het antwoord deelt de KSZ de volgende gegevens mee: - de gegevens voor de uitbetaling: - de uitbetaalde maand (maand van de opgevraagde dag of maand van de laatst gekende uitbetaling); - het aantal uitkeringen (indien gekend); en - de gegevens voor het theoretisch recht indien het bestaat: - het theoretisch dagbedrag voor de opgevraagde dag of voor de laatste dag van de maand waarin de uitbetaling is gekend; - de begindatum van het recht; - de aard van de werkloosheid voor de gevraagde dag of voor de laatste dag van de maand waarin de betaling is gekend; - de gezinssituatie voor de gevraagde dag of voor de laatste dag van de maand waarin de betaling is gekend; - het uitkeringsstelsel bij vrijwillig deeltijdse arbeid. - in geval van theoretisch recht en indien er geen recht bestaat, worden de volgende gegevens meegedeeld: - ofwel de begindatum van de sanctie en indien gekend de einddatum van de sanctie of het aantal weken van de sanctie; - ofwel de begindatum van de uitsluiting. In een volledige maand wordt het dagbedrag 26 keer uitbetaald. Indien niet wordt aangeduid dat het 26 uitkeringen betreft, is het de taak van de aanvragende instelling om na te gaan in welke situatie de sociaal verzekerde zich tijdens de ontbrekende dagen bevond. De persoon kan immers opnieuw werkloos zijn geworden tijdens de maand of daarentegen beginnen werken zijn; de persoon is misschien ziek geworden of de persoon is misschien een deeltijdse werknemer met behoud van rechten. Een sociaal verzekerde kan recht hebben op werkloosheidsuitkeringen maar het is mogelijk dat hij nog geen uitkeringen heeft ontvangen. Dus bij de opvraging van de situatie op een bepaalde datum is het mogelijk dat enkel de gegevens betreffende het recht worden meegedeeld aangezien zowel het recht als de uitbetaling worden opgevraagd. En bij de raadpleging van de laatst gekende situatie wordt een businessfout teruggestuurd aangezien er geen "laatste" uitbetaling is gekend. In het antwoord met betrekking tot het recht wordt de gezinssituatie vermeld zoals ze gebruikt wordt bij de RVA. De RVA kent 3 gezinssituaties : alleenstaand, samenwonend of UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 11 / 34

12 werknemer met gezinslast. Iemand die alleen woont maar bijvoorbeeld alimentatiegeld betaalt, wordt door RVA als werknemer met gezinslast beschouwd. Indien de persoon geen recht op werkloosheidsuitkeringen meer heeft omwille van een sanctie of een uitsluiting, wordt de begindatum en, in geval van sanctie, ook de einddatum of het aantal weken van de sanctie meegedeeld. Indien aan de persoon nooit een recht op werkloosheidsuitkeringen is toegekend, wordt de persoon niet opgenomen in het verwijzingsrepertorium van de KSZ en wordt een businessfout (zie het gedeelte Scenario) teruggestuurd in het antwoord. Verschillen ten opzichte van de stroom L035 In de stroom L035 is het mogelijk om het recht en/of de uitbetaling op een bepaalde datum op te vragen. Bij een webservice gaat het steeds om het recht en de uitbetaling. In de stroom L035 is het mogelijk om het laatst gekende recht en/of de laatst gekende uitbetaling op te vragen. Bij een webservice gaat het steeds om de laatst gekende uitbetaling en het recht voor de laatste dag van de maand waarin een uitbetaling is gekend. In de stroom L035 is het mogelijk om verschillende rechten te hebben. In de stroom L035 is het mogelijk om bij een sanctie zowel de einddatum van de sanctie als de duur van de sanctie op te vragen. In een webservice is dit niet het geval. Ofwel wordt de einddatum meegedeeld indien die is gekend, ofwel de duur van de sanctie indien die is gekend. In de stroom L035 is een keuze mogelijk tussen het opvragen: van alle uitkeringen ongeacht het type werkloosheid; van enkel de uitkeringen volledige werkloosheid en de uitkeringen inkomensgarantie. UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 12 / 34

13 Verzoek Zone Beschrijving M/C 3 XML INSZ sociaal verzekerde INSZ van de werkloze M searchcriteria\ssin Optie laatste situatie Verplicht indien opvraging van de laatst gekende periode: C searchcriteria\lastknownpayment Loutere aanduiding van de raadpleging van de laatste situatie. Datum situatie Verplicht indien opvraging van de situatie op een bepaalde datum: C searchcriteria\date Datum waarvoor de gegevens worden opgevraagd Controle: De begindatum kan tot maximaal 4 jaar in het verleden liggen. Formaat: YYYY-MM-DD 3 Mandatory / conditional UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 13 / 34

14 Figuur 3 - XSD van het verzoek Antwoord Zone Beschrijving M/C 4 XML Gegevensblok met betrekking tot de uitbetaling Maand van betaling Indien opvraging van de laatst gekende situatie: M situation\payment\month 4 Mandatory / conditional UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 14 / 34

15 Maand waarin de laatste betaling heeft plaatsgevonden Indien opvraging van de situatie op een bepaalde datum: Maand van de datum die in het verzoek wordt opgevraagd Formaat: YYYY-MM Aantal uitkeringen Aantal uitkeringen die tijdens die maand werden uitbetaald. Halve uitkeringen worden eveneens meegedeeld. C situation\payment\numberofbenefits In uitzonderlijke gevallen kan het zijn dat de RVA (nog) niet over het aantal uitbetaalde uitkeringen beschikt. Formaat: 20 = 2 uitkeringen 225 = 22,5 uitkeringen Gegevensblok met betrekking tot de situatie waarvoor er een theoretisch recht gekend is Theoretisch dagbedrag Theoretisch dagbedrag voor die maand. M situation\right\activeright\theoreticdailyamount Indien opvraging van de laatst gekende situatie: Theoretisch bedrag op de dag van de laatst gekende uitbetaling. Indien opvraging van de situatie op een bepaalde datum : Theoretisch bedrag van de opgevraagde dag. Uitgedrukt in eurocent. UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 15 / 34

16 Beperking: 0 < bedrag < eurocent Begindatum van het recht Begindatum van het recht M situation\right\activeright\startdate Formaat: YYYY-MM-DD Aard werkloosheid Aanduiding van de aard werkloosheid waarvoor het recht werd toegekend M situation\right\activeright\unemploymentcategory Indien opvraging van de laatst gekende situatie: Aard van de werkloosheid op de dag van de laatst gekende uitbetaling. Indien opvraging van de situatie op een bepaalde datum: Aard van de werkloosheid op de opgevraagde dag. Mogelijke waarden: Lijst codes aard werkloosheid (RVA) Gezinssituatie Aanduiding van de gezinssituatie wanneer het recht wordt toegekend M situation\right\activeright\familysituation Mogelijke waarden EMPLOYEE_WITH_DEPENDANTS = gezinshoofd (werknemer met gezinslast) SOLITARY = alleenstaand COHABITING = samenwonend Stelsel van de uitkeringen Aanduiding van het aantal halve uitkeringen uitbetaald aan een werkloze of een bruggepensioneerde die was tewerkgesteld als vrijwillig deeltijdse werknemer. Halve uitkeringen zijn eveneens mogelijk. Voor een periode van een week kunnen er dus 6 uitkeringen of 12 halve uitkeringen zijn. C situation\right\activeright\benefitregime UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 16 / 34

17 Het stelsel is nodig voor het berekenen van het maandbedrag van de werkloosheidsuitkering. Aanwezig indien werkloze of bruggepensioneerde toegelaten is op basis van prestaties als vrijwillig deeltijdse werknemer. De waarde ligt dus tussen 0,5 en 6. Gegevensblok met betrekking tot de situatie waarvoor GEEN recht gekend is MAAR WEL een sanctie Begindatum sanctie Aanwezig indien er geen recht is wegens sanctie: Begindatum van de sanctieperiode. M situation\right\sanction\startdate Formaat: YYYY-MM-DD Einddatum sanctie Aanwezig indien er geen recht is wegens sanctie: C situation\right\sanction\enddate Einddatum van de sanctieperiode Wordt enkel ingevuld indien de datum is gekend. Mag niet worden ingevuld indien het aantal weken sanctie werd meegedeeld Formaat: YYYY-MM-DD Aantal weken sanctie Aanwezig indien er geen recht is wegens sanctie C situation\right\sanction\nrweeks Aantal weken vermeld in de sanctieperiode Mag niet worden ingevuld indien de einddatum wordt vermeld Gegevensblok met betrekking tot de situatie waarvoor GEEN recht is gekend maar wel een UITSLUTING UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 17 / 34

18 Begindatum uitsluiting Aanwezig indien er geen recht is wegens uitsluiting: Begindatum van de uitsluiting situation\right\exclusion\startdate Formaat: YYYY-MM-DD Figuur 4 - XSD van het antwoord UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 18 / 34

19 Figuur 5 - Detail van de blok situation UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 19 / 34

20 Raadpleging van de bedragen die werden uitbetaald in het kader van de activeringsuitkeringen Bij de raadpleging van de bedragen die werden uitbetaald in het kader van de activeringsuitkeringen wordt, ongeacht het type activering, het betrokken kalenderkwartaal meegedeeld in de aanvraag. In het antwoord deelt de KSZ de volgende gegevens mee: - voor elke maand van het opgevraagde kwartaal (indien het bedrag > is dan 0): o de maand waarop de betaling betrekking heeft; o het bedrag van de activeringsuitkering. - op kwartaalbasis: o de werkgever(s) waarbij de werknemer in dienst is. Opmerking: - Indien er een uitbetaling heeft plaatsgevonden voor het gevraagde kwartaal deelt de RVA in zijn antwoord voor elke maand van het kwartaal een bedrag mee, ook al is dit bedrag gelijk aan 'nul'. De KSZ zal deze maanden niet overmaken. - Indien er geen uitbetaling heeft plaatsgevonden voor het opgevraagde kwartaal, deelt de RVA een foutcode mee die aan de klant wordt overgemaakt. - Het lopende kwartaal kan nooit worden opgevraagd. - De gegevens ouder dan 4 jaar kunnen niet worden opgevraagd. Verschillen ten opzichte van de stroom L035 In de stroom L035 kan worden gekozen welk type uitkeringen moet worden teruggevorderd: activeringsuitkeringen, ongeacht de leeftijd; activeringsuitkeringen voor werknemers ouder dan 50 jaar. De gegevensblok met betrekking tot de werkgevers mag slechts 5 voorkomens hebben in de stroom L035 terwijl 30 voorkomens mogelijk zijn in de webservice. UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 20 / 34

21 Verzoek Zone Beschrijving M/C 5 XML INSZ sociaal verzekerde INSZ van de werkloze M searchcriteria\ssin Opgevraagde kwartaal Kwartaal waarvoor de gegevens worden opgevraagd M searchcriteria\quarter\quarternumber Opgevraagde jaar Jaar waarin het kalenderkwartaal wordt opgevraagd M searchcriteria\quarter\year 5 Mandatory / conditional UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 21 / 34

22 Figuur 6 - XSD van het verzoek UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 22 / 34

23 Antwoord Zone Beschrijving M/C 6 XML Gegevensblok met betrekking tot de activeringsbijdragen Deze gegevensblok heeft tussen 1 en 3 voorkomens Maand van uitbetaling Maand waarin de uitbetaling heeft plaatsgevonden M payedactivationsums\payedactivationsum\month Formaat: YYYY-MM Bedrag van de activeringsuitkering Bedrag van de activeringsuitkering voor deze maand M payedactivationsums\payedactivationsum\payedamo unt Uitgedrukt in eurocent. Beperking: 0 < bedrag< eurocent Gegevensblok met betrekking tot de werkgevers Deze gegevensblok heeft tussen de 1 en 30 voorkomens Werkgever KBO-nummer van de werkgever waarbij de werknemer in dienst is M payedactivationsums\employers\emplerentreprisenu mbre 6 Mandatory / conditional UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 23 / 34

24 Figuur 7 - XSD van het antwoord UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 24 / 34

25 3. Consultatiestroom 3.1. Gegevensstroom De berichten met betrekking tot de consultatiestroom kunnen op twee manieren worden uitgewisseld: in batch of online. De consultatiestroom gebeurt volledig online In deze stroom is de architectuur van de gegevensovermaking de volgende. Vragende instelling 1. online 3. online KSZ 2./5. online 4. online RVA 1. De vragende instelling stuurt de voorlegging met de vraag online op naar de KSZ. 2. De KSZ voert online controles uit. Indien het bericht wordt verworpen door de KSZ omdat er fouten zijn in de syntax, de veiligheids- of de integratiecontroles, stuurt de KSZ online een definitief negatief antwoord naar de vragende instelling. 3. Indien het bericht voldoet aan de controles van de KSZ, zal de KSZ de RVA online raadplegen. 4. De RVA antwoordt online op de vragen van de KSZ. 5. De KSZ maakt het antwoord online over aan de vragende instelling. Als de vragende instelling en de KSZ online communiceren, komt dit overeen met een rechtstreekse webservice raadpleging. De consultatiestroom verloopt in batch In deze stroom is de architectuur van de gegevensovermaking de volgende. Vragende instelling 1. in batch 2./5. in batch KSZ 3. online 4. online RVA 1. De opvragende instelling stuurt de vraag in batch op naar de KSZ. 2. De KSZ voert controles uit. Indien het bericht door de KSZ wordt verworpen, stuurt de KSZ een negatief antwoord in batch op naar de opvragende instelling. 3. Indien het bericht aan de controles voldoet, raadpleegt de KSZ de RVA online. 4. De RVA antwoordt online op de vragen van de KSZ. 5. De KSZ maakt het antwoord in batch over aan de opvragende instelling. Als de opvragende instelling en de KSZ in batch met elkaar communiceren, komt dit overeen met een raadpleging webservice via de toepassing batch (LDM) BatchSOAP. UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 25 / 34

26 3.2. Integratiecontrole Voor deze gegevensstroom zal de KSZ een blokkerende integratiecontrole verrichten zowel ten opzichte van de afzender als van de bestemmeling. Dit houdt in dat de raadpleging met betrekking tot het INSZ, dat niet door de vragende instelling met de juiste hoedanigheid werd geïntegreerd in het personenrepertorium van de KSZ en waarvoor er geen relatie is met de raadplegingsperiode, wordt verworpen en teruggestuurd. Voor deze raadpleging wordt de RVA niet ondervraagd. Wat de raadplegingsperiodes betreft, wordt nagegaan of er een overlapping van één dag is met de periode uit het personenrepertorium: i. getpayedsums: De raadpleging van de bedragen die tijdens een bepaalde periode werden uitbetaald: Overlapping van één dag tussen "Beginmaand en eindmaand in de vraag" (maximaal drie maanden) en de integratieperiode van de klant. ii. getsituation: a. De raadpleging van de laatst gekende situatie "datum van de vraag" valt in de integratieperiode van de klant. b. De raadpleging van de laatst gekende situatie op een bepaalde datum. datum situatie valt in de integratieperiode van de klant. iii. getpayedactivationsums: De raadpleging van de bedragen uitbetaald in het kader van de activeringsuitkeringen. Overlapping van één dag tussen "Begindatum van het kwartaal en einddatum van de vraag" en de integratieperiode van de klant. De RVA maakt gegevens over voor dossiers van personen die hij geïntegreerd heeft met hoedanigheidcode 001 (gecontroleerde werkloze) en voor wie er een verband bestaat met de raadplegingsperiode. Wat de raadplegingsperiode betreft, wordt nagegaan of ze de periode uit het personenrepertorium overlapt met één dag: iv. getpayedsums: De raadpleging van de bedragen die tijdens een bepaalde periode werden uitbetaald: Overlapping met één dag tussen "Begin- en eindmaand in de aanvraag" en de integratieperiode RVA. v. getsituation: a. De raadpleging van de laatst gekende situatie Overlapping met één dag tussen de "dag van de aanvraag" en de integratieperiode RVA. b. De opvraging van de laatst gekende situatie op een bepaalde datum: Overlapping met één dag tussen de "datum situatie" en de integratieperiode RVA. vi. getpayedactivationsums: De raadpleging van de bedragen uitbetaald in het kader van de activeringsuitkeringen. Overlapping met één dag tussen de "Begin- en einddatum van het kwartaal in de vraag" en de integratieperiode RVA. UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 26 / 34

27 Specifieke gevallen 1 OCMW Bij de vergelijking tussen de raadplegingsperiode en de periode aanwezig in het personenrepertorium wordt de begindatum van de periode in het repertorium verlengd met één jaar. Behalve de integratiecontrole door de KSZ wordt een integratiecontrole verricht ten opzichte van het sectoraal repertorium van de OCMW's Verwerking De RVA deelt de informatie mee zoals ze op dat moment beschikbaar is in zijn gegevensbanken. De raadpleging van het vervangingsinkomen uit werkloosheid, is elke werkdag mogelijk, behalve op vrijdag tussen 18:00 en 24:00 wegens back-upwerkzaamheden en eventueel op vooraf aangekondigde tijdstippen wegens technische onderhoudswerkzaamheden Scenario s Voor elke vraag (= voorlegging) die de KSZ ontvangt van een vragende instelling, zijn 3 soorten definitieve antwoorden mogelijk: - Verwerping van de vraag door de KSZ = negatief definitief antwoord - Aanvaarding van de vraag door de RVA = positief definitief antwoord met de gevraagde informatie in het gegevensgedeelte - Verwerping van de vraag door de RVA = negatief definitief antwoord met de reden van verwerping in het gegevensgedeelte Verwerping van de vraag door de KSZ De vragende instelling maakt de voorlegging UnemploymentDataService over aan de KSZ. Dit kan zowel online als in batch gebeuren. De KSZ verricht controles en hieruit blijkt dat ze de RVA niet mag raadplegen. De KSZ stuurt onmiddellijk een definitief antwoord naar de vragende instelling en de stroom wordt afgesloten. Dit antwoord is afhankelijk van hoe de voorlegging door de afzender is verstuurd, online of in batch. Aanvaarding van de vraag door de RVA De vragende instelling maakt de vraag UnemploymentDataService over aan de KSZ. Dit kan zowel online als in batch gebeuren. De KSZ verwerkt het bericht en ondervraagt de RVA. Dit gebeurt online. Indien de RVA positief antwoordt op de vragen die in het kader van de aanvraag worden gesteld, wordt (worden) de vraag (vragen) door de KSZ verwerkt en wordt een definitief (positief of negatief) antwoord overgemaakt aan de vragende instelling, online of in batch, naar gelang de manier waarop de voorlegging werd ingediend. UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 27 / 34

28 Verwerping van de vraag door de RVA Idem als in het voorgaande scenario maar hier wordt een ondervraging verworpen door de RVA. Uit deze door de RVA verworpen ondervraging genereert de KSZ een definitief (negatief) antwoord. Dit negatieve antwoord wordt afhankelijk van hoe de voorlegging is verstuurd, online of in batch doorgestuurd naar de vragende instelling. Gegevens die resulteren uit de verwerking Elk antwoord van de KSZ omvat een blok status waarin wordt aangeduid of het antwoord positief (omvat gegevens) of negatief is (businessfout KSZ of RVA). status value (mandatory) code (mandatory) description (optional) Information (0-15) fieldname (mandatory) fieldvalue (optional) Geeft een algemene aanduiding over de status van het antwoord. De mogelijke waarden zijn: DATA_FOUND NO_DATA_FOUND NO_RESULT Bevat meer gedetailleerde informatie dan het element value. De mogelijke waarden: zie lijst met de returncodes (Codes in de blok status) is een vrijetekstzone waarin een foutbericht op leesbare wijze kan worden opgenomen Deze velden kunnen worden ingevuld om bijkomende details mee te delen. Meer gestructureerd detailniveau UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 28 / 34

29 Figuur 8 - Blok status Technische fout Bij een technische fout wordt een antwoord UnemploymentDataFault gegenereerd. Wanneer de fout binnen de dienst gebeurt, bevat UnemploymentDataServiceFault de blokken informationcustomer, informationcbss en details. De beschrijving van de eerste twee blokken staat in het punt Prefix. Het blok detail wordt hier gedetailleerd beschreven. detail severity (mandatory) reasoncode (mandatory) Geeft een algemene aanwijzing over de ernst van de fout. De mogelijke waarden zijn de volgende: FATAL Geeft meer gedetailleerde informatie dan het element value. De mogelijke waarden: zie lijst met de returncodes (Technische codes in SOAP Fault) Diagnostic (mandatory) Beschrijving van de «reasoncode»: UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 29 / 34

30 De mogelijke waarden: zie lijst met de returncodes (Technische codes in SOAP Fault) authorcode (mandatory) « Information (0-15) fieldname (mandatory) fieldvalue (optional) Deze velden kunnen worden ingevuld om een bijkomend detailniveau te verkrijgen. Meer gestructureerd detailniveau. Wanneer de technische fout plaatsvindt vooraleer de dienst te bereiken, wordt een SOAPFault met de elementen faultcode en faultstring teruggestuurd naar de klant Prefix Figuur 9 - XSD CBSSFaultType Voorleggingsprefix Voor de voorleggingen wordt steeds het voorleggingsprefix gebruikt. In het gegevensgedeelte van de vraag geeft de vragende instelling aan welke gegevens zij wil krijgen. De informatie in die prefix is de volgende: - LegalContext : geeft aan voor welke doeleinde deze dienst wordt gebruikt. UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 30 / 34

31 - informationcustomer : biedt de klant de mogelijkheid om zich te identificeren en zijn verzoek te identificeren. Figuur 10 - Bloc InformationCustomer Antwoordprefix Voor alle antwoorden wordt het antwoordprefix gebruikt. Een antwoord bestaat uit een antwoordprefix en een gegevensgedeelte. De informatie in die prefix is de volgende: - legalcontext: overgenomen uit het verzoek van de klant - informationcustomer: overgenomen uit het verzoek van de klant - informationcbss : identificatienummer dat door de KSZ is toegekend aan het verzoek/antwoord Figuur 11 - Bloc Information CBSS Verzoek Antwoord legalcontext Legal Context van de Idem verzoek UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 31 / 34

32 klant voor dit verzoek informationcustomer - ticket Referentie van de klant Idem verzoek - timestampsent Timestamp versturen Idem verzoek verzoek van de klant - customeridentification o cbenumber CBE van de klant Idem verzoek Ou o sector Sector van de klant Idem verzoek o instelling Instelling van de klant Idem verzoek informationcbss - ticketcbss / uuid KSZ-referentie voor dit bericht - timestampreceive / Timestamp van het ogenblik waarop de KSZ het verzoek heeft ontvangen - timestampreply / Timestamp van het ogenblik waarop de KSZ het antwoord heeft verstuurd UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 32 / 34

33 4. Bijlagen 4.1. Lijst codes aard werkloosheid (RVA) Hieronder volgt de lijst met codes aard werkloosheid zoals gehanteerd in deze gegevensstroom. Code Beschrijving Ofwel alle uitkeringen ongeacht het type werkloosheid; 00 Niet vergoedbaar als werkloze 01 Volledige werkloosheid als voltijdse werknemer X 02 Tijdelijke werkloosheid als voltijdse werknemer X 03 Volledige werkloosheid als vrijwillig deeltijdse werknemer X 04 Tijdelijke werkloosheid als vrijwillig deeltijdse werknemer X 05 Deeltijdse werknemer met behoud van rechten gerechtigd op de inkomensgarantie-uitkering 06 Deeltijdse werknemer met behoud van rechten enkel vergoedbaar voor tijdelijke werkloosheid 09 Brugpensioen als voltijdse werknemer X 10 Brugpensioen als vrijwillig deeltijdse werknemer X 11 Beroepsopleiding of voltijdse uitkering voor stage of opleiding 12 Tewerkstelling beschutte werkplaats X 15 Oudere grensarbeider X 16 Verhoogde werkloosheidsuitkering gedurende de laatste maand van de beroepsopleiding - voltijdse werknemer 17 Verhoogde werkloosheidsuitkering gedurende de laatste maand van de beroepsopleiding - vrijwillig deeltijdse werknemer 18 Halftijds brugpensioen X 21 Jeugdvakantie-uitkeringen X 22 Seniorvakantie-uitkeringen X 31 Deeltijdse uitkering voor stage of opleiding X 39 Volledig werkloze vrijwillig deeltijdse werknemer die bijkomend recht heeft op de mobiliteitstoeslag, de kinderopvangtoeslag en op de toeslag van 247,89 EUR ingevolge het volgen van een beroepsopleiding X X X X X X UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 33 / 34

34 40 Vestigingsuitkering X 57 Deeltijdse werknemer met behoud van rechten gerechtigd op de inkomensgarantie-uitkering (regeling vanaf ) 58 Vrijwillig deeltijdse werknemer met recht op inkomensgarantie-uitkering In voege vanaf ) X X 4.2. Lijst returncodes (RVA) Hieronder volgt de lijst met returncodes zoals gehanteerd in deze gegevensstroom. Technische codes in SOAP Fault Beschrijving Code Severity Communicatie met ongeldige externe dienst (RVA) UD FATAL De dienst (KSZ) is tijdelijk niet beschikbaar. Probeer later MSG00001 FATAL opnieuw. De externe dienst is niet beschikbaar (RVA of sectoraal MSG00002 FATAL repertorium). Probeer later opnieuw. Onverwachte interne fout (KSZ) MSG00003 FATAL Ongeldig verzoek OCMW Geen blok fault detail Toegang tot de dienst (KSZ) geweigerd Geen blok fault detail Codes in de blok status Beschrijving Code Value Er werden gegevens gevonden die overeenstemmen MSG00000 DATA_FOUND met de opzoekingscriteria. Het recht is gekend maar er is geen uitbetaling UD DATA_FOUND gekend. Er werden geen gegevens gevonden die aan de UD NO_DATA_FOUND opzoekingscriteria voldoen. INSZ niet gekend bij de RVA in de wettelijke context UD NO_DATA_FOUND van de KSZ (Integratie) Uitbetaling zonder dat er een recht is gekend op de UD NO_DATA_FOUND gevraagde datum Dit is niet normaal. De betaling wordt in dat geval niet meegedeeld. INSZ geannuleerd MSG00007 NO_RESULT INSZ niet gekend MSG00005 NO_RESULT INSZ vervangen MSG00006 NO_RESULT Formaat INSZ niet geldig MSG00011 NO_RESULT Wettelijke context niet geldig MSG00013 NO_RESULT INSZ niet geldig bij het OCMW in de juiste wettelijke MSG00012 NO_RESULT context (Integratie) Tijdsaanduiding niet juist in de aanvraag UD NO_RESULT UnemploymentDataService Raadpleging vervangingsinkomen uit werkloosheid p 34 / 34