Situering

Deze dienst maakt deel uit van een set LED diensten die via het MAGDA platform beschikbaar zijn. Het betreft hier een pure MAGDA Gateway op een bij LED beschikbare MAGDA 2.0 compliant businessdienst.

Het doel van het LED project is het bouwen van een authentieke gegevensdatabank met informatie over leer- en ervaringsbewijzen. Deze databank zal gevoed kunnen worden door (al dan niet) authentieke bronnen die op de centrale databank zijn aangesloten en kunnen worden bevraagd door gemachtigde belanghebbenden. De nood aan een dergelijke databank kwam onder meer naar boven in het beleidsdomein O&V in het kader van de financiering van het leerplichtonderwijs.

Verwante diensten

RegistreerBewijs: Dienst enkel beschikbaar voor de instanties die een LED bewijs uitreiken. Deze dienst laat deze instanties toe een bewijs te registreren in de LED.

GeefBewijs: Dienst voor het opvragen van een LED Bewijs, dit op basis van het actuele INSZ van de persoon.

RegistreerMutatieBewijs: Dienst enkel beschikbaar voor de LED zelf. Deze dienst laat LED toe een gemuteerd LED bewijs te registreren op het MAGDA platform voor verder verdeling naar de gemachtigde afnemers.

PubliceerBewijs: Dienst voor het verkrijgen van de gemuteerde bewijzen.

Gegevensbronnen

De gegevens worden verwijderd bij volgende (authentieke) gegevensbron(nen):

• LED – Leer- en Ervaringsdatabank

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

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. De exacte bestandsnamen en de naam van de folder worden meegedeeld tijdens het aansluitingsproces. Deze is steeds onder de vorm LED.AnnuleerBewijs-0200_timestamp.xml.

Voorbeeld: LED.AnnuleerBewijs-0200_20131103115553530.xml

Voor meer informatie: Webservice In Batch bevragen.

Functionaliteiten

Vraag

Het INSZ van de persoon waarvoor de bewijzen worden opgevraagd. Dit moet het actuele INSZ zijn. Indien dit niet het geval is dan zal de vraag niet succesvol zijn.

Antwoord

De inhoud van het antwoord van de dienst bestaat uit

Zie Beschrijving Vraag (AnnuleerBewijs-02.00).

Antwoord

Indien de annulering van het bewijs is geslaagd, zult u in het antwoord “OK” ontvangen bij het element “Melding”. Zie Beschrijving Antwoord (AnnuleerBewijs-02.00).

Indien de annulering niet is geslaagd, zult u een uitzondering ontvangen, zie Uitzonderingen (AnnuleerBewijs-02.00).

Werking

Anchor
opvraging opvraging

Opvraging

Responsetijden & Beschikbaarheid

De beschikbaarheid van de dienst staat beschreven in het MAGDA richtlijnen document.

De MAGDA response tijden zijn heel sterk afhankelijk van de response tijden van de bron. Als de brongegevens heel traag worden aangeleverd kan het MAGDA antwoord niet snel worden aangeleverd. Responsetijden tussen de 500ms en 10 seconden worden als normaal beschouwd.

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.