Overzicht handicapdiensten

Een overzicht van de verschillende handicapdiensten die beschikbaar zijn bij MAGDA is te vinden op Overzicht van de MAGDA handicap diensten.

Situering

Deze webservice biedt de mogelijkheid aan de openbare instellingen en aan verschillende gemachtigde organisaties om de informatie met betrekking tot de betalingen wegens handicap die door de verschillende authentieke bronnen worden beheerd, te raadplegen.

In eerste instantie was enkel het Directie-generaal personen met een handicap (DGPH) bevoegd. Dit is de authentieke bron die in de vorige versie 'GeefHandicap 2.0' geconsulteerd wordt. Als gevolg van de 6de Staatshervorming zijn sinds 2014 de deelgebieden bevoegd geworden voor de tegemoetkoming voor hulp aan bejaarden (THAB). Sinds 2018 wordt de naam THAB vervangen door zorgbudget voor ouderen. Langs Vlaamse zijde gebeurt de inkanteling van de bevoegdheid zorgbudget voor ouderen bij de Vlaamse Sociale Bescherming (VSB).

Deze dienst maakt achterliggend gebruik van de KSZ-dienst HandiService v2. Handiservice v2 biedt de mogelijkheid om de informatie met betrekking tot de aanvragen en erkenningen wegens handicap, die door de verschillende authentieke bronnen worden beheerd, te raadplegen. Deze gegevens kunnen geraadpleegd worden door middel van de dienst GeefDossierHandicap 3.0. De dienst GeefBetalingenHandicap 3.0 geeft informatie over de betalingen.

De webservice HandiService v2 biedt de mogelijkheid om de informatie bij de verschillende authentieke bronnen met betrekking tot de handicap te consulteren, namelijk DGPH, VSB, IRISCARE, NIC, DSL en AViQ.

Indien afnemers van Vlaamse overheidsentiteiten de handicapgegevens van het agentschap Opgroeien (Kind en Gezin) wensen te consulteren, kan dit via de dienst GeefZorgtoeslag.

Verwante diensten

SocZek.GeefDossierHandicap-03.00: Deze dienst geeft het dossier van een persoon met een handicap op een specifieke datum of over een periode.

Gezin.GeefZorgtoeslag-02.00: Deze dienst ontsluit handicapgegevens zoals deze worden aangeboden door Opgroeien.

Gegevensbronnen

De gegevens worden opgevraagd bij KSZ die op zijn beurt de achterliggende bronnen aanspreekt:

• DGPH

• VSB (nog niet beschikbaar op dit moment)

• IRISCARE (nog niet beschikbaar op dit moment)

• NIC (OAW) (nog niet beschikbaar op dit moment)

VSB kan wel aangeduid worden als achterliggende bron, maar VSB geeft op dit moment geen gegevens terug. Daar KSZ deze optie aanbiedt heeft MAGDA deze ook overgenomen.

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

Gebruiksvoorwaarden

Om gebruik te kunnen maken van deze dienst dient men een machtiging te hebben die toegang geeft tot deze gegevens en een aansluitingsprocedure te doorlopen.

Batch

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

Functionaliteiten

Met de GeefBetalingenHandicap 03.00 dienst kunnen de betalingen over een periode opgevraagd worden bij de authentieke bronnen van een persoon met een handicap aan de hand van een INSZ. Bij KSZ worden hiervoor de operatie ConsultPayments van de HandiServiceV2 dienst aangesproken.

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, bijvoorbeeld de inschrijvingscontrole.

Hierna vindt er een functionele validatie plaats van de vraag (bijvoorbeeld checksum 97 op het INSZ). Nadien zal de webservice achterliggend de HandiServiceV2 van KSZ oproepen. Ontvangt de webservice een antwoord – 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.

Bij deze dienst is de XSD van de bron gebruik in de vraag en het antwoord. Deel van de MAGDA vraag en antwoord XSD zijn daardoor in de Engelse taal. De inhoud van de berichten is echter volledig Nederlandstalig.