Doel: Met dit sjabloon kan u eenvoudig een nieuwe diensthandleiding aanmaken in Confluence. Gebruik de onderstaande knoppen om nieuwe componenten binnen de handleiding aan te maken. To do: - Vul de onderstaande handleidingsparagrafen in - Maak o.b.v. de specificaties van de dienst relevante subpagina's aan - Verwijder lege of niet-gebruikte paragrafen & pagina's - Let op: Gebruik de volledige naam van de dienst (Domein.DienstNaam-Versie).

De Excerpt bevat de tekst die wordt weergegeven in de overzichtspagina op domein niveau. De tekst die in dit kader staat wordt niet weergegeven in de handleiding zelf (deze pagina) en dient een korte omschrijving van de dienst te bevatten.

Situering

Dit document beschrijft het gebruik en de werking van de Gateway GeefStatusOndersteuningen 02.00.000 zoals deze door Agentschap Digitaal Vlaanderen op het MAGDA platform aangeboden wordt.

Verwante diensten

RegistreerInschrijving en RegistreerUitschrijving : 

Om deze dienst te kunnen gebruiken moet er eerst een inschrijving in het MAGDA inschrijvingsrepertorium voor personen aangemaakt worden. Deze inschrijvingen kunnen toegevoegd worden via de webservice RegistreerInschrijving 2.0.

Voor het verwijderen van een inschrijving kan de RegistreerUitschrijving 2.0 webservice gebruikt worden.

De informatie met betrekking tot deze webservices is terug te vinden op de sharepoint omgeving.

RegistreerDossierOnderneming en VerwijderDossierOnderneming :

Om deze dienst te kunnen gebruiken moet er eerst een inschrijving in het MAGDA inschrijvingsrepertorium voor ondernemingen aangemaakt worden. Deze inschrijvingen kunnen toegevoegd worden via de webservice RegistreerDossierOnderneming 01.01.

Voor het verwijderen van een inschrijving kan de VerwijderDossierOnderneming 01.01 webservice gebruikt worden.

De informatie met betrekking tot deze webservices is terug te vinden op de sharepoint omgeving.

Gegevensbronnen

De gegevens worden opgevraagd/opgeslagen bij VDAB.

Gebruiksvoorwaarden

Heeft de afnemer speciale toelatingen / machtigingen nodig voor consumeren van deze dienst?

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).

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.

De prefix voor de batchbestanden is GSO

Meer informatie hierover kan u vinden via “Aansluiting op het MAGDA-platform” in het document “MS – Gebruikershandleiding_WebserviceInBatch”, of neem contact op met Agentschap Digitaal Vlaanderen.

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

Functionaliteiten

De dienst GeefStatusOndersteuningen stelt een afnemer in staat om aan de hand van een INSZ en een Ondernemingsnummer de status van een ondersteuningsmaatregel op te vragen bij VDAB.

Werking

Aandachtspunten

Alvorens deze dienst te kunnen gebruiken dient de persoon die het onderwerp vormt van de vraag ingeschreven te zijn in het MAGDA inschrijvingsrepertorium voor personen. Meer informatie over inschrijvingen kan gevonden worden in het document “Domeincontext” [DC]. Deze inschrijvingscontrole wordt niet uitgevoerd indien de machtiging dit toelaat.

Responsetijden & Beschikbaarheid

De webservice op het MAGDA platform is 24 uur op 24 en 7 dagen op 7 beschikbaar.

De beschikbaarheid is afhankelijk van de beschikbaarheid bij de bron.

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

De afnemer verwacht vanuit een MAGDA-dienst een Nederlanstalig antwoord. Wanneer een antwoord mogelijk anderstalige informatie bevat is het relevant om dit hier mee te geven.

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.