Element

Beschrijving

V/O

Opmerkingen

Verwijder        

Verwijdervlag pand

V

Boolean

Verwijderen pand indien Verwijder = 1, Referte pand, TijdstipLaatstGewijzigd

Referte

Unieke referte per pand

O

Referte voor update pand. Geen referte = nieuw pand.

Geen aanmaken, wijzigen of verwijderen mogelijk van gesloopt pand.

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie pand

O

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

GebouwId

Zie gebouwenregister

O

Maken/wijzigen GebouwID mogelijk.

Waarde steeds overschreven, bij niet-wijziging wordt dit veld als LEEG overschreven.

Adressen

Generiek adrestype uit adressenregister (met eigen entiteitsnr + VlokID)

O

Pand is uniek op adres + locatie.

Er zijn verschillende adressen en mogelijk per pand/entiteit.

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 adres. Geen VlokID = nieuw adres.

VlokID is niet mogelijk en moet leeg zijn (= nieuw adres) bij nieuw pand/entiteit, vermits nieuw pand/entiteit nog geen adres heeft in VLOK en dus ook geen VlokID.

Check op bestaand VlokID in VLOK (bij dit bestaand pand/entiteit!).

Indien geen invulling van VlokID met VlokAdres (= weglaten van adres pand/entiteit), dan blijft alles ongewijzigd qua adressen.

Indien geen invulling van VlokID, en wel invulling van VlokAdres, dan toevoeging van nieuw adres pand/entiteit bij andere adressen.

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

VlokAdres

(V)

VlokAdres mag NIET leeg zijn bij nieuw pand/entiteit, anders geen adressering bekend in VLOK (minstens 1 adres verplicht, niet mogelijk om het enige adres van pand/entiteit te verwijderen).

Check op uniek VlokAdres.

Panden en entiteiten hebben altijd een Belgisch adres.

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

Gemeentenaam

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ë.

CrabCode

Zie CRAB-adressenregister

(V)

Huisnummer

Busnummer

O

Busnr is niet toegestaan bij vrije ingave van adres pand of entiteit (dus bij geen gerelateerd AdresObjectId uit Gebouwen- en Adressenregister).

CrabCode

Zie CRAB-adressenregister

(V)

Busnummer

EigenNummer

NVT

Geen EigenNummer mogelijk voor adres pand, wel voor adres entiteit. Entiteiten op hetzelfde adres moeten een verschillend busnummer of eigen entiteitsnummer hebben. Busnummer en eigen entiteitsnummer mogen niet samen ingevuld worden.

EigenNummer kan niet worden ingegeven in combinatie met AdresObjectId, dus alleen mogelijk bij vrije ingave van adres entiteit.

Verwijder

Verwijdervlag adres pand

(V)

Boolean

Verwijderen adres pand indien VlokID, Verwijder = 1, TijdstipLaatst Gewijzigd

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie adres

O

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

Capakeys

O

Er zijn verschillende capakeys mogelijk per pand/entiteit.

Update capakey niet mogelijk door ontbreken van unieke referte. Als je de capakey of het veld ToevoegenAanAlleEntiteiten wil updaten, dan dien je eerst capakey te verwijderen en opnieuw toe te voegen.

Bij capakey enkel controle op formaat, niet of de capakey overeenkomt met het adres of zelfs of deze bestaat. Het is de verantwoordelijkheid van de toepassing van de gemeente dat er een correcte capakey wordt meegegeven.

Verwijder

Verwijdervlag capakey

(V)

Boolean

Verwijderen capakey indien Verwijder = 1, TijdstipLaatst Gewijzigd, KadastraleAfdeling, Sectie, Grondnummer

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie capakey

O

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

KadastraleAfdeling

(V)

Omschrijving + Code

(V)

Geen rekening houden met omschrijving daar Kadaster dit veld automatisch invult op basis van code.

Sectie

(V)

Grondnummer

(V)

ToevoegenAanAlleEntiteiten

(V)

Locatie

O

Panden op hetzelfde adres moeten een verschillende locatie hebben.

Beschrijving

O

VerslagBrandweer

O

Omschrijving + Code

Onbekend = 0

NietAanwezig = 1

AanwezigGunstig = 2

AanwezigOngunstig = 3

NietVanToepassing = 4

V

Datum

Datum van verslag brandweer

V

Formaat: jjjj-mm-dd

Datum indien verslagbrandweer = aanwezig gunstig of ongunstig

EpcRWaarde

O

Omschrijving + Code

Onbekend = 0

Ok = 1

NietOkAlg = 2

NietOkNietAlg = 3

Geen = 4

NVT = 999

V

CapakeyNietAutomatisch Bijwerken

V

Boolean

GemeenschappelijkeRuimtes

O

GR hoort bij pand.

Wil men een gemeenschappelijke ruimte GR wijzigen met de webservice BewaarWoningKwaliteit, dan dient hierbij een Referte GR te gebruiken, om te weten over welke GR het gaat.

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie GR

