| Excerpt |
|---|
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. |
Wijzigingshistoriek
| Datum | Aanpassingen |
|---|
| Importeren van de handleiding in Confluence |
Situering
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 :
- Pand identificatie
- INSZ
- Ondernemersnummer
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.
| Drawio |
|---|
| baseUrl | https://vlaamseoverheid.atlassian.net/wiki |
|---|
| diagramName | Untitled Diagram.xml |
|---|
| contentId | 590741997 |
|---|
| width | 801 |
|---|
| zoom | 1 |
|---|
| pageId | 590709295 |
|---|
| diagramDisplayName | Untitled Diagram.xml |
|---|
| lbox | 1 |
|---|
| contentVer | 12 |
|---|
| height | 201200.99999999999997 |
|---|
| revision | 12 |
|---|
|
Verwante diensten
Gegevensbronnen
Meer informatie over hoe deze bronnen gebruikt worden in de opbouw van het antwoord vindt u onder Opvraging.MAGDA gebruikt vier diensten om MutatieNotificaties van de bron ter beschikking te stellen aan de afnemers.
Aan de bron-kant
Aan de afnemer-kant
Gedetailleerde documentatie voor deze vier diensten is te vinden in het domein Algemeen. 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, zoals dit document, valt onder het domein van de bron.
Gegevensbronnen
Bronnen registreren of publiceren mutatie notificaties in het MAGDA register. Uitleg over de bronnen en de informatie die ze ontsluiten wordt omschreven in de dienst specifieke pagina's
| Note |
|---|
|
Agentschap Informatie 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:
- Toelating tot het MAGDA platform
Batch
Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.
| Prefix | XXX |
|---|
| Voorbeeld | |
|---|
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
| Anchor |
|---|
opvraging | opvraging | OpvragingResponsetijden & Beschikbaarheid
| Note |
|---|
|
De MAGDA response tijden zijn heel sterk afhankelijk van de response tijden van de bron. Als de brongegevens heel traag worden aangeleverd kan het MAGDA antwoord niet snel worden aangeleverd. |
Logging
De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".
Ondersteunde talenFunctionaliteiten
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 PubliceerMutatieNotificatie 02.01 dienst melding dat een aanpassingis gebeurd aan het dossier van een persoon. De mutatie notificatie bevat de INSZ van het aangepast dossier.
De afnemer vraagt via de GeefPersoon 02.00 dienst het volledige dossier op van de persoon en kan zijn interne database updaten.
| Drawio |
|---|
| baseUrl | https://vlaamseoverheid.atlassian.net/wiki |
|---|
| diagramName | Volledige dienst.xml |
|---|
| contentId | 600507569 |
|---|
| width | 251 |
|---|
| zoom | 1 |
|---|
| pageId | 590709295 |
|---|
| diagramDisplayName | Volledige dienst.xml |
|---|
| lbox | 1 |
|---|
| contentVer | 2 |
|---|
| height | 181 |
|---|
| revision | 2 |
|---|
|
