Element

Beschrijving

V/O

Opmerkingen

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie procedure OO

V

Formaat: jjjj-mm-ddTHH:MM:SS.sss

Voor de actie BewaarProcedureCa ontbreekt in de XSD bij Verzoek het veld TijdstipLaatstGewijzigd. Daarom is geöpteerd om bij Verzoek steeds update te doen van het veld TijdstipLaatstGewijzigd van BewaarProcedureOo/Ca. Dat maakt dat bij de actie BewaarProcedureOo 2x een update gebeurt.

Referte

Unieke referte per procedure OO

V

RedenAfwijzing

O

Wijzigen van verzoek, entiteit of onderzoek niet mogelijk in BewaarProcedureOo of BewaarProcedureCa bij afgewezen/stopgezette procedure (status Gestopt), enkel nog aanpassing mogelijk van de velden RedenAfwijzing of DatumAfwijzing, en dien je geen rekening meer te houden met de rest van de gegevens in het XML-bericht.  Je dient wel RedenAfwijzing EN DatumAfwijzing allebei in te vullen, anders foutmelding.

Als je één van de velden RedenAfwijzing of DatumAfwijzing invult in BewaarProcedureOo of BewaarProcedureCa bij status Gestart, dan komt de foutmelding “Kan RedenAfwijzing/DatumAfwijzing niet wijzigen wanneer de procedure niet is stopgezet of afgewezen". Je dient voor het afwijzen/stopzetten van een procedure de speciale actie WijsProcedureOoAf of WijsProcedureCaAf te gebruiken. Wel kan je de velden RedenAfwijzing in BewaarProcedureOo of BewaarProcedureCa nog wijzigen na afwijzing/stopzetting.

Omschrijving + Code

NietAangetekend = 1

NietGemotiveerd = 2

Ongegrond = 3

FoutieveRegistratie = 4

GebrekenWeggewerkt = 5

OpVraagVanBewoner = 6

GeenToegang = 7

(V)

DatumAfwijzing

O

Formaat: jjjj-mm-dd

Verzoek

O

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie verzoek

(V)

Formaat: jjjj-mm-ddTHH:MM:SS.sss

Voor de actie BewaarProcedureCa ontbreekt in de XSD bij Verzoek het veld TijdstipLaatstGewijzigd. Daarom is geöpteerd om bij Verzoek steeds update te doen van het veld TijdstipLaatstGewijzigd van BewaarProcedureOo/Ca. Dat maakt dat bij de actie BewaarProcedureOo 2x een update gebeurt.

Datum

(V)

Formaat: jjjj-mm-dd

Dienst

O

Verzoekers zijn niet mogelijk bij een procedure OO gestart via verzoek dienst.

Omschrijving + Code

Burgemeester = 11

Ocmw = 12

Politie = 13

Shm = 14

AndereDienst = 15

(V)

Belanghebbende

O

Omschrijving + Code

Bewoner = 1

Hzr = 2

Syndicus = 3

Buur = 4

Advocaat = 5

Huurdersbond = 6       BegeleiderFamilieVanDe Bewoner = 7       BegeleiderFamilieVanDeHzr = 8

Vrederechter = 9

Andere = 10

(V)

Medium

O

Omschrijving + Code

AangetekendeBrief = 1

GewoneBrief = 2

Mondeling = 3

Mail = 4       MeldingViaElektronisch Loket = 5

(V)

TeOnderzoeken

(V)

Omschrijving + Code

Eengezinswoning = 1       GebouwMetMeerdere Entiteiten = 2       GebouwMetGekoppelde Entiteiten = 3

Onbekend = 4

(V)

VolledigPand

(V)

Boolean

BeschrijvingTeOnderzoeken Woning

O

Risicos

O

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie risico

O

Formaat: jjjj-mm-ddTHH:MM:SS.sss

Verwijder

Verwijdervlag risico

(V)

Boolean

Verwijderen risico indien TijdstipLaatstGewijzigd, Verwijder = 1, Type

Type

(V)

Omschrijving + Code

VerluchtingRisicoLiving = 1      VerluchtingRisicoKeuken = 2         VerluchtingRisicoBadkamer = 3         VerluchtingRisico Slaapkamer = 4         DakRisicoDakBuigtDoor = 11

DakRisicoDraagstructuur Aangepast = 12         DakRisicoDakpannen OntbrekenOfLos = 13         DakRisicoSchouwOnstabiel = 14         DakRisicoRegentBinnen = 15         DakRisicoDakgootHangt = 16       DvtRisicoRaamNietRegenEn WindDicht = 21         DvtRisicoBuitendeurenRot = 22        DvtRisicoRamenRot = 23         DvtRisicoOnmogelijkTe Openen = 24         DvtRisicoTrappenGevaarlijk = 25         DvtRisicoRuitenStuk = 26            ElektrischRisico ElektriciteitValtUit = 31