O

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

Referte

Unieke referte per GR

(V)

Referte voor update GR. Geen referte = nieuw GR.

Nummer

(V)

Locatie

O

Verdieping

(V)

Omschrijving + Code

NietVanToepassing = 0

Kelder = 1

Gelijkvloers = 2

Tussen0En1 = 3

EersteVerdieping = 4

Tussen1En2 = 5

TweedeVerdieping = 6

Tussen2En3 = 7

DerdeVerdieping = 8

Tussen3En4 = 9

VierdeVerdieping = 10

Tussen4En5 = 11

VijfdeVerdieping = 12

Tussen5En6 = 13

ZesdeVerdieping = 14

Zolder = 15

Onbekend = 16

Ander = 17

Eengezinswoning = 18

Souterrain = 20

(V)

VerdiepingAndere

O

VerdiepingAndere indien verdieping = ander

Beschrijving

O

Kookhoek

O

Aantal

(V)

Oppervlakte

(V)

ToiletAantal

(V)

WasruimteAantal

(V)

OppervlakteLeefruimte

(V)

Verwijder

Verwijdervlag GR

(V)

Boolean

Verwijderen GR indien Tijdstip LaatstGewijzigd, Referte GR, Verwijder = 1

Betrokkenen

O

Je kunt geen nieuwe betrokkene meer toevoegen bij pand. Vroeger kon een betrokkene ook aan een pand gekoppeld worden, doch dit gaf aanleiding tot misverstanden of deze dan al dan niet standaard aan alle entiteiten waren verbonden. Je krijgt nu bij de BewaarWKW webservice een foutmelding terug bij Betrokkene aan pand. Je kan wel bij een bestaande betrokkene aan een vroeger pand nog gegevens van deze betrokkene wijzigen of verwijderen, en ook nog bestaande rollen wijzigen of verwijderen (niet aanmaken !) van deze betrokkene.

Nieuwe betrokkenen zijn alleen mogelijk bij entiteit (niet bij pand of procedure). Betrokkenen kunnen ook verzoeker of correspondent zijn. Buren zijn verzoekers.

Voor wettelijk betrokkenen (eigenaar, verhuurder, bewoner) alleen RR-nr of KBO-nr (max. gebruik authentieke bronnen) + optionele contactgegevens (email, telefoon, telefoon2) + aanvulling met correspondentieadres (voor familie, vertrouwenspersoon).

Een betrokkene heeft ALTIJD een RR of KBO.

Betrokkenen kunnen enkel gekoppeld worden aan een entiteit (niet aan pand of procedure).

Betrokkenen worden ENKEL doorgegeven via KBO/RR/referte.

Verplichte info bij een nieuwe betrokkene: RR/KBO/(referte), Betrokkenheid (rolinfo).

Om een betrokkene aan te passen is de referte en TijdstipLaatstGewijzigd nodig. Volgende informatie kan dan aangepast worden: Type (wordt momenteel achterliggend niets mee gedaan, kan bovendien afgeleid worden), Actief, Correspondentieadres, E-mail, Telefoon, Telefoon2, Betrokkenheid, Contactpersonen.

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

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 betrokkene voor pand/entiteit moet je altijd eerst RR/KBO doorgegeven, dit is niet mogelijk met naam/voornaam/correspondentieadres (ofwel NAI genoemd). 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.

Verwijderen betrokkene alleen mogelijk bij verwijderen alle rollen betrokkene !

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie persoon

O

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

Referte

Unieke referte per persoon

O

Referte van gekoppelde betrokkene met RR/KBO.

Indien RR/KBO én de referte persoon bij Betrokkene 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.

INSZ

RR betrokkene

(V)

Ondernemingsnummer

KBO betrokkene

Ondernemingsnr of vestigingseenheidsnr

Type

O

Type (wordt momenteel achterliggend niets mee gedaan, kan bovendien afgeleid worden).

Type wordt afgeleid op basis van het meegegeven RR/KBO (RR = natuurlijk persoon | KBO = rechtspersoon).

Omschrijving + Code

NatuurlijkePersoon = 1

Rechtspersoon = 2

Contactpersoon = 3

Shm = 3 

Svk = 4

Wm = 5

(V)

Woonmaatschappij (Wm) komt in de plaats van sociale huisvestingsmaatschappij (Shm) of sociaal verhuurkantoor (Svk).

Actief

(V)

Boolean

Correspondentieadres

Generiek adrestype uit adressenregister (met eigen entiteitsnr + VlokID)

O

Betrokkenen hebben altijd een domicilieadres, echter als die onbereikbaar zijn (vb. buitenland), dan kan bij betrokkene wel een correspondentieadres meegegeven worden (dat kan dan bv. adres van een buur zijn). Wel zeggen dat meegeven van correspondentieadres van betrokkene pas kan nadat een referte persoon bekend is, dus met 2de XML-bericht enkel te doen.

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

