Inburgering.GeefDossierKBI-02.00
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.
De webservice GeefDossierKBI 2.0 stelt de gebruiker in staat om op basis van een INSZ (Rijksregisternummer) de gegevens rond het inburgeringsdossier op te vragen.
Situering
Deze webdienst kadert binnen het domein Inburgering van het MAGDA platform.
Gegevensbronnen
De oorspronkelijke bron van deze gegevens is AgII.
Meer informatie over hoe deze bronnen gebruikt worden in de opbouw van het antwoord vindt u onder Opvraging.
Opmerking:
Agentschap Digitaal Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens.
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.
Informatie:
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.
Batch
Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.
Prefix | inburgering.geefdossierkbi-0200 |
---|---|
Voorbeeld | inburgering.geefdossierkbi-0200_20220203115553530 |
Verwante diensten
De diensten RegistreerInschrijving 2.0 en RegistreerUitschrijving 2.0. Voor respectievelijk het inschrijven en aanpassen/verwijderen van geregistreerde inschrijvingen in het MAGDA inschrijvingsrepertorium.
Functionaliteiten
In het kader van de uitwisseling van gegevens tussen VDAB, AgII, VMSW en 4 OCMW’s voorziet MAGDA een GeefDossierKBI webservice Gateway. Deze Gateway maakt het voor de afnemers van het MAGDA platform mogelijk het inburgeringsdossier, bewaard bij AgII, op te vragen. Dit dossier omvat een aantal gegevens waarvoor AgII de authentieke bron is zoals: doelgroep, trajecten, behaald NT2-niveau etc. Deze gegevens worden geregistreerd door een Onthaalbureau of een Huis van het Nederlands.
Vraag
De gebruiker dient te beschikken over het INSZ nummer van de betrokken persoon om deze dienst te kunnen bevragen.
Antwoord
Het antwoord van de dienst bestaat uit het inburgeringsdossier zoals gekend bij AgII.
Werking
Aandachtspunten
Deze webservice volgt volledig de MAGDA 2.0 standaarden
Deze webservice is wat betreft MAGDA een pure Gateway-dienst. Dit houdt in dat MAGDA enkel instaat voor authenticatie, autorisatie, personen inschrijvingscontrole en filtering
Wat betreft het inhoudelijke wordt verwezen naar de documentatie aangeboden door AgII zelf.
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.
De vraag wordt dan doorgestuurd naar de webservice van AgII waar naar de gevraagde gegevens gezocht wordt.
Worden er geen gegevens gevonden verkrijgt men een gepaste foutmelding (30001 – Geen gegevens gevonden). In het geval het INSZ in de vraag bij AgII gekend is bekomt men een KBIDossier element in het antwoord.
Het antwoord wordt nogmaals gevalideerd waarna het aan de afnemer ter beschikking gesteld wordt. Afhankelijk van de machtigingen worden er al dan niet gegevens uit het antwoord gefilterd.
Responsetijden & Beschikbaarheid
De webservice op het MAGDA platform is 24 uur op 24 en 7 dagen op 7 beschikbaar. Deze webservice is afhankelijk van KBI als bron.
Bij geplande onbeschikbaarheden worden de afnemers op de hoogte gebracht.
Logging
De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op deze pagina "MAGDA logging".
Op deze pagina
Binnen deze handleiding
Omgevingsinformatie
Domein | Inburgering |
---|---|
Classificatie | Persoonsgegevens |
Verwante diensten
Related pages
Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren
De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid
uitgegeven door Digitaal Vlaanderen