ElektrischRisico ZekeringskastOntmanteld = 32       

ElektrischRisico StopcontactenUitMuur = 33

ElektrischRisicoOntbreken Afdekplaatjes = 34 ElektrischRisicoGeen Verliesstroomschakelaar = 35    ElektrischRisicoTeWeinig Stroomkringen = 36

ElektrischRisico

SmeltveilighedenNiet Voorzien = 37        ElektrischRisicoAndere Reden = 38

GasRisicoGasgeur = 41        GasRisicoGasgeiserMet OpenVerbrandingskamer = 42        GasRisicoGasgeiserZonder Schouw = 43 GasRisicoGasgeiserMet Rookgasafvoer = 44        GasRisicoGaskachelMetOpen Verbrandingskamer = 45

GasRisicoAfvoerRookgassen = 46      GasRisicoAndereReden = 47      TechnischRisicoStookolie InstallatieOnveilig = 51        TechnischRisicoBoiler Defect = 52        TechnischRisicoWoning

Brandonveilig = 53        TechnischRisicoHoofdkraan KanNietAfgeslotenWorden = 54       

TechnischRisico ElektriciteitKanNiet AfgeslotenWorden = 55     

SanitairRisicoBadkamer = 61        SanitairRisicoGeen BruikbareDoucheOfBad = 62  SanitairRisicoGeen BruikbareWc = 63        MuurRisicoScheuren = 71        MuurRisicoVloerBuigtDoor = 72        MuurRisicoVochtplekken = 73

MuurRisicoSchimmel = 74        MuurRisicoGevelSlecht Bevestigd = 75        MuurRisicoKelderOnderWater = 76        MuurRisicoZwamvormingIn Kelder = 77        MuurRisicoLoskomend Pleisterwerk = 78        AndereRisicoOngedierte = 81

AndereRisicoGeenGootsteen MetReukafsnijder = 82        AndereRisicoGeenWarmWater InKeuken = 83

AndereRisicoAndereReden = 84

AndereRisicoEnkele

Beglazing = 85

AndereRisicoVerplichte

RookmeldersOntbreken = 86

AndereRisicoSchimmel

vorming = 87

AndereRisicoOntbreken

Dakisolatie = 88

(V)

BeschrijvingAndere

BeschrijvingAndere indien risico = andere reden (84) 

Verzoekers

O

Verzoekers zijn mogelijk bij procedures (niet bij pand/entiteit), maar zonder betrokkenheid of rol. Verzoekers kunnen ook betrokkene of correspondent zijn. Buren zijn verzoekers.

Voor derden (verzoeker, belangh, indiener, correspondent) RR-nr of KBO-nr ofwel naam + voornaam + correspondentieadres indien geen RR-nr of KBO-nr bekend (NAI). Bij correspondent is het mogelijk dat enkel naam opgegeven wordt (NAI).

Verzoekers kunnen enkel gekoppeld worden aan procedures (OO en CA).

Bij een procedure OO kan een verzoeker worden doorgegeven via referte/RR/KBO/NAI.

Verplichte info bij nieuwe verzoeker voor procedure OO:

- Als we de verzoeker of indiener kennen met RRnummer of KBOnummer (bvb als HZR) dan geven we volgende gegevens door: RR/KBO (verplicht)

- Ofwel indien geen RRnummer of KBOnummer bekend, kan een niet authentieke identificatie (NAI) worden doorgegeven. Deze bestaat uit minstens: Naam, Correspondentieadres

- Het is ook mogelijk een referte NAI door te geven via de referte uit Vlok (ENKEL indien niet gekoppeld met RR/KBO !)

Om een verzoeker aan te passen is de referte en TijdstipLaatst Gewijzigd nodig. Volgende informatie kan dan aangepast worden: Naam, Voornaam, Correspondentieadres, E-mail, Telefoonnummer, Telefoonnummer2, Rollen ten opzichte van verzoeker.

Je kunt altijd een persoon toevoegen met RR/KBO bij pand, entiteit of procedure. Als je RR/KBO niet weet, dan naam/voornaam/correspondentie adres. Bij nieuwe verzoeker voor procedure moet je ofwel RR/KBO ofwel naam/voornaam/ correspondentieadres doorgeven. Als antwoord krijg je een referte persoon + TijdstipLaatstGewijzigd terug. Van dan af kun je een 2de XML-bericht opstarten met referte persoon + TijdstipLaatstGewijzigd en dan wijzigen en verwijderen van extra gegevens zoals correspondentieadres, tel/tel2/mail.