Gemeentenaam

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.

Verwijder

Verwijdervlag correspondentieadres

(V)

Boolean

Verwijderen correspondentieadres indien VlokID, Verwijder = 1, TijdstipLaatstGewijzigd

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie correspondentieadres

O

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

Email

O

Telefoon

O

Telefoon2

O

Betrokkenheid

O

Bij betrokkene van pand/entiteit moet je altijd een betrokkenheid definiëren.

Een betrokkene is een persoon of een rechtspersoon en kan verschillende rollen hebben. Een nieuwe of bijkomende rol is gewoon op te geven in de webservice BewaarWoningKwaliteit ZONDER TijdstipLaatstGewijzigd (wegens geen referte rol aanwezig). Indien je wel TijdstipLaatstGewijzigd opgeeft, dan gaat het over wijzigen van rolgegevens.

Een wijziging van de rol zelf is niet mogelijk wegens geen referte. Dat kan opgevangen worden door de bestaande rol te verwijderen (met een verwijdervlag in te stellen en met TijdstipLaatstGewijzigd), en een nieuwe rol op te geven (dus zonder TijdsipLaatstGewijzigd). Dit kan allemaal in eenzelfde webservice BewaarWoningKwaliteit gebeuren.

Je kan geen 2x zelfde rol (of betrokkenheid) voor dezelfde persoon (betrokkene of contactpersoon) aanmaken binnen één webservice. Dit wordt gedaan omdat anders persoon + rol + tijdstiplaatstgewijzigd identiek zouden zijn en dan achteraf via de webservices de rollen niet meer kunnen aangepast worden.

Wijzigen van rol betrokkene of contactpersoon is reeds mogelijk als TijdstipLaatstGewijzigd  juist is ingevuld (dus Start- en Einddatum NVT). Verwijderen van rol betrokkene of contactpersoon is mogelijk als TijdstipLaatstGewijzigd en Startdatum juist zijn ingevuld (dus Einddatum NVT).

Rollen van betrokkenen hebben betrekking op goederen. Eenzelfde rol kan niet gebeuren met een overlappende periode. Rollen van contactpersonen hebben betrekking op personen en kunnen wel met een overlappende periode (wegens minder kritisch).

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie betrokkenheidtype

O

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

TijdstipLaatstGewijzigd van Betrokkenheid voor betrokkene in BewaarWKW (vraag) komt overeen met deze van Rollen in GeefWKW (antwoord).

Rol

(V)

Het veld Rol bij Betrokkene is een verplicht veld. Er dient steeds minimum 1 (één) rol opgegeven te worden, ook voor een bestaande betrokkene. Zodoende dient niet meer eerst gezocht te worden of de persoon reeds een betrokkene is van het pand/entiteit. Indien een nieuwe betrokkene, wordt deze toegevoegd bij pand/entiteit. Indien een bestaande betrokkene, wordt deze gewijzigd inzake rollen of bijhorende velden.

Omschrijving + Code

VolleEigenaar = 1

Vruchtgebruiker = 2

Opstalhouder = 3

Erfpachter = 4

Verhuurder = 5

NaakteEigenaar = 6

Bewoner = 7

Syndicus = 8

(V)

Startdatum

(V)

Formaat: jjjj-mm-dd

StartdatumVastgesteld

O

Boolean

Einddatum

O

Formaat: jjjj-mm-dd

EinddatumVastgesteld

O

Boolean

Bron

O

Omschrijving + Code

OfficieelDocument = 1

Staatsblad = 2

OpzoekingDatabank = 3

CommunicatieBetrokkene = 4      CommunicatieContactpersoon = 5

ViaDerden = 6

OvernameOudeGegevens = 7

ViaSVK = 8

(V)

AandeelEigenaarschap

O

Teller

(V)

Noemer

(V)

DatumKennisgeving

(V)

Formaat: jjjj-mm-dd

Verwijder

Verwijdervlag betrokkenheid

(V)

Boolean

Verwijderen betrokkenheid indien TijdstipLaatstGewijzigd, Rol, Startdatum, Verwijder = 1

Verwijderen betrokkene kan niet los van rollen. Indien geen enkele rol meer in Betrokkenheid bij betrokkene, dan automatisch verwijderen van betrokkene.

Contactpersonen

O

Contactpersonen kunnen enkel bij betrokkenen, en zijn wettelijke personen die de betrokkene van pand/entiteit bijstaan.

Voor contactpersonen die wettelijk nodig zijn in VLOK (voogd, curator, bewindvoerder, zaakvoerder, advocaat, ouder van minderjarige, lasthebber zorgvolmacht) alleen RR-nr of KBO-nr + optionele contactgegevens (email, telefoon, telefoon2).

Een contactpersoon heeft ALTIJD een RR of KBO.

Voor een contactpersoon kan nooit een correspondentieadres worden ingegeven via de webservices.

Verplichte info bij een nieuwe contactpersoon: RR/KBO/(referte) (verplicht), Rollen ten opzichte van betrokkene.

