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

De dienst ‘GeefLoopbaanARZA-02.00’ laat de gebruiker toe om het Algemeen Repertorium van de Zelfstandige Arbeiders (ARZA) bij de Kruispuntbank Sociale Zekerheid (KSZ) te raadplegen. De opzoeking gebeurt aan de hand van het INSZ-nummer van de op te zoeken persoon.

Indien een afnemer gebruik wenst te maken van deze dienst, moet aangesloten worden op de nieuwe versie van de dienst (GeefLoopbaanArza 2.01).

Gegevensbronnen

De authentieke bron van de gegevens is het Rijksinstituut voor de Sociale Verzekeringen der Zelfstandigen (RSVZ).

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

Gebruiksvoorwaarden

Afnemers moeten aan volgende voorwaarden voldoen om deze webservice te mogen gebruiken:

• Toelating tot het MAGDA platform

EN/OF

• Machtiging van de kamer sociale zekerheid en gezondheid van het informatieveiligheidscomité

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.

Als prefix voor de batchbestanden wordt GLAD gebruikt.

Meer informatie hierover kan u vinden via “Aansluiting op het MAGDA-platform” in het document “MS – Gebruikershandleiding_WebserviceInBatch”, of neem contact op met helpdesk.magda@vlaanderen.be.

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

Functionaliteiten

Ruimte voor een korte beschrijving van de functionaliteiten van deze dienst voor zover die relevant zijn?

Vraag

De vraag bestaat uit het INSZ nummer van de persoon wiens gegevens opgezocht worden, ook wordt er een periode meegegeven in de vraag, de begindatum hiervan moet ingevuld worden. De gebruiker kan ervoor kiezen de einddatum niet in te vullen, dan wordt door het systeem de huidige datum ingevuld.

Antwoord

Het antwoord bevat:

• Het gebruikte INSZ-nummer

• Het ondernemingsnummer van de persoon (optioneel)

• De aansluitingsgegevens van de opgezochte persoon, dit bevat gegevens van het Sociaal Verzekeringsfonds waar de persoon bij aangesloten is en de loopbaangegevens van de persoon.

Werking

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.

Ook wordt er een checksum 97-validatie uitgevoerd op het INSZ-nummer.

Daarna gebeurt er een controle op de gegevens om te kijken of de gegevens al dan niet aanwezig is in de registers.

Opgelet: er is een vertraging van minimum 1 dag tussen de inschrijving door de bron (RSZV) en de mogelijkheid om het persoonsdossier te raadplegen.

Het antwoord wordt gevalideerd tegenover de XSD waarna het aan de afnemer ter beschikking gesteld wordt.

Responsetijden & Beschikbaarheid

De webservice op het MAGDA platform is 24 uur op 24 en 7 dagen op 7 beschikbaar. Bij geplande onbeschikbaarheden worden de afnemers op de hoogte gebracht via mail.

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.