Identificatie

(V)

Het is niet mogelijk om RR en KBO en NAI tegelijk door te geven voor 1 (één) persoon.

Het veld Identificatie gebruikt bij Verzoeker of Correspondent is een VERPLICHT veld met RR/KBO of NAI (met of zonder ref persoon). Het veld Referte persoon (niet in NAI) is dus niet voldoende voor wijzigen of verwijderen van persoon. Indien er verschillende identificaties zijn opgegeven, dan foutmelding op het veld Identificatie (slechts 1 child element mogelijk).

We spreken over een authentieke identificatie wanneer een RR- of KBO-nummer gekend is.

INSZ

RR verzoeker

(V)

Ondernemingsnummer

RR verzoeker

Ondernemingsnr of vestigingseenheidsnr

NietAuthentieke Identificatie

Een niet authentieke identificatie (NAI) bevat minstens een naam en een correspondentieadres.

Omdat het momenteel niet mogelijk is om bij een NAI het type persoon mee te geven, is besloten dat bij deze ingave het steeds een natuurlijk persoon betreft. Dit wordt automatisch zo weggeschreven in de VLOK databank.

Bij verzoekers moet je wel direct correspondentieadres meegeven als je geen RR/KBO kent. Dan kan in VLOK Online opgezocht worden of die persoon reeds een referte heeft of een nieuwe referte moet krijgen.

Als in VLOK een persoon wordt gevonden met dezelfde naam, voornaam en adres (domicilieadres indien RR/KBO, correspondentieadres bij NAI), wordt aangenomen dat het om dezelfde persoon gaat en wordt deze persoon gekoppeld. Als we een lijst met gelijke personen vinden, kiezen we het eerste resultaat – de lijst wordt gesorteerd op referte (nieuwste eerst). Indien er een persoon met RR in de lijst aanwezig is, dan wordt deze persoon gekozen.

Referte

Unieke referte per persoon

(O)

Referte van gekoppelde verzoeker met NAI.

Naam

(V)

Voornaam

(O)

Correspondentieadres

Generiek adrestype uit adressenregister (met eigen entiteitsnr + VlokID)

(V)

Correspondentieadres mogelijk indien NAI (niet authentieke identificatie), en mag NIET leeg zijn bij nieuwe verzoeker, anders geen identificatie van persoon mogelijk in VLOK.

Een adres kan ofwel als CRABadres ofwel als vrije ingave weergegeven worden.

Een adres kan voorkomen als een CRABadres vanaf CRABcode straat. Indien enkel de CRABcode van de gemeente gekend is, beschouwen we dit als ‘vrije ingave’.

We houden enkel rekening met de CRABcode van het laagste niveau dat we vinden in de XML. Op basis van die code zoeken we de overeenkomende adresgegevens op. Extra info  in de bovenliggende velden negeren we. Onderliggende gegevens in tekst worden gewoon overgenomen. Indien voor een object de CRABcode en een teksttag wordt meegestuurd, houden we enkel rekening met de CRABcode.

Bijvoorbeeld CRAB-code van huisnummer is gekend als laagste CRABniveau. De gemeente geeft het volgende door:

- Huisnummer met CRABcode (verplicht)

- Busnummer met Busnummertag (optioneel)

We zoeken op basis van de CRABcode van de huisnummer het adres op. Het busnummer bewaren we in de VLOK databank zonder CRABcode

Bijvoorbeeld CRAB-code van straat is gekend als laagste CRABniveau. De gemeente geeft het volgende door:

- Postcode met Postcodetag (verplicht)

- Straatobject met CRABcode

- Huisnummer met Huisnummertag (verplicht)

- Busnumme met Busnummertag (optioneel)

We zoeken op basis van de CRABcode van de straat het adres op. Het huisnummer en busnummer bewaren we in de VLOK databank zonder CRABcode.

Bij een adres met vrije ingave  zijn alle velden behalve busnummer en land verplicht in te vullen:

- Landobject met NIScodetag verplicht indien bij het gemeenteobject geen CRABcode of NIScode wordt meegegeven. Indien bij het gemeenteobject een CRABcode of NIScode wordt meegegeven, wordt automatisch het land België weggeschreven. We doen in dat geval geen controle op dit veld.

- Gemeenteobject met CRABcode, NIScode of Gemeentenaam. Indien verschillende tags ingevuld werden, houden we enkel rekening met 1 veld in deze volgorde. (verplicht)

- Postcodeobject met Postcodetag (verplicht indien land = België)

- Straatobject  met Straattag (verplicht indien land = België)

- Huisnummerobject met Huisnummertag (verplicht indien land = België)