Om een contactpersoon aan te passen is de referte en TijdstipLaatstGewijzigd nodig. Volgende informatie kan dan aangepast worden: Actief, E-mail, Telefoonnummer, Telefoonnummer2, Rollen ten opzichte van betrokkene.

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie persoon

O

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

Referte

Unieke referte per persoon

O

Referte van gekoppelde contactpersoon met RR/KBO.

Indien RR/KBO én de referte persoon bij Betrokkene 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.

Identificatie

O

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

INSZ

RR contactpersoon

(V)

Ondernemingsnummer

KBO contactpersoon

Ondernemingsnr of vestigingseenheidsnr

Actief

(V)

Boolean

Email

O

Telefoon

O

Telefoon2

O

Verwijder

Verwijdervlag contactpersoon

(V)

Boolean

Verwijderen contactpersoon indien TijdstipLaatstGewijzigd, Referte contactpersoon, Verwijder = 1

Verwijderen contactpersoon wel mogelijk los van rollen.

Rollen

(V)

Bij contactpersoon van betrokkene moet je altijd een rol definiëren.

Een contactpersoon is een persoon of een rechtspersoon en kan verschillende rollen hebben. Een nieuwe of bijkomende rol is gewoon op te geven in de webservice BewaarWoningKwaliteit ZONDER TijdstipLaatstGewijzigd (wegens geen referte rol aanwezig). Indien je wel TijdstipLaatstGewijzigd opgeeft, dan gaat het over wijzigen van rolgegevens.

Een wijziging van de rol zelf is niet mogelijk wegens geen referte. Dat kan opgevangen worden door de bestaande rol te verwijderen (met een verwijdervlag in te stellen en met TijdstipLaatstGewijzigd), en een nieuwe rol op te geven (dus zonder TijdsipLaatstGewijzigd). Dit kan allemaal in eenzelfde webservice BewaarWoningKwaliteit gebeuren.

Je kan wel geen 2x zelfde rol opgeven voor dezelfde persoon wegens dubbele TijdstipLaatstGewijzigd dewelke een probleem is bij het aanpassen nadien omdat persoon + rol + tijdstiplaatstgewijzigd dan identiek zouden zijn.

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie rol

O

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

Rol

(V)

Het veld Rol bij Contactpersoon is een verplicht veld. Er dient steeds minimum 1 (één) rol opgegeven te worden, ook voor een bestaande contactpersoon. Zodoende dient niet meer eerst gezocht te worden of de persoon reeds een betrokkene is van het pand/entiteit. Bij steeds opgeven van minimum 1 (één) rol voor een contactpersoon, dient ook niet meer eerst gezocht te worden of de persoon reeds een contactpersoon is van de betrokkene. Indien een nieuwe contactpersoon, wordt deze toegevoegd bij betrokkene. Indien een bestaande contactpersoon, wordt deze gewijzigd inzake rollen of bijhorende velden.

Omschrijving + Code

Voogd = 0

Curator = 1

Bewindvoerder = 2

Zaakvoerder = 3

Advocaat = 5

OuderVanMinderjarige = 6

LasthebberZorgvolmacht = 7

(V)

Startdatum

(V)

Formaat: jjjj-mm-dd

StartdatumVastgesteld

O

Boolean

Einddatum

O

Formaat: jjjj-mm-dd

EinddatumVastgesteld

O

Boolean

DatumKennisgeving

O

Formaat: jjjj-mm-dd

Bron

O

Omschrijving + Code

OfficieelDocument = 1

Staatsblad = 2

OpzoekingDatabank = 3

CommunicatieBetrokkene = 4      CommunicatieContactpersoon = 5

ViaDerden = 6

OvernameOudeGegevens = 7

ViaSVK = 8

(V)

Verwijder

Verwijdervlag rol contactpersoon

(V)

Boolean

Verwijderen rol contactpersoon indien TijdstipLaatstGewijzigd, Rol, Startdatum, Verwijder = 1

Verwijderen contactpersoon wel mogelijk los van rollen. Indien geen enkele rol meer bij contactpersoon, dan automatisch verwijderen van contactpersoon.

Herindelingen

O

Op herindeling kan enkel het veld vergund worden aangepast. De details van de entiteiten en GRs via een herindeling zijn nooit aanpasbaar of verwijderbaar, eenmaal doorgegeven. Er zouden wel nieuwe herindelingen doorgegeven kunnen worden met LEEG VELD voor Referte herindeling. Er wordt echter geöpteerd om herindelingen enkel in VLOK Online rechtstreeks te doen en niet met webservices. We zoeken de herindeling op basis van de datum + TijdstipLaatstGewijzigd. Indien er dezelfde herindelingen gevonden worden, wordt een foutmelding gegeven. We gebruiken de reeds bestaande foutmelding “Er werd geen object voor type Herindeling gevonden met ID ... “ omdat dit een situatie die in realiteit bijna nooit zal voorvallen en een meer specifieke foutmelding daarom enkel meerwerk is.

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie herindeling

