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

Het Vlaams Agentschap voor Personen met een Handicap (VAPH) heeft een groot aantal gegevens over de erkenningen van personen met een handicap. Deze gegevens zijn niet beschikbaar in de stroom van de FOD Sociale Zekerheid en die aangeboden worden via de MAGDA-dienst GeefDossierhandicap 3.0 of GeefBetalingenHandicap 3.0.

Het VAPH erkent meerderjarige (vanaf 18 jaar) personen met een handicap. Er is een overlap met de erkenning van een handicap vanuit de FOD Sociale Zekerheid. Het kan dus dat een persoon erkend is bij de FOD Sociale Zekerheid en bij VAPH.

De GET handicap/volledigeDossiers dienst maakt de gegevens van het VAPH beschikbaar voor de afnemers via REST.

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-02.01 en Repertorium.RegistreerUitschrijving-02.00.

Gegevensbronnen

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

VAPH is de authentieke bron van de informatie ontsloten in deze dienst.

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
scope: soczek_handDos_v1_G

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

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.

Functionaliteiten

Vraag

De vraag bevat slechts 1 element: een rijksregisternummer.

Na ontvangst van de vraag wordt eerst een validatie gedaan en daarna een checksum97 controle. Indien de checksum97 controle faalt wordt een Response status code 400 gegeven. Na een succesvolle controle wordt de vraag doorgegeven aan de connector en kan deze doorgestuurd worden naar VAPH.

Antwoord

Het REST/JSON antwoord van VAPH wordt eerst gevalideerd met de SWAGGER. Na filtering wordt de het antwoord doorgestuurd naar de afnemer.

Werking

Opvraging

Het antwoord van deze dienst wordt gemaakt op basis van het antwoord dat we ontvangen van de achterliggende dienst

Responsetijden & Beschikbaarheid

Op acceptatie is de webservice is het mogelijk dat er onbeschikbaarheid is op volgende tijdstippen.

12u00 - 12u30
17u00 - 17u30
22u00 - 22u30

We raden dus aan te testen buiten deze intervallen.

Logging

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

Ondersteunde talen

MAGDA ondersteunt de Nederlandse taal.

Op deze pagina

1 Situering
2 Verwante diensten
3 Gegevensbronnen
4 Gebruiksvoorwaarden
5 Functionaliteiten
- 5.1 Vraag
- 5.2 Antwoord
6 Werking
- 6.1 Opvraging
- 6.2 Responsetijden & Beschikbaarheid
- 6.3 Logging
- 6.4 Ondersteunde talen

Binnen deze handleiding

Omgevingsinformatie

Domein	SocZek
Classificatie	gevoelige persoonsgegevens

Verwante diensten

MAGDA Gebruikersomgeving

GET socZek/handicap/volledigeDossiers