- Busnummerobject met Busnummertag (optioneel)

VlokId

(V)

VlokID wordt meegegeven voor update correspondentieadres. Geen VlokID = nieuw correspondentieadres.

Check op bestaand VlokID in VLOK (bij deze bestaande persoon!).

Indien geen invulling van VlokID met VlokAdres (= weglaten van adres persoon), dan blijft alles ongewijzigd qua correspondentieadres.

Indien geen invulling van VlokID, en wel invulling van VlokAdres, dan toevoeging van correspondentieadres (slechts 1 (één) correspondentieadres mogelijk per persoon).

Indien wel invulling van VlokID en VlokAdres, dan wijziging van bestaand adres gekoppeld aan VlokID.

VlokAdres

(V)

Verplichte invoer:

- Huisnummer of Busnummer indien CRABingave

- Postcode, Straat, Huisnummer voor Belgisch adres indien vrije ingave

- Gemeente (+ Land) voor niet-Belgisch adres indien vrije ingave

AdresObjectId

NVT

Uitfasering CRAB en migratie naar Gebouwen- en Adressenregister op basis van AdresObjectID vanaf 01/12/2023.

Geen rekening houden wegens CRABstandaard, dus ook niet verwerken of tonen. Wordt genegeerd indien het meegegeven wordt.

Land

O

Bij vrije ingave is NIScodetag voor land verplicht indien bij het gemeenteobject geen CRABcode of NIScode wordt meegegeven.

ISOCode

Zie ISO-codes van land

(V)

NISCode

Zie NIS-codes van land

Naam

Naam van land

Gemeente

O

Bij vrije ingave is CRABcode, NIScode of Gemeentenaam voor gemeente verplicht. Indien verschillende tags ingevuld werden, houden we enkel rekening met 1 veld in deze volgorde.

Indien bij het gemeenteobject een CRABcode of NIScode wordt meegegeven, wordt automatisch het land België weggeschreven. We doen in dat geval geen controle op dit veld.

NISCode

(V)

Zie NIS-codes van gemeente

CrabCode

Zie CRAB-adressenregister

Gemeente naam

Naam van gemeente

Postcode

O

Bij vrije ingave is postcodetag verplicht indien land = België.

CrabCode

(V)

Geen Crabcodes voor postcode.

Postcode

Straat

O

Bij vrije ingave is straattag verplicht indien land = België.

CrabCode

Zie CRAB-adressenregister

(V)

Straatnaam

Huisnummer

(V)

Bij vrije ingave is huisnummertag verplicht indien land = België.

Mogelijks geen huisnummer bij vrije ingave van buitenlands correspondentieadres voor persoon.

CrabCode

Zie CRAB-adressenregister

(V)

Huisnummer

Busnummer

O

CrabCode

Zie CRAB-adressenregister

(V)

Busnummer

EigenNummer

NVT

Geen EigenNummer mogelijk voor adres persoon.

TijdstipLaatst Gewijzigd

Datum en tijdstip van mutatie adres

O

Formaat: jjjj-mm-ddTHH:MM:SS.sss

Verwijder

Verwijdervlag correspondentieadres

(V)

Boolean

Verwijderen correspondentieadres indien VlokID, Verwijder = 1, TijdstipLaatstGewijzigd

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie persoon

O

Formaat: jjjj-mm-ddTHH:MM:SS.sss

Referte

Unieke referte per persoon

Referte van gekoppelde verzoeker met RR/KBO/NAI.

Indien RR/KBO én referte meegegeven wordt, moeten beide waarden over dezelfde persoon handelen.

Indien de referte bij NAI én de referte persoon bij tel/tel2/mail meegegeven wordt, moeten beide waarden over dezelfde persoon handelen.

Het wijzigen van een persoon is enkel mogelijk indien een referte en TijdstipLaatstGewijzigd wordt doorgegeven. Het betreft dus de velden Naam, Voornaam, Correspondentieadres, Tel/Tel2/Mail bij Verzoeker of Correspondent. Er wordt afgesproken dat bij NAI steeds referte persoon (NAI) en referte persoon bij tel/tel2/mail dienen opgegeven te zijn voor het wijzigen van een persoon. Immers kan een persoon zonder referte bij NAI reeds aanwezig zijn in VLOK Online, doch bij webservices kan er geen tussenliggend antwoord worden overgemaakt om te vergelijken met de referte persoon bij tel/tel2/mail.

Telefoon

O

Telefoon2

O

Email

O

Entiteiten

O

Enkel bestaande entiteiten van pand kunnen gekoppeld worden.

Verwijder

Verwijdervlag entiteit

(V)

Boolean