(V)

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

DatumHerindeling

(V)

Formaat: jjjj-mm-dd

VergundStatus

(V)

Omschrijving + Code

Onbekend = 0

Ja = 1

Nee = 2

(V)

Element

Beschrijving

V/O

Opmerkingen

Verwijder

Verwijdervlag entiteit

V

Boolean

Verwijderen entiteit indien Verwijder = 1, Referte entiteit, TijdstipLaatstGewijzigd

Referte

Unieke referte per entiteit

O

Referte voor update entiteit. Geen referte = nieuwe entiteit.

Geen aanmaken, wijzigen of verwijderen mogelijk van gesloopte entiteit.

Geen aanmaken of verwijderen mogelijk van heringedeelde/herbestemde entiteit. Wel wijzigen mogelijk.

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie entiteit

O

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

TijdstipLaatstGewijzigdPand

Datum en tijdstip van mutatie pand

V

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

GebouwEenheidId

Zie gebouwenregister

O

Maken/wijzigen GebouwEenheidID mogelijk.

Waarde steeds overschreven, bij niet-wijziging wordt dit veld als LEEG overschreven.

Bij BewaarEntiteit kun je ook GebouwID meegeven bij referte pand met TijdstipLaatstGewijzigd (hier eigenlijk overbodig), er dient echter niets mee gedaan te worden. Als je GebouwID wil maken/wijzigen met XML-bericht, dan moet je dit doen via BewaarPand !

RefertePand

Unieke referte per entiteit

V

Entiteit hoort bij pand.

GebouwId

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.

Adressen

Generiek adrestype uit adressenregister (met eigen entiteitsnr + VlokID)

O

Entiteit is uniek op adres + eigen entiteitsnummer (locatie en verdieping enkel ter info).

Er zijn verschillende adressen mogelijk per pand/entiteit.

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 adres. Geen VlokID = nieuw adres.

VlokID is niet mogelijk en moet leeg zijn (= nieuw adres) bij nieuw pand/entiteit, vermits nieuw pand/entiteit nog geen adres heeft in VLOK en dus ook geen VlokID.

Check op bestaand VlokID in VLOK (bij dit bestaand pand/entiteit!).

Indien geen invulling van VlokID met VlokAdres (= weglaten van adres pand/entiteit), dan blijft alles ongewijzigd qua adressen.

Indien geen invulling van VlokID, en wel invulling van VlokAdres, dan toevoeging van nieuw adres pand/entiteit bij andere adressen.

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

VlokAdres

(V)

VlokAdres mag NIET leeg zijn bij nieuw pand/entiteit, anders geen adressering bekend in VLOK (minstens 1 adres verplicht, niet mogelijk om het enige adres van pand/entiteit te verwijderen).

Check op uniek VlokAdres.

Panden en entiteiten hebben altijd een Belgisch adres.

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

Gemeentenaam

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

Busnr is niet toegestaan bij vrije ingave van adres pand of entiteit (dus bij geen gerelateerd AdresObjectId uit Gebouwen- en Adressenregister).

CrabCode

Zie CRAB-adressenregister

(V)

Busnummer

EigenNummer

O

Geen EigenNummer mogelijk voor adres pand, wel voor adres entiteit. Entiteiten op hetzelfde adres moeten een verschillend busnummer of eigen entiteitsnummer hebben. Busnummer en eigen entiteitsnummer mogen niet samen ingevuld worden.

EigenNummer kan niet worden ingegeven in combinatie met AdresObjectId, dus alleen mogelijk bij vrije ingave van adres entiteit.

Verwijder

Verwijdervlag adres entiteit

(V)

Boolean

Verwijderen adres entiteit indien VlokID, Verwijder = 1, TijdstipLaatstGewijzigd

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie adres

O

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

Capakeys

O

Er zijn verschillende capakeys mogelijk per pand/entiteit.

Update capakey niet mogelijk door ontbreken van unieke referte. Als je de capakey of het veld ToevoegenAanAlleEntiteiten wil updaten, dan dien je eerst capakey te verwijderen en opnieuw toe te voegen.

Bij capakey enkel controle op formaat, niet of de capakey overeenkomt met het adres of zelfs of deze bestaat. Het is de verantwoordelijkheid van de toepassing van de gemeente dat er een correcte capakey wordt meegegeven.

Verwijder

Verwijdervlag capakey

(V)

Boolean

Verwijderen capakey indien Verwijder = 1, TijdstipLaatst Gewijzigd, KadastraleAfdeling, Sectie, Grondnummer

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie capakey

O

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

KadastraleAfdeling

(V)

Omschrijving + Code

(V)

Geen rekening houden met omschrijving daar Kadaster dit veld automatisch invult op basis van code.

Sectie

(V)

Grondnummer

(V)

ToevoegenAanAlleEntiteiten

