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 OCMW’s publiceren wijzigingen aan de leefloonperiodes en geven deze door aan de POD-MI via de KSZ. De KSZ levert dagelijks een batchbestand met deze gegevens aan welke opgehaald wordt door MAGDA. De PubliceerMutatieNotificatieLeefloonperiode  02.01 dienst publiceert de mutaties van leefloonperiodes naar zijn afnemers. Meer specifiek zullen de INSZ nummers doorgegeven worden die sinds de laatste notificatie een wijziging ondervingen.

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 PubliceerMutatieNotificatieLeefloonperiode ontvangen en verdeeld.

Voordat publicaties kunnen ontvangen worden dienen de INSZ’en te 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.

GeefLeefLoonPeriode : Indien meer informatie nodig is over de zelfstandige waarvoor een INSZ is doorgestuurd in een mutatie dient deze informatie opgevraagd te worden via de GeefLeefloonPeriode dienst. Meer informatie over deze dienst is te vinden op de MAGDA gebruikersgroep.

Dataflow tussen verwante diensten : 

1. De afnemer registreert een INSZ nummer in het MAGDA inschrijvingsrepertorium via de RegistreerInschrijving dienst

2. De PubliceerMutatieNotificatieLeefloonperiode dienst geeft een notificatie voor het INSZ nummer

3. Via de GeefLeefloonPeriode worden alle nodige gegevens opgevraagd over de zelfstandige waarvan het INSZ nummer gepubliceerd is

Gegevensbronnen

De oorspronkelijke bronnen van deze gegevens zijn de OCMW’s. Deze gegevens worden via het KSZ ter beschikking gesteld aan Digitaal Vlaanderen.

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

Geef de volledige structuur op van de naam van de bestanden die klaar gezet worden voor de gebruiker. Prefixen zijn steeds in de form [domein].[ServiceNaam]-[Versie]_[timestamp].xml. Pas zeker de bestandsnamen aan in onderstaand voorbeeld als je het hergebruikt. Gebruik geen punt in de versie. Zet de vier cijfers van de versie achter mekaar. Gebruik Camel-case! De lengte van het deel voor de _timestamp mag maximaal 48 karakters lang zijn.

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

Functionaliteiten

KSZ ontvangt de wijzigingen in de persoonsgegevens van de OCMW’s via de POD-MI.

1. KSZ stelt deze wijzigingen beschikbaar aan diens partners op zijn FTP server.

2. De FTP Scheduler haalt dit bestand op bij de KSZ en stelt deze ter beschikking aan de File To File Scheduler

3. De File To File Scheduler doet een integriteitscontrole van de inkomende bestanden en stelt deze vervolgens ter beschikking van de File To DB scheduler

4. De File-To-DB scheduler zal instaan voor de correcte transformatie van het KSZ-formaat naar het MAGDA-formaat

5. Pubmut 02.01 pusht de gegevens naar de publicatiegateway

6. De publicatiegateway stelt de gegevens beschikbaar aan de afnemers

Werking

Opties

Volgende afleveropties zijn mogelijk. Deze moeten afgesproken worden bij aansluiting:

• Compressie van het bestand (.zip)

• Melding via mail van aflevering bestand

Responsetijden & Beschikbaarheid

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

Logging

De opvragingen die gebeuren via deze webservice 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.

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.