Document toolboxDocument toolbox


DIGITAAL VLAANDEREN

Interface (Vlok.PubliceerMutatieNotificatie-02.01)

Informatie:

De CSV bestanden die via FTP beschikbaar worden gesteld aan MARGA dienen te voldoen aan de MAGDA richtlijnen. Zie hieronder voor meer info.

Algemeen

VLOK maakt 1 maal per dag een export aan in een CSV bestand van alle mutaties die gebeurd zijn op hun gegevens. Dit bestand wordt op de MAGDA FTP server geplaatst waar het door MAGDA wordt opgepikt en verwerkt.

Bestandsnaam

Opmerking:

De exacte bestandsnaam wordt pas meegedeeld tijdens het aansluitingsproces. De gegevens die u hier vindt kunnen dus mogelijk wijzigen.

De bestandsnaam is van de vorm prefix_publicatienaam_timestamp.extensie.

Voorbeeld

Vlok_wijzigingen_2018_08_24.csv

Mapping

Gedetailleerde uitleg over de XML structuur is te vinden op de Algemeen.PubliceerMutatieNotificatie-02.01 Interface pagina.

Deze lijst bevat de elementen in het MAGDA formaat die per bron variëren.

MAGDA Element

CSV veld

Verplicht

Omschrijving

Referte

WijzigingReferte

X

Referte van de notificatie, Verplicht element

Subject/Type

ObjectType

X

Naam van de sleutel, Verplicht element

Subject/Sleutel

Referte

X

Waarde van de sleutel, Verplicht element

Soort

Type



Uitgevoerde bewerking op de gegevens gerelateerd aan de sleutel

Tijdstip/Datum

Date(Datum)



Datum van aanmaak of aanpassing. Formaat : jjjj-mm-dd

Tijdstip/Tijd

Time(Datum)



Tijdstip van aanmaak of aanpassing. Fomaat : HH:MM:SS.sss

Bron

Vaste waarde “rwo.vlaanderen.be/vlok



rwo.vlaanderen.be/vlok

Informaties/Informatie

  • "NisCode_" gevolgd door de waarde van het veld NisCode

  • "Organisatie_" gevolgd door de waarde van het veld Organisatie

  • "WijzigingType_" gevolgd door de waarde van het veld WijzigingType



Extra informatie de relevant is voor de mutatie

  • NIS Code

  • Organisatie

  • WijzigingType

De waarde van de parameter wordt voorafgegaan door de naam van de parameter, gevolgd door een underscore. Vb : “NisCode_11002”

Parameter waarden

Subject/Type (Sleutels)

  • Pand

  • Entiteit

  • Onderzoek

  • ProcedureOo

  • ProcedureCa

  • DeelProcedureOo

  • DeelProcedureCa

Type

Het type element wordt door MAGDA gestandaardiseerd. Hieronder is de waarde te vinden die wordt opgegeven door de bron en de waarde die MAGDA doorgeeft aan de afnemer. Deze vertaling wordt gedaan door een Runtime mapping.

Type element bij de bron

Type element naar de afnemer

Created

01

Deleted

03

Updated

02

Informatie

Drie extra parameters worden doorgegeven in het Informaties element.

Parameter

Notatie in Informatie element

NIS Code

“NisCode_” + waarde

Organisatie

“Organisatie_” + waarde

WijzigingType

“WijzigingType_” + waarde

Bron

De naam van de bron is een cruciale sleutel in het verwerken van de gegevens en dient door alle partijen correct worden ingevoerd. De naam van de bron heeft de vorm van een domeinnaam en is steeds genoteerd in kleine letters.

De correcte bronnaam voor VLOK is : rwo.vlaanderen.be/vlok

Voorbeeld

<MutatieNotificatie> <Referte>DOC18-012345</Referte> <Subject> <Type>Pand</Type> <Sleutel>PA18-001234</Sleutel> </Subject> <Soort>Annulatie</Soort> <Tijdstip> <Datum>2018-08-28</Datum> <Tijd>10:31:00.000</Tijd> </Tijdstip> <Bron>rwo.vlaanderen.be/vlok</Bron> <Informaties> <Informatie>NisCode_11002</Informatie> <Informatie>Organisatie_Gemeente</Informatie> <Informatie>WijzigingType_Document</Informatie> </Informaties> </MutatieNotificatie>

Op deze pagina


Binnen deze handleiding


Met vragen kunt u steeds terecht bij de MAGDA Service Desk.

 


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