Verwijderen entiteit indien Verwijder = 1, Referte entiteit

Referte

Unieke referte per entiteit

(V)

GebouwEenheidId

Zie gebouwenregister

O

Geen rekening houden met opgegeven waarde wegens geen uniciteit, wel op basis van referte.

We gebruiken ENKEL de meegegeven referte pand/entiteit in het XML-bericht. Dit is (voorlopig) zo ingesteld omdat voor de bepaling van woonentiteiten in VLOK er nog steeds dubbels zitten in het GebouwenRegister met GebouwID/GebouwEenheidID. Vanaf de mogelijkheid tot uniciteit in het kader van de koppeling met het GebouwenRegister, zal er overgeschakeld worden naar het gebruik van GebouwID/GebouwEenheidID als referte binnen VLOK.

Onderzoeken

O

Enkel bestaande onderzoeken van pand kunnen gekoppeld worden.

Onderzoeken niet ouder dan 6 maand.

Verwijder

Verwijdervlag onderzoek

(V)

Boolean

Verwijderen onderzoek indien Verwijder = 1, Referte onderzoek

Referte

Unieke referte per onderzoek

(V)

Element

Beschrijving

V/O

Opmerkingen

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie procedure CA

V

Formaat: jjjj-mm-ddTHH:MM:SS.sss

Voor de actie BewaarProcedureCa ontbreekt in de XSD bij Verzoek het veld TijdstipLaatstGewijzigd. Daarom is geöpteerd om bij Verzoek steeds update te doen van het veld TijdstipLaatstGewijzigd van BewaarProcedureOo/Ca. Dat maakt dat bij de actie BewaarProcedureOo 2x een update gebeurt.

Referte

Unieke referte per procedure CA

V

RedenAfwijzing

O

Wijzigen van verzoek, entiteit of onderzoek niet mogelijk in BewaarProcedureOo of BewaarProcedureCa bij afgewezen/stopgezette procedure (status Gestopt), enkel nog aanpassing mogelijk van de velden RedenAfwijzing of DatumAfwijzing, en dien je geen rekening meer te houden met de rest van de gegevens in het XML-bericht.  Je dient wel RedenAfwijzing EN DatumAfwijzing allebei in te vullen, anders foutmelding.

Als je één van de velden RedenAfwijzing of DatumAfwijzing invult in BewaarProcedureOo of BewaarProcedureCa bij status Gestart, dan komt de foutmelding “Kan RedenAfwijzing/DatumAfwijzing niet wijzigen wanneer de procedure niet is stopgezet of afgewezen". Je dient voor het afwijzen/stopzetten van een procedure de speciale actie WijsProcedureOoAf of WijsProcedureCaAf te gebruiken. Wel kan je de velden RedenAfwijzing in BewaarProcedureOo of BewaarProcedureCa nog wijzigen na afwijzing/stopzetting.

Omschrijving + Code

Onvolledig = 1

FoutieveRegistratie = 2        OpVraagVanAanvrager = 3

CaAfgeleverdDoor

Burgemeester = 4

NietOntvankelijk = 5

ToegangTweeMaalGeweigerd = 6

ToegangGeweigerd = 7

BeslissingAndereProcedure = 8

(V)

De redenen CAAfgeleverdDoorBurgemeester, NietOntvankelijk, en ToegangGeweigerd worden niet toegestaan voor ProcedureCa

DatumAfwijzing

O

Formaat: jjjj-mm-dd

Verzoek

O

DatumVerzoek

(V)

Formaat: jjjj-mm-dd

DatumVolledig

(V)

Formaat: jjjj-mm-dd

Aanpassing van DatumVolledig onder Verzoek in BewaarProcedureCa is niet meer mogelijk (wegens opstarten van acties en taken), zodoende éénmaal ingevuld niet meer te wijzigen !

RedenAanvraag

(V)

Omschrijving + Code

OpheffingBesluit = 1

VrijwilligeBasis = 2

VerordeningVerplichtCa = 3

NieuweInhuurnameSvk = 4

VergunningArbeidskrachten = 5

(V)

NieuweInhuurnameSvk is eigenlijk nu voor woonmaatschappijen bedoeld.

MeegestuurdeDocumenten

O

Het veld MeegestuurdeDocumenten is geen verplicht veld binnen Verzoek in XSD, doch vanuit VLOK Online zal een foutmelding komen dat je toch dit veld dient mee te geven, desnoods met alle Booleans op false.

AfschriftAttestBrandweer

(V)

Boolean

AfschriftAttestElektrisch

(V)

Boolean

SchemaGebouw

(V)

Boolean

AfschriftAttestGas

(V)

Boolean

SchemaWoning

(V)

Boolean

