SocZek.GeefStatuutRVV-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 GeefStatuutRVV 2.0 zoals deze door Digitaal Vlaanderen op het MAGDA platform aangeboden wordt. RVV staat voor 'recht op verhoogde verzekeringstegemoetkoming'.
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 webservice te mogen gebruiken:
Toelating tot het MAGDA platform
Machtiging 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). 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. Als prefix voor de batchbestanden wordt GSRD (GeefStatuutRvvDienst)
Meer informatie hierover kan u vinden via “Aansluiting op het MAGDA-platform” in het document “MS – Gebruikershandleiding_WebserviceInBatch”, of neem contact op met helpdesk.magda@vlaanderen.be.
Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.
Prefix | SocZek.GSRD-02.00 |
---|---|
Voorbeeld | SocZek.GSRD-02.00_20131103115553530 |
Functionaliteiten
De webservice GeefStatuutRVV 2.0 stelt de gebruiker in staat na te gaan of een persoon al dan niet recht heeft op verhoogde tegemoetkoming (RVV / Omnio).
Zowel Omnio als RVV zijn vormen van een verhoogde tegemoetkoming. Personen met een laag gezinsinkomen kunnen onder bepaalde voorwaarden aanspraak maken op zo’n statuut. Hierdoor hebben zij recht op een hogere terugbetaling van hun medische kosten. Personen met een Omnio- of RVV-statuut betalen bijvoorbeeld minder of geen remgeld voor:
een ziekenhuisverblijf
verstrekkingen door een arts, tandarts, kinesitherapeut, …
sommige geneesmiddelen bij de apotheker
Naast de verhoogde tegemoetkoming bieden het Omnio- en RVV-statuut ook nog andere voordelen. Een korting op het openbaar vervoer en een lagere bijdrage voor de Vlaamse Zorgverzekering (enkel in Vlaanderen) zijn slechts enkele voorbeelden. Deze voordelen zijn geldig voor alle gezinsleden van de persoon die de verhoogde tegemoetkoming geniet.
De vraag zal gebeuren aan de hand van een verplicht INSZ, een (optionele) datum en een vlag om aan te geven of de einddatum van het statuut al dan niet moet teruggegeven worden.
De datum waarop het recht wordt opgevraagd mag echter niet vroeger liggen dan 1 jaar in het verleden en niet verder liggen dan 1 jaar in de toekomst (bepaalde instellingen verkorten deze datum echter nog tot 1 maand).
Als antwoord verkrijgt men een ja of nee (recht of geen recht op verhoogde tegemoetkoming), aangevuld met de datum waarop de geldigheid van het statuut gevraagd werd en, indien specifiek gevraagd, ook de einddatum van de geldigheidsperiode van het statuut. Deze einddatum zal beperkt worden tot 1 jaar na datum van opvraging of 1 jaar na uitvoeringsdatum.
De gegevens die door deze webservice beschikbaar gesteld zullen worden, zijn afkomstig van KSZ die achterliggend de informatie bevraagd bij de verschillende instellingen (ziekenfondsen).
Belangrijke opmerking:
Tot nader order geeft KSZ toch steeds de einddatum terug, ook al werd deze niet gevraagd!
“Normalement, nous avions prévu de ne fournir le "endDate" que lorsque la requête le demandait. Cependant au vu du comportement (variable par OA) du service fournisseur, nous avons préféré reprendre la date de l'assertion que nous donne le service du fournisseur par souci de transparence et éviter pour chaque situation particulière de devoir "débugger". En effet, cette date "endDate" peut varier de jour en jour !“
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 is er een functionele validatie van de vraag. Nadien zal de webservice achterliggend de BIMService van KSZ oproepen. Ontvangt de webservice een antwoord – hetzij de persoonsgegevens, 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
De webservice op het MAGDA platform is 24 uur op 24 en 7 dagen op 7 beschikbaar, maar is wel afhankelijk van de beschikbaarheid van de achterliggende service bij KSZ.
Bij geplande onbeschikbaarheden worden de afnemers op de hoogte gebracht.
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