Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Algemeen.RegistreerMutatieNotificatie-02.01

Informatie:

Voor de ontsluiting van een MAGDA 2.0 webservice, alsook het generieke proces binnen een 2.0 webservice, wordt verwezen naar Werking en gebruik MAGDA 2.0 Webservices.

Situering

De RegistreerMutatieNotificatie 02.01 webservice laat een afnemer toe om een sleutel van verschillend formaat te registreren zodat MutatieNotificaties van deze sleutels worden beschikbaar gesteld via de GeefMutatieNotificatie 02.01 en de PubliceerMutatieNotificatie 02.01 diensten. Deze sleutels kunnen van verschillende aard zijn zoals

  • INSZ

  • Ondernemingsnummer

  • Perceelnummer

Verwante diensten

PubliceerMutatieNotificatie (bron): Deze dienst staat een bron toe om mutaties te publiceren door bestanden aan te leveren op een FTP server.

PubliceerMutatieNotificatie (afnemer): Deze dienst biedt de afnemer de mutaties aan via bestanden op een FTP server.

GeefMutatieNotificatie: Via deze dienst kan een afnemer door een webservice opvragen of er mutaties beschikbaar zijn.

Gegevensbronnen

Er zijn geen specifieke gegevensbronnen van toepassing daar het om een registreerdienst gaat.

Opmerking:

Agentschap Digitaal Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens. 

Gebruiksvoorwaarden

Om gebruikt te kunnen maken van deze dienst dient men een machtiging te hebben die toegang geeft tot deze gegevens en een aansluitingsprocedure te doorlopen.

Informatie:

Meer informatie over deze voorwaarden is terug te vinden op de pagina “Machtigingen en toelatingen”.

Meer informatie over het aansluitingsproces is terug te vinden op deze webpagina.

Batch

Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML).

Hiervoor moet men de Service-XSD gebruiken en niet de Webservice. Door de Service-XSD te gebruiken zijn er meerdere vragen mogelijk in één bestand. De vraag-bestanden worden op de MAGDA FTP geplaatst in een afnemer specifieke folder. De exacte bestandsnamen en de naam van de folder worden meegedeeld tijdens het aansluitingsproces. Deze is steeds onder de vorm Domein.Service-versie_timestamp.extensie.

 Voorbeeld:

  • RegistreerMutNot-0201_20131103115553530.xml

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

Prefix

Algemeen.RegistreerMutatieNotificatie-02.01

Voorbeeld

Algemeen.RegistreerMutatieNotificatie-02.01_20131103115553530

Functionaliteiten

De webservice RegistreerMutatieNotificatie 02.01 laat een gegevensbron toe om via deze weg aan alle geïnteresseerde en gemachtigde afnemers te laten weten dat er een mutatie plaatsgevonden heeft op een gegeven. De mutatie wordt gemeld op basis van een sleutel waaraan de gekoppelde gegevens gewijzigd zijn.

Voorbeelden van “gegevens”:

  • VDAB dossier

  • Studietoelagedossier

  • Kadasterdossier

De geregistreerde mutatienotificaties worden bewaard op het MAGDA platform en op regelmatige tijdstippen verdeeld naar de gemachtigde en geïnteresseerde afnemers. Na verdeling worden de geregistreerde gegevens verwijderd.

Vraag

Als vraag wordt doorgestuurd:

  • Een metadata blok met hierin de mutatiedatum, type mutatie en een unieke mutatiereferte

  • De mutatienotificatie met hierin de sleutel, de aanduiding bij welke bron het gewijzigd is en extra informatie over de wijziging

Antwoord

Als antwoord verkrijgt men een “wel geslaagd” of “niet geslaagd”.

Werking

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

Opvraging

Van zodra de vraag gesteld is wordt er een XSD-validatie uitgevoerd. Is de ontvangen vraag XML niet geldig tegenover het schema, dan stopt de verwerking en wordt een foutmelding aangemaakt, anders gaat de verwerking verder. Na de XSD-validatie vinden de nodige authenticatie- en autorisatiecontroles plaats. Waar mogelijk wordt een validatie gedaan op de structuur en het controlegetal van de sleutel. Zo wordt een modulus-97 validatie gedaan op een INSZ of ondernemingsnummer.

Daarna gebeurt er een controle op de gegevens om te kijken of de gegevens al dan niet aanwezig zijn in de registers.

Het antwoord wordt gevalideerd tegenover de XSD waarna het aan de afnemer ter beschikking gesteld wordt.

Responsetijden & Beschikbaarheid

Responsetijden tussen de 500ms en 10 seconden worden als normaal beschouwd.

Logging

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

Ondersteunde talen

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.

Op deze pagina


Binnen deze handleiding


Omgevingsinformatie

Domein

Algemeen

Classificatie

Persoonsgegevens


Verwante diensten







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