BewijsVanIndiening

(V)

Boolean

Ontvangstbewijs Burgemeester

(V)

Boolean

BeslissingBurgemeester

(V)

Boolean

Verzoekers

O

Verzoekers zijn mogelijk bij procedures (niet bij pand/entiteit), maar zonder betrokkenheid of rol. Verzoekers kunnen ook betrokkene of correspondent zijn. Buren zijn verzoekers.

Voor derden (verzoeker, belangh, indiener, correspondent) RR-nr of KBO-nr ofwel naam + voornaam + correspondentieadres indien geen RR-nr of KBO-nr bekend (NAI). Bij correspondent is het mogelijk dat enkel naam opgegeven wordt (NAI).

Verzoekers kunnen enkel gekoppeld worden aan procedures (OO en CA).

Bij een procedure CA kunnen enkel verzoekers toegevoegd worden die als betrokkene gekend zijn op het pand of entiteit.

Verplichte info bij nieuwe verzoeker voor procedure CA:

- Bij verzoekers CA is het enkel mogelijk om betrokkenen van het pand of entiteit als verzoeker mee te geven. In de praktijk zal het dan ook weinig voorkomen om via NAI nieuwe verzoekers (gekoppeld aan pand/entiteit) door te geven, vermits deze ook een RR/KBO hebben.

- Als we de verzoeker of indiener kennen met RRnummer of KBOnummer (bvb als HZR) dan geven we volgende gegevens door: RR/KBO (verplicht)

- Ofwel indien geen RRnummer of KBOnummer bekend, kan een niet authentieke identificatie (NAI) worden doorgegeven. Deze bestaat uit minstens: Naam, Correspondentieadres

- Volgende rollen van het pand/entiteit kunnen verzoekers bij procedure CA zijn: VolleEigenaar, Vruchtgebruiker, Opstalhouder, Erfpachter, Verhuurder, Bewoner (alleen indien reden aanvraag CA = OpheffingBesluit).

Om een verzoeker aan te passen is de referte en TijdstipLaatst Gewijzigd nodig. Volgende informatie kan dan aangepast worden: Naam, Voornaam, Correspondentieadres, E-mail, Telefoonnummer, Telefoonnummer2, Rollen ten opzichte van verzoeker.

Je kunt altijd een persoon toevoegen met RR/KBO bij pand, entiteit of procedure. Als je RR/KBO niet weet, dan naam/voornaam/correspondentie adres. Bij nieuwe verzoeker voor procedure moet je ofwel RR/KBO ofwel naam/voornaam/ correspondentieadres doorgeven. Als antwoord krijg je een referte persoon + TijdstipLaatstGewijzigd terug. Van dan af kun je een 2de XML-bericht opstarten met referte persoon + TijdstipLaatstGewijzigd en dan wijzigen en verwijderen van extra gegevens zoals naam, voornaam, correspondentieadres, tel/tel2/mail.

OPGELET: verzoekers bij procedure CA zijn enkel toegestaan met rollen van VolleEigenaar, Vruchtgebruiker, Opstalhouder, Erfpachter, Verhuurder (en Bewoner indien reden opheffing besluit). Dat maakt dat deze verzoekers steeds als betrokkene gekend zijn op het pand of entiteit. Voor een nieuwe verzoeker bij procedure CA kan de gemeente dus steeds een RR/KBO doorgeven. In de praktijk zal het dan ook weinig voorkomen dat nieuwe verzoekers via NAI (zonder referte dus) worden doorgegeven.

Identificatie

(V)

Het is niet mogelijk om RR en KBO en NAI tegelijk door te geven voor 1 (één) persoon.

Het veld Identificatie gebruikt bij Verzoeker of Correspondent is een VERPLICHT veld met RR/KBO of NAI (met of zonder ref persoon). Het veld Referte persoon (niet in NAI) is dus niet voldoende voor wijzigen of verwijderen van persoon. Indien er verschillende identificaties zijn opgegeven, dan foutmelding op het veld Identificatie (slechts 1 child element mogelijk).

We spreken over een authentieke identificatie wanneer een RR- of KBO-nummer gekend is.

INSZ

RR verzoeker

(V)

Ondernemingsnummer

KBO verzoeker

Ondernemingsnr of vestigingseenheidsnr

NietAuthentieke Identificatie

Een niet authentieke identificatie (NAI) bevat minstens een naam en een correspondentieadres.

Omdat het momenteel niet mogelijk is om bij een NAI het type persoon mee te geven, is besloten dat bij deze ingave het steeds een natuurlijk persoon betreft. Dit wordt automatisch zo weggeschreven in de VLOK databank.

