Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Info |
---|
Informatie:Voor de ontsluiting van een MAGDA 2.0 publicatiedienst wordt verwezen naar Bestandsuitwisseling (Publicaties/batchverwerking). |
Excerpt | ||
---|---|---|
| ||
Deze publicatiedienst geeft de DmfA attesten van een werknemer weer. Deze publicatie wordt aangevraagd via de Werk.GeefDmfaVoorWerknemer-03.00 dienst. |
Situering
Dit document beschrijft het gebruik en de werking van de publicatie van DmfAVoorWerknemer 02.02 zoals deze door MAGDA aangeboden wordt. Deze publicatie is het resultaat van een semi-online opvraging via de webservice Werk.GeefDmfaVoorWerknemer-03.00.
Verwante diensten
RegistreerInschrijving en RegistreerUitschrijving:
Deze diensten worden gebruikt voor het aanmaken en wissen van een inschrijving in het MAGDA inschrijvingsrepertorium. Op basis van deze inschrijvingen worden de PubliceerMutatieDmfaVoorWerknemer publicaties ontvangen en verdeeld.
Voordat publicaties kunnen ontvangen worden dienen de INSZ worden geregistreerd in het MAGDA inschrijvingsrepertorium. Dit gebeurt via de RegistreerInschrijving dienst.
Indien publicaties voor een bepaalde INSZ niet meer ontvangen moeten worden dient deze INSZ uitgeschreven te worden uit het inschrijvingsrepertorium via de RegistreerUitschrijving dienst. Meer informatie over deze diensten is te vinden in de MAGDA gebruikersgroep site.
Samenwerking :
De afnemer registreert een INSZ nummer in het KSZ inschrijvingsrepertorium via de RegistreerInschrijving dienst
De PubliceerMutatieDmfaVoorWerknemer dienst geeft een publicatie voor het INSZ nummer
Drawio | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Werk.GeefDmfaVoorWerknemer-03.00: Voor het opvragen van de DmfaVoorWerknemer gegevens en dit online als semi-online. Online betekent hier dat het antwoord met gegevens onmiddellijk terugkomt. Semi-online houdt in dat het er wel een antwoord is bij het uitvoeren van de webservice, maar dat dit antwoord geen gegevens bevat. Het antwoord bevat enkel een “wel geslaagd” of “niet geslaagd”, om aan te duiden dat de request (niet) goed verwerkt werkt. De eigenlijke gegevens worden dan via een bestand over ftp afgeleverd.
Gegevensbronnen
De oorspronkelijke bron van de gegevens is de RSZ(PPO). De bestanden worden ontvangen via:
Kruispuntbank Sociale Zekerheid (KSZ).
Note |
---|
Opmerking:Agentschap Digitaal Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens. |
Gebruiksvoorwaarden
Afnemers moeten aan volgende voorwaarden voldoen om deze dienst te mogen gebruiken:
Machtiging van het sectoraal comité van de Sociale Zekerheid
Toelating tot de dienst A820M bij de Kruispuntbank Sociale Zekerheid
Toelating tot MAGDA
Info |
---|
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. |
Functionaliteiten
Deze dienst is een Publicatie-service die getriggerd wordt door de Werk.GeefDmfaVoorWerknemer-03.00 dienst. Er is dus geen scheduler die ingesteld wordt voor het beschikbaar stellen van de gegevens. Elke afnemer heeft de mogelijkheid om in samenspraak met Digitaal Vlaanderen te bepalen welke gegevens gevraagd worden, op basis van welke criteria deze geselecteerd moeten worden.
De gegevens worden na publicatie beschikbaar gesteld op de MAGDA FTP server. De exacte locatie van deze folder en de naam wordt in samenspraak met Digitaal Vlaanderen bij aansluiting beslist. De folderstructuur en de manier waarop de gegevens opgehaald kunnen worden, wordt beschreven in de FTP richtlijnen.
In het geval er geen gegevens geselecteerd zouden worden, wordt er standaard geen bestand aangemaakt, tenzij de afnemer uitdrukkelijk vraagt om in dat geval toch een uitzonderingsbestand aan te leveren.
Werking
Semi-online Opvraging
Vooraleer er een bestand beschikbaar is moet de afnemer natuurlijk een vraag uitgevoerd hebben via Werk.GeefDmfaVoorWerknemer-03.00 met de aanduiding dat het antwoord in een bestand moet terugkomen. (Element AntwoordInBatch = 1).
Als antwoord verkrijgt de afnemer een “Wel geslaagd” of “Niet geslaagd”. Tijdens de nacht verwerkt KSZ deze vragen en maakt er een bestand van. Dit bestand wordt opgepikt door MAGDA, gevalideerd en getransformeerd naar een MAGDA formaat.
Na de nodige autorisatiecontroles, filtering, … wordt het bestand afgeleverd op de FTP-folder van de afnemer. De afnemer kan dit bestand dan oppikken voor verdere verwerking en zijn eigen systemen.
Verdeelde gegevens
De gegevens worden verdeeld op basis van de criteria die besproken worden tijdens het aansluitingsproces of voorafgaande gesprekken.
Verfijnde selecties zijn mogelijk, gelieve hiervoor contact op te nemen met helpdesk.magda@vlaanderen.be.
Opties
Volgende afleveropties kunnen ingesteld worden in functie van de machtigingen en de wensen van de afnemer:
Compressie van het bestand in .zip
Bundeling van bestanden (gezamelijke aflevering van meerdere publicaties)
Compressie van de bundeling
Borderelbestand (oplijsting afgeleverde bestanden, enkel mogelijk indien bundeling)
Uitzonderingsbestand / leeg bestand (indien er geen gegevens te publiceren zijn, verkrijgt men toch een bestand)
Controlebestand (bevat een md5, gebruikte encoding, gebruikte en volgende herstartdatum)
Opkuis & Logging
De gegevens in het bestand worden bewaard zoals beschreven op de pagina “MAGDA logging”.
Bestanden worden gedurende een beperkte tijd aangeboden op de FTP folder zoals beschreven in de FTP richtlijnen.
Beschikbaarheid
De periodiciteit van aanlevering via MAGDA is te bespreken tijdens het aansluitingsproces of voorafgaande besprekingen. Algemeen beschouwd is het mogelijk de gegevens dagelijks, wekelijks, … aan te bieden.
Note |
---|
Opmerking:De beschikbaarheid van de dienst staat beschreven op de MAGDA richtlijnen pagina. |
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
Table of Contents | ||
---|---|---|
|
Binnen deze handleiding
Child pages (Children Display) |
---|
Omgevingsinformatie
Domein | Werk |
---|---|
Classificatie | Persoonsgegevens |
Verwante diensten
Child pages (Children Display) | ||||
---|---|---|---|---|
|
Info |
---|
Met vragen kunt u steeds terecht bij de MAGDA Service Desk. |