(V)

Boolean

CapakeyNietAutomatisch Bijwerken

V

Boolean

Type

O

Bij bestaande entiteit kan je type entiteit niet wijzigen, en wordt type entiteit genegeerd. Indien een verkeerd type entiteit wordt opgegeven in het XML-bericht, komt er geen foutmelding en blijft type entiteit in VLOK Online ongewijzigd.

Omschrijving + Code

ZelfstandigeWoning = 0     NietZelfstandigeWoning = 1

NietWoonfunctie = 2 

O

Verdieping

V

Omschrijving + Code

NietVanToepassing = 0

Kelder = 1

Gelijkvloers = 2

Tussen0En1 = 3

EersteVerdieping = 4

Tussen1En2 = 5

TweedeVerdieping = 6

Tussen2En3 = 7

DerdeVerdieping = 8

Tussen3En4 = 9

VierdeVerdieping = 10

Tussen4En5 = 11

VijfdeVerdieping = 12

Tussen5En6 = 13

ZesdeVerdieping = 14

Zolder = 15

Onbekend = 16

Ander = 17

Eengezinswoning = 18

Souterrain = 20

V

VerdiepingAndere

O

VerdiepingAndere indien verdieping = ander

Locatie

O

Beschrijving

O

NettoVloeroppervlakte

O

AantalWoonlokalen

O

InterneBadFunctie

GeenInterneBadfunctie = 0      InLokaalMetWoonfunctie = 1        InLokaalZonderWoonfunctie = 2

O

Omschrijving + Code

(V)

InterneWc

O

InterneKeuken

O

Oppervlakteverhouding

O

Pand

(V)

Entiteit

(V)

HeeftUitzondering98Voor StudentenKamers

O

Boolean

Betrokkenen

O

Je kunt geen nieuwe betrokkene toevoegen bij pand. Vroeger kon een betrokkene ook aan een pand gekoppeld worden, doch dit gaf aanleiding tot misverstanden of deze dan al dan niet standaard aan alle entiteiten waren verbonden. Je krijgt nu bij de BewaarWKW webservice een foutmelding terug bij Betrokkene aan pand. Je kan wel bij een bestaande betrokkene aan een vroeger pand nog gegevens van deze betrokkene wijzigen of verwijderen, en ook nog bestaande rollen wijzigen of verwijderen (niet aanmaken !) van deze betrokkene.

Nieuwe betrokkenen zijn alleen mogelijk bij entiteit (niet bij pand of procedure). Betrokkenen kunnen ook verzoeker of correspondent zijn. Buren zijn verzoekers.

Voor wettelijk betrokkenen (eigenaar, verhuurder, bewoner) alleen RR-nr of KBO-nr (max. gebruik authentieke bronnen) + optionele contactgegevens (email, telefoon, telefoon2) + aanvulling met correspondentieadres (voor familie, vertrouwenspersoon).

Een betrokkene heeft ALTIJD een RR of KBO.

Betrokkenen kunnen enkel gekoppeld worden aan een entiteit (niet aan pand of procedure).

Betrokkenen worden ENKEL doorgegeven via KBO/RR/referte.

Verplichte info bij een nieuwe betrokkene: RR/KBO/(referte), Betrokkenheid (rolinfo).

Om een betrokkene aan te passen is de referte en TijdstipLaatstGewijzigd nodig. Volgende informatie kan dan aangepast worden: Type (wordt momenteel achterliggend niets mee gedaan, kan bovendien afgeleid worden), Actief, Correspondentieadres, E-mail, Telefoon, Telefoon2, Betrokkenheid, Contactpersonen.

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

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 betrokkene voor pand/entiteit moet je altijd eerst RR/KBO doorgegeven, dit is niet mogelijk met naam/voornaam/correspondentieadres (ofwel NAI genoemd). 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.

Verwijderen betrokkene alleen mogelijk bij verwijderen alle rollen betrokkene !

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie persoon

O

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

Referte

Unieke referte per persoon

O

Referte van gekoppelde betrokkene met RR/KBO.

Indien RR/KBO én de referte persoon bij Betrokkene 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.

INSZ

RR betrokkene

(V)

Ondernemingsnummer

KBO betrokkene

Ondernemingsnr of vestigingseenheidsnr

Type

O

Type (wordt momenteel achterliggend niets mee gedaan, kan bovendien afgeleid worden).

Type wordt afgeleid op basis van het meegegeven RR/KBO (RR = natuurlijk persoon | KBO = rechtspersoon).

Omschrijving + Code

NatuurlijkePersoon = 1

Rechtspersoon = 2

Contactpersoon = 3

Shm = 3 

Svk = 4

Wm = 5

(V)

Woonmaatschappij (Wm) komt in de plaats van sociale huisvestingsmaatschappij (Shm) of sociaal verhuurkantoor (Svk).

Actief

(V)

Boolean

Correspondentieadres