Bij verzoekers moet je wel direct correspondentieadres meegeven als je geen RR/KBO kent. Dan kan in VLOK Online opgezocht worden of die persoon reeds een referte heeft of een nieuwe referte moet krijgen.

Als in VLOK een persoon wordt gevonden met dezelfde naam, voornaam en adres (domicilieadres indien RR/KBO, correspondentieadres bij NAI), wordt aangenomen dat het om dezelfde persoon gaat en wordt deze persoon gekoppeld. Als we een lijst met gelijke personen vinden, kiezen we het eerste resultaat – de lijst wordt gesorteerd op referte (nieuwste eerst). Indien er een persoon met RR in de lijst aanwezig is, dan wordt deze persoon gekozen.

Referte

Unieke referte per persoon

(O)

Referte van gekoppelde verzoeker met NAI.

Naam

(V)

Voornaam

(O)

Correspondentieadres

Generiek adrestype uit adressenregister (met eigen entiteitsnr + VlokID)

(V)

Correspondentieadres mogelijk indien NAI (niet authentieke identificatie), en mag NIET leeg zijn bij nieuwe verzoeker, anders geen identificatie van persoon mogelijk in VLOK.

Een adres kan ofwel als CRABadres ofwel als vrije ingave weergegeven worden.

Een adres kan voorkomen als een CRABadres vanaf CRABcode straat. Indien enkel de CRABcode van de gemeente gekend is, beschouwen we dit als ‘vrije ingave’.

We houden enkel rekening met de CRABcode van het laagste niveau dat we vinden in de XML. Op basis van die code zoeken we de overeenkomende adresgegevens op. Extra info  in de bovenliggende velden negeren we. Onderliggende gegevens in tekst worden gewoon overgenomen. Indien voor een object de CRABcode en een teksttag wordt meegestuurd, houden we enkel rekening met de CRABcode.

Bijvoorbeeld CRAB-code van huisnummer is gekend als laagste CRABniveau. De gemeente geeft het volgende door:

- Huisnummer met CRABcode (verplicht)

- Busnummer met Busnummertag (optioneel)

We zoeken op basis van de CRABcode van de huisnummer het adres op. Het busnummer bewaren we in de VLOK databank zonder CRABcode

Bijvoorbeeld CRAB-code van straat is gekend als laagste CRABniveau. De gemeente geeft het volgende door:

- Postcode met Postcodetag (verplicht)

- Straatobject met CRABcode

- Huisnummer met Huisnummertag (verplicht)

- Busnumme met Busnummertag (optioneel)

We zoeken op basis van de CRABcode van de straat het adres op. Het huisnummer en busnummer bewaren we in de VLOK databank zonder CRABcode.

Bij een adres met vrije ingave  zijn alle velden behalve busnummer en land verplicht in te vullen:

- Landobject met NIScodetag verplicht indien bij het gemeenteobject geen CRABcode of NIScode wordt meegegeven. Indien bij het gemeenteobject een CRABcode of NIScode wordt meegegeven, wordt automatisch het land België weggeschreven. We doen in dat geval geen controle op dit veld.

- Gemeenteobject met CRABcode, NIScode of Gemeentenaam. Indien verschillende tags ingevuld werden, houden we enkel rekening met 1 veld in deze volgorde. (verplicht)

- Postcodeobject met Postcodetag (verplicht indien land = België)

- Straatobject  met Straattag (verplicht indien land = België)

- Huisnummerobject met Huisnummertag (verplicht indien land = België)

- Busnummerobject met Busnummertag (optioneel)

VlokId

(V)

VlokID wordt meegegeven voor update correspondentieadres. Geen VlokID = nieuw correspondentieadres.

Check op bestaand VlokID in VLOK (bij deze bestaande persoon!).

Indien geen invulling van VlokID met VlokAdres (= weglaten van adres persoon), dan blijft alles ongewijzigd qua correspondentieadres.

Indien geen invulling van VlokID, en wel invulling van VlokAdres, dan toevoeging van correspondentieadres (slechts 1 (één) correspondentieadres mogelijk per persoon).

Indien wel invulling van VlokID en VlokAdres, dan wijziging van bestaand adres gekoppeld aan VlokID.

VlokAdres

(V)

Verplichte invoer:

- Huisnummer of Busnummer indien CRABingave

- Postcode, Straat, Huisnummer voor Belgisch adres indien vrije ingave

- Gemeente (+ Land) voor niet-Belgisch adres indien vrije ingave

AdresObjectId

NVT

Uitfasering CRAB en migratie naar Gebouwen- en Adressenregister op basis van AdresObjectID vanaf 01/12/2023.

Geen rekening houden wegens CRABstandaard, dus ook niet verwerken of tonen. Wordt genegeerd indien het meegegeven wordt.

