Situering

Dit document beschrijft het gebruik en de werking van de webservice RegistreerMutatieIndiceringWerknemer 2.0 zoals deze door Digitaal Vlaanderen op het MAGDA platform aangeboden wordt.

Verwante diensten

• GeefMutatiesIndiceringWerknemer 2.0: voor het ophalen van de mutaties via een webservice (deze dienst werd voorlopig nog niet voorzien)

• PubliceerMutatiesIndiceringWerknemer: dienst voor de verdeling en aflevering van de mutatiegegevens

• De diensten RegistreerInschrijving 2.0 en RegistreerUitschrijving 2.0. Voor respectievelijk het inschrijven en aanpassen/verwijderen van geregistreerde inschrijvingen in het MAGDA personen inschrijvingsrepertorium. Afhankelijk van de machtiging moet de afnemer (leverancier) al dan niet een inschrijving hebben voor de persoon vooraleer hij een mutatie met betrekking tot deze persoon kan registreren.

Gegevensbronnen

In feite is de afnemer van deze webservice de leverancier van gegevens.

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

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:

• Machtiging Vlaamse toezichtscommissie

Batch

Deze webserice 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 RMIW gebruikt. Voor meer informatie, 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

De webservice RegistreerMutatieIndiceringWerknemer laat een gegevensbron toe om via deze weg aan alle geïnteresseerde en gemachtigde afnemers alle gegevens door te geven omtrent de in dienst name van een werknemer met een arbeidshandicap bij een erkend maatwerkbedrijf. Ook latere wijzigingen aan deze gegevens kunnen via deze service doorgeven worden. De mutatie wordt gemeldt op basis van het INSZ van de persoon wiens gegevens toegevoegd of gewijzigd worden.

De geregistreerde mutaties worden bewaard op het MAGDA platform en op regelmatige tijdstippen verdeeld naar de gemachtigde en geïnteresseerde afnemers. Na verdeling worden de geregistreerde gegevens verwijderd.

Als vraag wordt doorgestuurd:

• Een metadata blok met hierin de mutatiedatum, type mutatie en een unieke mutatiereferte

• De gegevens met betrekking tot de werknemer, zijn tewerkstelling en zijn gegevens met betrekking tot zijn arbeidshandicap (indicering).

Als antwoord verkrijgt men een “wel geslaagd” of “niet geslaagd”.

Opvraging

Bij het registeren van een mutatieindicering wordt deze op het MAGDA platform bewaard. Bij een succesvolle registratie verkrijgt de afnemer (hier in feite leverancier) als antwoord een “Wel geslaagd”. Van zodra er een Wel geslaagd ontvangen werd is de registratie uitgevoerd.

De mutatieindicering blijft bewaard totdat deze door het PubMut 2.0 framework verdeeld is naar gemachtigde en geïnteresseerde afnemers. Van zodra de verdeling succesvol is uitgevoerd worden de geregistreerde mutaties verwijderd.  Deze verdeling gebeurt op regelmatige tijdstippen en wordt bepaald in samenspraak met de afnemers.

De verdeelde mutaties kunnen opgehaald worden via FTP.

(Later is het eventueel ook mogelijk om deze op te halen via webservice, maar deze dienst werd nog niet ontwikkeld.)

Responsetijden & Beschikbaarheid

De webservice op het MAGDA platform is 24 uur op 24 en 7 dagen op 7 beschikbaar. Deze webservice is niet afhankelijk van externe bronnen zoals Rijksregister, KSZ, … .

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

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.

Op deze pagina

Binnen deze handleiding

Omgevingsinformatie

Verwante diensten