Generiek adrestype uit adressenregister (met eigen entiteitsnr + VlokID)

O

Betrokkenen hebben altijd een domicilieadres, echter als die onbereikbaar zijn (vb. buitenland), dan kan bij betrokkene wel een correspondentieadres meegegeven worden (dat kan dan bv. adres van een buur zijn). Wel zeggen dat meegeven van correspondentieadres van betrokkene pas kan nadat een referte persoon bekend is, dus met 2de XML-bericht enkel te doen.

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

Gemeentenaam

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.

Verwijder

Verwijdervlag correspondentieadres

(V)

Boolean

Verwijderen correspondentieadres indien VlokID, Verwijder = 1, TijdstipLaatstGewijzigd

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie adres

O

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

Email

O

Telefoon

O

Telefoon2

O

Betrokkenheid

(V)

Bij betrokkene van pand/entiteit moet je altijd een betrokkenheid definiëren.

Een betrokkene is een persoon of een rechtspersoon en kan verschillende rollen hebben. Een nieuwe of bijkomende rol is gewoon op te geven in de webservice BewaarWoningKwaliteit ZONDER TijdstipLaatstGewijzigd (wegens geen referte rol aanwezig). Indien je wel TijdstipLaatstGewijzigd opgeeft, dan gaat het over wijzigen van rolgegevens.

Een wijziging van de rol zelf is niet mogelijk wegens geen referte. Dat kan opgevangen worden door de bestaande rol te verwijderen (met een verwijdervlag in te stellen en met TijdstipLaatstGewijzigd), en een nieuwe rol op te geven (dus zonder TijdsipLaatstGewijzigd). Dit kan allemaal in eenzelfde webservice BewaarWoningKwaliteit gebeuren.

Je kan geen 2x zelfde rol (of betrokkenheid) voor dezelfde persoon (betrokkene of contactpersoon) aanmaken binnen één webservice. Dit wordt gedaan omdat anders persoon + rol + tijdstiplaatstgewijzigd identiek zouden zijn en dan achteraf via de webservices de rollen niet meer kunnen aangepast worden.

Wijzigen van rol betrokkene of contactpersoon is reeds mogelijk als TijdstipLaatstGewijzigd  juist is ingevuld (dus Start- en Einddatum NVT). Verwijderen van rol betrokkene of contactpersoon is mogelijk als TijdstipLaatstGewijzigd en Startdatum juist zijn ingevuld (dus Einddatum NVT).

Rollen van betrokkenen hebben betrekking op goederen. Eenzelfde rol kan niet gebeuren met een overlappende periode. Rollen van contactpersonen hebben betrekking op personen en kunnen wel met een overlappende periode (wegens minder kritisch).

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie betrokkenheidtype

O

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

TijdstipLaatstGewijzigd van Betrokkenheid voor betrokkene in BewaarWKW (vraag) komt overeen met deze van Rollen in GeefWKW (antwoord).

Rol

(V)

Het veld Rol bij Betrokkene is een verplicht veld. Er dient steeds minimum 1 (één) rol opgegeven te worden, ook voor een bestaande betrokkene. Zodoende dient niet meer eerst gezocht te worden of de persoon reeds een betrokkene is van het pand/entiteit. Indien een nieuwe betrokkene, wordt deze toegevoegd bij pand/entiteit. Indien een bestaande betrokkene, wordt deze gewijzigd inzake rollen of bijhorende velden.

Omschrijving + Code

VolleEigenaar = 1

Vruchtgebruiker = 2

Opstalhouder = 3

Erfpachter = 4

Verhuurder = 5

NaakteEigenaar = 6

Bewoner = 7

Syndicus = 8

(V)

Startdatum

(V)

Formaat: jjjj-mm-dd

StartdatumVastgesteld

O

Boolean

Einddatum

O

Formaat: jjjj-mm-dd

EinddatumVastgesteld

O

Boolean

Bron

O

Omschrijving + Code

OfficieelDocument = 1

Staatsblad = 2

OpzoekingDatabank = 3

CommunicatieBetrokkene = 4      CommunicatieContactpersoon = 5

ViaDerden = 6

OvernameOudeGegevens = 7

ViaSVK = 8

(V)

AandeelEigenaarschap

O

Teller

(V)

Noemer

(V)

DatumKennisgeving

(V)

Formaat: jjjj-mm-dd

Verwijder

Verwijdervlag betrokkenheid

(V)

Boolean

Verwijderen betrokkenheid indien TijdstipLaatstGewijzigd, Rol, Startdatum, Verwijder = 1

Verwijderen betrokkene kan niet los van rollen. Indien geen enkele rol meer in Betrokkenheid bij betrokkene, dan automatisch verwijderen van betrokkene.

Contactpersonen

O

Contactpersonen kunnen enkel bij betrokkenen, en zijn wettelijke personen die de betrokkene van pand/entiteit bijstaan.