Land

O

Bij vrije ingave is NIScodetag voor land verplicht indien bij het gemeenteobject geen CRABcode of NIScode wordt meegegeven.

ISOCode

Zie ISO-codes van land

(V)

NISCode

Zie NIS-codes van land

Naam

Naam van land

Gemeente

O

Bij vrije ingave is CRABcode, NIScode of Gemeentenaam voor gemeente verplicht. Indien verschillende tags ingevuld werden, houden we enkel rekening met 1 veld in deze volgorde.

Indien bij het gemeenteobject een CRABcode of NIScode wordt meegegeven, wordt automatisch het land België weggeschreven. We doen in dat geval geen controle op dit veld.

NISCode

Zie NIS-codes van gemeente

(V)

CrabCode

Zie CRAB-adressenregister

Gemeente naam

Naam van gemeente

Postcode

O

Bij vrije ingave is postcodetag verplicht indien land = België.

CrabCode

(V)

Geen Crabcodes voor postcode.

Postcode

Straat

O

Bij vrije ingave is straattag verplicht indien land = België.

CrabCode

Zie CRAB-adressenregister

(V)

Straatnaam

Huisnummer

(V)

Bij vrije ingave is huisnummertag verplicht indien land = België.

Mogelijks geen huisnummer bij vrije ingave van buitenlands correspondentieadres voor persoon.

CrabCode

Zie CRAB-adressenregister

(V)

Huisnummer

Busnummer

O

CrabCode

Zie CRAB-adressenregister

(V)

Busnummer

EigenNummer

NVT

Geen EigenNummer mogelijk voor adres persoon.

TijdstipLaatst Gewijzigd

Datum en tijdstip van mutatie adres

O

Formaat: jjjj-mm-ddTHH:MM:SS.sss

Verwijder

Verwijdervlag correspondentieadres

(V)

Boolean

Verwijderen correspondentieadres indien VlokID, Verwijder = 1, TijdstipLaatstGewijzigd

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie persoon

O

Formaat: jjjj-mm-ddTHH:MM:SS.sss

Referte

Unieke referte per persoon

O

Referte van gekoppelde verzoeker met RR/KBO/NAI.

Indien RR/KBO én referte meegegeven wordt, moeten beide waarden over dezelfde persoon handelen.

Indien de referte bij NAI én de referte persoon bij tel/tel2/mail meegegeven wordt, moeten beide waarden over dezelfde persoon handelen.

Het wijzigen van een persoon is enkel mogelijk indien een referte en TijdstipLaatstGewijzigd wordt doorgegeven. Het betreft dus de velden Naam, Voornaam, Correspondentieadres, Tel/Tel2/Mail bij Verzoeker of Correspondent. Er wordt afgesproken dat bij NAI steeds referte persoon (NAI) en referte persoon bij tel/tel2/mail dienen opgegeven te zijn voor het wijzigen van een persoon. Immers kan een persoon zonder referte bij NAI reeds aanwezig zijn in VLOK Online, doch bij webservices kan er geen tussenliggend antwoord worden overgemaakt om te vergelijken met de referte persoon bij tel/tel2/mail.

Telefoon

O

Telefoon2

O

Email

O

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie verzoek

(V)

Formaat: jjjj-mm-ddTHH:MM:SS.sss

Voor de actie BewaarProcedureCa ontbreekt in de XSD bij Verzoek het veld TijdstipLaatstGewijzigd. Daarom is geöpteerd om bij Verzoek steeds update te doen van het veld TijdstipLaatstGewijzigd van BewaarProcedureOo/Ca. Dat maakt dat bij de actie BewaarProcedureOo 2x een update gebeurt.

Entiteiten

O

Enkel bestaande entiteiten van pand kunnen gekoppeld worden.

Verwijder

Verwijdervlag entiteit

(V)

Boolean

Verwijderen entiteit indien Verwijder = 1, Referte entiteit

Referte

Unieke referte per entiteit

(V)

GebouwEenheidId

Zie gebouwenregister

O

Geen rekening houden met opgegeven waarde wegens geen uniciteit, wel op basis van referte.

We gebruiken ENKEL de meegegeven referte pand/entiteit in het XML-bericht. Dit is (voorlopig) zo ingesteld omdat voor de bepaling van woonentiteiten in VLOK er nog steeds dubbels zitten in het GebouwenRegister met GebouwID/GebouwEenheidID. Vanaf de mogelijkheid tot uniciteit in het kader van de koppeling met het GebouwenRegister, zal er overgeschakeld worden naar het gebruik van GebouwID/GebouwEenheidID als referte binnen VLOK.