Overzicht MutatieNotificatie diensten
De MutatieNotificatie 02.01 diensten laten toe om een ruim palet van sleutels te registreren en te ontvangen zoals INSZ (PERS), ondernemingsnummer (OND), perceelnummer, … . Daarbij kan ook per notificatie een lijst ontvangen worden extra informatie over wat aan het opgegeven subject gewijzigd is, dit zonder het meesturen van de feitelijke gegevens.
Situering
De Algemeen.MutatieNotificatie diensten kaderen binnen het Algemeen domein omdat ze mutatie notificaties kunnen verwerken als ze worden aangeleverd in een MAGDA 2.0 formaat. Dit formaat is flexibel genoeg om vele soorten gegevens te kunnen bevatten en maakt het mogelijk om met minimale inspanningen de mutaties van de bron naar de afnemer door te geven. Indien een bron een specifiek formaat aanlevert zal een bron-specifieke dienst worden aangemaakt en zal deze in een ander domein worden geregistreerd. Zo levert de Vlok.PubliceerMutatieNotificatie-02.01 dienst een CSV bestand aan.
De MutatieNotificatie 02.01 diensten registreren en distribueren mutaties van specifieke data bij verschillende bronnen. De bron kan dus via deze dienst aan de afnemers laten weten dat een aanpassing is gebeurd aan data die door de bron beheerd wordt door het registreren van de identificatiesleutel van het gegeven. Enkele voorbeelden van deze sleutel :
INSZ
Ondernemersnummer
Pand identificatie
Enkel modificaties aan documenten die geschikt zijn voor publicatie worden doorgegeven. Documenten met een niet-zien-recht worden niet gedeeld. Mutaties kunnen creaties, wijzigingen of annulaties zijn. De exacte benamingen die gebruikt worden voor deze bewerkingen zijn bron afhankelijk. Dit document bevat de exacte gegevens die door VLOK worden doorgestuurd.
Hieronder is een overzicht te vinden van de dataflow van de verschillende MutatieNotificatie diensten.
Verwante diensten
MAGDA gebruikt vier diensten om MutatieNotificaties van de bron ter beschikking te stellen aan de afnemers.
Aan de bron-kant
Algemeen.RegistreerMutatieNotificatie-02.01 : Een webservice waarmee de bron MutatieNotificaties pusht
Algemeen.PubliceerMutatiesNotificaties-02.01 (Bron) : Een publiceerdienst waarmee MAGDA de MutatieNotificaties van de bron verwerkt
Aan de afnemer-kant
Algemeen.GeefMutatiesNotificaties-02.01 : Een webservice waarmee een afnemer de MutatieNotificaties binnen haalt over SOAP
Algemeen.PubliceerMutatiesNotificaties-02.01 (Afnemer) : Een publiceerdienst waarmee de afnemer MutatieNotificaties verkrijgt via (s)FTP.
Gedetailleerde documentatie voor deze vier diensten is te vinden in het domein Algemeen. Gebruik de koppelingen in de lijst hierboven. Daar deze diensten gebruikt worden om MutatieNotificaties van verschillende bronnen met elk hun eigen sleutels te verdelen zijn ze generiek gemaakt en onder het Algemeen domein gebracht. De bron-specifieke informatie valt onder het domein van de bron.
Gegevensbronnen
Bronnen registreren of publiceren mutatie notificaties bij de MAGDA MutatieNotificatie diensten. Uitleg over de bronnen en de informatie die ze ontsluiten wordt omschreven in de dienst specifieke pagina's
Opmerking:
Agentschap Informatie Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens.
Functionaliteiten
Afnemers kunnen via de PubliceerMutatieNotificatie 02.01 dienst of via de GeefMutatieNotificatie 02.01 dienst te weten komen dat er informatie bij de bron is aangepast. Daar de MutatieNotificatie diensten geen informatie bevatten over de effectief aangepaste gegevens maar enkel de sleutel die de aangepaste gegevens identificeert dient de afnemer de volledige gegevens van de bron op te vragen via een geef-dienst.
Voorbeeld
Een afnemer krijgt via de Algemeen.PubliceerMutatiesNotificaties-02.01 (Afnemer) dienst melding dat een aanpassing gebeurd is aan het dossier van een persoon. De mutatie notificatie bevat de INSZ van het aangepast dossier.
De afnemer vraagt via de Werk.GeefLoopbaanARZA-02.01 dienst het volledige dossier op van de Loopbaan van de persoon en kan zijn interne database updaten.
-
Algemeen.GeefMutatiesNotificaties-02.01 — Deze dienst laat toe om een ruim palet van sleutels te ontvangen zoals INSZ (PERS), ondernemingsnummer (OND), perceelnummer, … . Daarbij kan ook per notificatie een lijst ontvangen worden van wat aan het opgegeven subject gewijzigd is, dit zonder het meesturen van de feitelijke gegevens.
-
Algemeen.PubliceerMutatiesNotificaties-02.01 (Afnemer) — Met deze dienst kan een afnemer de sleutels ontvangen van verschillende bronnen welke een aanpassing aan hun dossier hebben gedaan. Deze bronnen laden deze sleutels op in het systeem via de Algemeen.RegistreerMutatieNotificatie-02.01 of de Algemeen.PubliceerMutatiesNotificaties-02.01 (Bron) dienst.
-
Algemeen.PubliceerMutatiesNotificaties-02.01 (Bron) — Deze dienst laat bronnen toe om sleutels en bijhorende informatie te registreren in het MAGDA register, dit om aan te duiden dat er een verandering gebeurd is in de data gerelateerd aan de sleutel. Er kan meta data bij de sleutel geregistreerd worden. Zo kan bijvoorbeeld VLOK een pandnummer registreren en daarbij de NIS code plaatsen van de gemeente die deze MutatieNotificatie mag ontvangen.
Related pages
Voor vragen of opmerkingen kan u de MAGDA helpdesk contacteren
De MAGDA Gebruikersomgeving is een officiële website van de Vlaamse overheid
uitgegeven door Digitaal Vlaanderen