Indien afnemers van Vlaamse overheidsentiteiten de gegevens zorgtoeslag van het agentschap Opgroeien wensen te consulteren, kan dit via de dienst GeefZorgtoeslag. De gegevens Zorgtoeslag van het agentschap Opgroeien kunnen niet geraadpleegd worden door middel van de dienst GeefDossierHandicap 3.0.

Overzicht handicapdiensten

Een overzicht van de verschillende handicap-diensten 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 onder meer de aanvragen en erkenningen 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 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. 

In het sluitstuk van de 6^de Staatshervorming nemen de andere deelgebieden de tegemoetkoming voor hulp aan bejaarden en de erkenning van de handicap voor kinderen over van de DGPH. De authentieke bronnen IRISCare (hulp aan bejaarden en erkenning kinderen voor Gemeenschappelijke Gemeenschapscommissie van Brussel), de Waalse Verzekeringsinstellingen (hulp aan bejaarden  voor het Waals Gewest), AViQ (erkenning kinderen voor het Waals Gewest) en DSL (hulp aan bejaarden en erkenning kinderen voor de Duitstalige Gemeenschap) kunnen potentieel bijkomend geconsulteerd worden.

GeefDossierHandicap 3.0 biedt momenteel de mogelijkheid om de informatie bij de verschillende authentieke bronnen met betrekking tot de handicap te consulteren, namelijk DGPH, VSB, IRISCARE, NIC AVIQ en DSL.

Volgende gegevensblokken kunnen worden opgevraagd op basis van een datum of een periode:

• Erkenning van de handicap

• Recht

• Sociale kaarten

Indien afnemers van Vlaamse overheidsentiteiten de gegevens zorgtoeslag van het agentschap Opgroeien wensen te consulteren, kan dit via de dienst GeefZorgtoeslag. De gegevens Zorgtoeslag van het agentschap Opgroeien kunnen niet geraadpleegd worden door middel van de dienst GeefDossierHandicap 3.0.

Verwante diensten

SocZek.GeefBetalingenHandicap-03.00: Deze dienst geeft een overzicht van de betalingen die geregistreerd zijn voor een persoon met een handicap.

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

• IRISCARE

• NIC (OAW)

• AVIQ

• DSL

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

Volgende onderdelen zijn beschikbaar voor bovenstaande bronnen

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 Repertorium.RegistreerInschrijving-02.00 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 het document.

Begin- en eindatum van de periode uit de vraag

Volgende elementen worden gebruikt als begin- en einddatum

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 GeefDossierHandicap 03.00 dienst kan een dossier opgevraagd worden bij de authentieke bronnen van een persoon met een handicap aan de hand van een INSZ. Dit kan op basis van een specifieke datum of op basis van een periode. Bij KSZ worden hiervoor respectievelijk de operaties ConsultFilesByDate en ConsultFilesByPeriod van de HandiServiceV2 dienst aangesproken.

Werking

Opties

• Configuratieparameters op het MAGDA platform zijn voor deze dienst niet van toepassing

Anchor
opvraging opvraging

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.