Wijzigingshistoriek

Situering

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

Gegevensbronnen

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

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

Gebruiksvoorwaarden

Afnemers moeten aan volgende voorwaarden voldoen om deze dienst te mogen gebruiken:

• Toelating tot het MAGDA platform

Batch

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

Functionaliteiten

Vraag

Antwoord

Werking

Aandachtspunten

Opties

Volgende configuratieparameters kunnen ingesteld worden in functie van de machtigingen en de wensen van de afnemer:

• Configuratieparameters op het MAGDA platform zijn voor deze dienst niet van toepassing

Responsetijden & Beschikbaarheid

Logging

De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".

Ondersteunde talen

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.