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

1 Algemeen
2 Bestandsnaam
3 Mapping
4 Parameter waarden
- 4.1 Subject/Type (Sleutels)
- 4.2 Type
- 4.3 Informatie
- 4.4 Bron
- 4.5 Voorbeeld

Binnen deze handleiding

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

MAGDA Gebruikersomgeving

Interface (Vlok.PubliceerMutatieNotificatie-02.01)