Beschrijving Vraag (Vlok.GeefMutatiesNotificaties-02.01)

De vraag bestaat uit de identificatie en hoedanigheid van de afnemer. Er kan eventueel een ontvangstreferte meegegeven worden indien de afnemer eerder een opvraging had gedaan en die referte gebruikt om het ‘vervolg’ op te vragen.

Algemeen

1. VLOK stuurt dagelijks een mutatiebestand via FTP naar MAGDA (via de scheduled task OverzichtWijzigingenTask). Daarin zitten alle wijzigingen aangebracht door VLOK. Er gebeuren geen bewerkingen door MAGDA op de aangeleverde data door VLOK.

2. De beveiliging gebeurde voorheen via SSH (SFTP of SSH File Transfer Protocol). Dit wordt voortaan beveiligd met FTPS en een (VO-DCBaaS) certificaat. De accountnaam en CN voor het certificaat worden vrijgegeven tijdens het aansluitingsproces.

Zie ook de MAGDA-handleiding inzake werking FTPS: https://vlaamseoverheid.atlassian.net/wiki/spaces/MG/pages/1611075617/Werking+FTPS

3. MAGDA filtert op NIS-code om deze gegevens beschikbaar te maken per gemeente.

4. Er moet geen voorafgaande registratie gebeuren voor welke objecten je wil mutaties ontvangen.

5. De mutaties zijn oproepbaar per NIS-code en hoedanigheidscode. Aldus kan per applicatie een aparte hoedanigheidscode toegekend worden, zodat de mutaties meermaals kunnen beschikbaar gesteld worden per applicatie voor dezelfde gemeente.

6. Ontvangstreferte is optioneel veld in de vraag. Door middel van de ontvangstreferte bevestigt de afnemer bij de volgende vraag de goede verwerking van de mutatienotificaties, en verkrijgt men de volgende set van gegevens. Indien niet vermeld, worden de laatst opgevraagde gegevens terug getoond. Ook bij de eerste keer dat de webservice wordt aangeroepen, moet de opvraging gebeuren zonder ontvangstreferte.

7. De mutatienotificaties die reeds bevestigd zijn met de ontvangstreferte worden gearchiveerd en zijn niet meer beschikbaar voor de afnemer. Om mutaties na archivering op te vragen, moet er contact opgenomen worden met de MAGDA helpdesk.

8. Indien er geen notificaties meer beschikbaar zijn, dan bevat het antwoord ‘geen verdere gegevens beschikbaar’ (30016). De volgende keer dat er dan mutatiesnotificaties worden opgevraagd, dient de vraag gesteld te worden ZONDER ontvangstreferte.

Detail

Element	Beschrijving	V/O	Opmerkingen
Inhoud		V	VLOK stuurt dagelijks een mutatiebestand via FTP naar MAGDA. Daarin zitten alle wijzigingen aangebracht door VLOK. Er gebeuren geen bewerkingen door MAGDA op de aangeleverde data door VLOK. MAGDA filtert op NIS-code om deze gegevens beschikbaar te maken per gemeente. Er moet geen voorafgaande registratie gebeuren voor welke objecten je wil mutaties ontvangen.
Identificatie	URI van de afnemer	V
Hoedanigheid	Hoedanigheidcode van de afnemer	V	De mutaties zijn oproepbaar per NIS-code en hoedanigheidscode. Aldus kan per applicatie een aparte hoedanigheidscode toegekend worden, zodat de mutaties meermaals kunnen beschikbaar gesteld worden per applicatie voor dezelfde gemeente.
Ontvangstreferte	Ontvangstreferte zoals doorgestuurd werd in het vorige antwoord.	O	Bestaat uit een UUID (36) Ontvangstreferte is optioneel veld in de vraag. Door middel van de ontvangstreferte bevestigt de afnemer bij de volgende vraag de goede verwerking van de mutatienotificaties, en verkrijgt men de volgende set van gegevens. Indien niet vermeld, worden de laatst opgevraagde gegevens terug getoond. Ook bij de eerste keer dat de webservice wordt aangeroepen, moet de opvraging gebeuren zonder ontvangstreferte. De mutatienotificaties die reeds bevestigd zijn met de ontvangstreferte worden gearchiveerd en zijn niet meer beschikbaar voor de afnemer. Om mutaties na archivering op te vragen, moet er contact opgenomen worden met de MAGDA helpdesk. Indien er geen notificaties meer beschikbaar zijn, dan bevat het antwoord ‘geen verdere gegevens beschikbaar’ (30016). De volgende keer dat er dan mutatiesnotificaties worden opgevraagd, dient de vraag gesteld te worden ZONDER ontvangstreferte.