Voor contactpersonen die wettelijk nodig zijn in VLOK (voogd, curator, bewindvoerder, zaakvoerder, advocaat, ouder van minderjarige, lasthebber zorgvolmacht) alleen RR-nr of KBO-nr + optionele contactgegevens (email, telefoon, telefoon2).

Een contactpersoon heeft ALTIJD een RR of KBO.

Voor een contactpersoon kan nooit een correspondentieadres worden ingegeven via de webservices.

Verplichte info bij een nieuwe contactpersoon: RR/KBO/(referte) (verplicht), Rollen ten opzichte van betrokkene.

Om een contactpersoon aan te passen is de referte en TijdstipLaatstGewijzigd nodig. Volgende informatie kan dan aangepast worden: Actief, E-mail, Telefoonnummer, Telefoonnummer2, Rollen ten opzichte van betrokkene.

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie persoon

O

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

Referte

Unieke referte per persoon

O

Referte van gekoppelde contactpersoon met RR/KBO.

Indien RR/KBO én de referte persoon bij Betrokkene 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.

Identificatie

(V)

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

INSZ

RR contactpersoon

(V)

Ondernemingsnummer

KBO contactpersoon

Ondernemingsnr of vestigingseenheidsnr

Actief

(V)

Boolean

Email

O

Telefoon

O

Telefoon2

O

Verwijder

Verwijdervlag contactpersoon

(V)

Boolean

Verwijderen contactpersoon indien TijdstipLaatstGewijzigd, Referte contactpersoon, Verwijder = 1

Verwijderen contactpersoon wel mogelijk los van rollen.

Rollen

(V)

Bij contactpersoon van betrokkene moet je altijd een rol definiëren.

Een contactpersoon is een persoon of een rechtspersoon en kan verschillende rollen hebben. Een nieuwe of bijkomende rol is gewoon op te geven in de webservice BewaarWoningKwaliteit ZONDER TijdstipLaatstGewijzigd (wegens geen referte rol aanwezig). Indien je wel TijdstipLaatstGewijzigd opgeeft, dan gaat het over wijzigen van rolgegevens.

Een wijziging van de rol zelf is niet mogelijk wegens geen referte. Dat kan opgevangen worden door de bestaande rol te verwijderen (met een verwijdervlag in te stellen en met TijdstipLaatstGewijzigd), en een nieuwe rol op te geven (dus zonder TijdsipLaatstGewijzigd). Dit kan allemaal in eenzelfde webservice BewaarWoningKwaliteit gebeuren.

Je kan wel geen 2x zelfde rol opgeven voor dezelfde persoon wegens dubbele TijdstipLaatstGewijzigd dewelke een probleem is bij het aanpassen nadien omdat persoon + rol + tijdstiplaatstgewijzigd dan identiek zouden zijn.

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie rol

O

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

Rol

(V)

Het veld Rol bij Contactpersoon is een verplicht veld. Er dient steeds minimum 1 (één) rol opgegeven te worden, ook voor een bestaande contactpersoon. Zodoende dient niet meer eerst gezocht te worden of de persoon reeds een betrokkene is van het pand/entiteit. Bij steeds opgeven van minimum 1 (één) rol voor een contactpersoon, dient ook niet meer eerst gezocht te worden of de persoon reeds een contactpersoon is van de betrokkene. Indien een nieuwe contactpersoon, wordt deze toegevoegd bij betrokkene. Indien een bestaande contactpersoon, wordt deze gewijzigd inzake rollen of bijhorende velden.

Omschrijving + Code

Voogd = 0

Curator = 1

Bewindvoerder = 2

Zaakvoerder = 3

Advocaat = 5

OuderVanMinderjarige = 6

LasthebberZorgvolmacht = 7

(V)

Startdatum

(V)

Formaat: jjjj-mm-dd

StartdatumVastgesteld

O

Boolean

Einddatum

O

Formaat: jjjj-mm-dd

EinddatumVastgesteld

O

Boolean

DatumKennisgeving

O

Formaat: jjjj-mm-dd

Bron

O

Omschrijving + Code

OfficieelDocument = 1

Staatsblad = 2

OpzoekingDatabank = 3

CommunicatieBetrokkene = 4      CommunicatieContactpersoon = 5

ViaDerden = 6

OvernameOudeGegevens = 7

ViaSVK = 8

(V)

Verwijder

Verwijdervlag rol contactpersoon

(V)

Boolean

Verwijderen rol contactpersoon indien TijdstipLaatstGewijzigd, Rol, Startdatum, Verwijder = 1

Verwijderen contactpersoon wel mogelijk los van rollen. Indien geen enkele rol meer bij contactpersoon, dan automatisch verwijderen van contactpersoon.

Epc

O

Waarde

(V)

Datum

Datum van mutatie epctype

(V)

Formaat: jjjj-mm-dd

WoningType

(V)

Omschrijving + Code

OpenBebouwing = 1

HalfopenBebouwing = 2

GeslotenBebouwing = 3

Appartement = 4

(V)