Beschrijving Antwoord (Vlok.GeefWoningKwaliteitBijlage-02.00)

Het antwoord bestaat uit een lijst van foto’s en documenten (met bestand zelf) (ofwel resultaat per foto/document ofwel niet gevonden).

De lijst van detailinfo bevat volgende gegevens:

      Referte foto: naam + bestand + eigenschappen + tags

      Referte document: naam + bestand + eigenschappen + gekoppelde objecten

Algemeen

1.   Voor de duidelijkheid worden naast de referte (met bestand), ook de eigenschappen herhaald die reeds eerder in GeefWKW werden vermeld.

2.   Een foto of document dient de naam van het bestand mee te geven.

3.   Het document krijgt na de BewaarWKWBijlage echter een gegenereerde nieuwe naam bij de creatie van het document door VLOK zelf. Deze naam is dan te zien in de GeefWKW en GeefWKWBijlage response. De naamgeving start altijd met referte persoon, pand of entiteit. Het initieel veld Naam bij een document is dus niet relevant in de BewaarWKWBijlage request.

4.   Het rapport van documenttypes is beschikbaar in VLOK Online onder Mijn rapporten – Documentmodule – configuratie documentttypes: https://vlok.vlaanderen.be/reporting/. Om te kunnen inloggen als gemeente in VLOK Online dient met het afsprakenkader te ondertekenen, welke voorwaarden oplegt dat de gemeente in orde is met de informatieveiligheidsverplichtingen en dat de communicatie met Wonen-Vlaanderen digitaal verloopt.

5.   Het veld ExterneReferte bij foto’s en documenten in de BewaarWKWBijlage request wordt enkel gebruikt als teruggaveveld ter info voor de BewaarWKWBijlage response opdat de gemeente zou weten over welk document het gaat. Het wordt niet opgeslagen in de VLOK databank en dus ook niet gebruikt bij overzicht foto’s en documenten in de GeefWKW of de GeefWKWBijlage response.

6.   Bestand voor foto’s en documenten in Base64 formaat.

7.   Indien de foto afkomstig is van een onderzoek geven we enkel het gekoppeld onderzoek mee. Er worden geen gekoppeld goed of gekoppeld gebrek meegegeven doordat foto’s meermaals aan een goed (pand of entiteit) of gebrek kunnen getagd worden (niet-uniciteit) en er hier slechts één veld GekoppeldGoed of GekoppeldGebrek aanwezig is. Opvraging van de gekoppelde goederen of de gekoppeld gebreken van de foto is mogelijk met GeefWKW onderzoek, waarbij dan wel in het XML antwoord meermaals de tag FotoMetTagType getoond wordt met dezelfde referte, maar met verschillend GekoppeldGoed/GekoppeldGebrek.

8.   Bij opvraging door niet-publieke afnemers (VMSW, CIB, Fednot) met verplichte invulling van het veld Rol, worden slechts een beperkt aantal documenttypes doorgegeven. Ook de koppelingen van document worden beperkt weergegeven, zijnde enkel de entiteit, en het object CA of Besluit. Ook worden correspondenten niet doorgegeven. Mogelijks nog op basis van wat ingevuld is bij 'Rol' worden slechts beperkte documenttypes DT's doorgegeven. Rol kan dan bv 'CA' of 'Besluit' zijn. Nog verder af te stemmen met Magda.

9.   Toegelaten documenttypes indien Rol:

Documenten CA

      DT113 CA kamerwoning

      DT114 CA woning

      DT115 CA seizoenarbeider

      DT124 PV van uitvoering

      DT600 CA Arbeidskrachten

Documenten besluit

      DT034 beslissing burgemeester

      DT090 besluit Minister

      DT105 besluit NGW

XSD Visueel

Detail

 

Element

Beschrijving

V/O

Opmerkingen

Bijlagen

Het antwoord bestaat uit een lijst van foto’s en documenten (met bestand zelf) (ofwel resultaat per foto/document ofwel niet gevonden).

V

 

Foto

Referte foto (meer !)

- info foto

- naam

- bestand zelf

- tags bij foto

O

Voor de duidelijkheid worden naast de referte (met bestand), ook de eigenschappen herhaald die reeds eerder in GeefWKW werden vermeld.

 

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie foto

(V)

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

Dit veld is niet zichtbaar voor niet-publieke afnemers (VMSW, CIB, Fednot).

Naam

 

(V)

Een foto of document dient de naam van het bestand mee te geven.

Het document krijgt na de BewaarWKWBijlage echter een gegenereerde nieuwe naam bij de creatie van het document door VLOK zelf. Deze naam is dan te zien in de GeefWKW en GeefWKWBijlage response. De naamgeving start altijd met referte persoon, pand of entiteit. Het initieel veld Naam bij een document is dus niet relevant in de BewaarWKWBijlage request.

Referte

 

(V)

 

ExterneReferte

 

NVT

Het veld ExterneReferte bij foto’s en documenten in de BewaarWKWBijlage request wordt enkel gebruikt als teruggaveveld ter info voor de BewaarWKWBijlage response opdat de gemeente zou weten over welk document het gaat. Het wordt niet opgeslagen in de VLOK databank en dus ook niet gebruikt bij overzicht foto’s en documenten in de GeefWKW response.

Bestand

 

(V)

Een bestand voor foto of document mag nooit groter zijn dan 4 MB. Indien wel, dan worden deze door DataPower al tegengehouden nog voor ze MAGDA bereiken, en wordt de verbinding met MAGDA verbroken. Er komt dan geen response tevoorschijn in GeefWKWBijlage. Dit wordt in de VLOK webservices opgevangen door een foutboodschap “Het bestand is groter dan 4 MB. Dit kan niet via de webservices worden opgevraagd".

Type

 

(V)

Toegelaten formaten: JPG, PNG, TIFF, GIF … (afbeelding).

Data

 

(V)

Bestand voor foto’s en documenten in Base64 formaat.

 

Omschrijving

 

O

 

GekoppeldGoed

Foto pand of entiteit

O

 

GekoppeldOnderzoek

Foto onderzoek

O

 

GekoppeldGebrek

 

NVT

Indien de foto afkomstig is van een onderzoek geven we enkel het gekoppeld onderzoek mee. Er worden geen gekoppeld goed of gekoppeld gebrek meegegeven doordat foto’s meermaals aan een goed (pand of entiteit) of gebrek kunnen getagd worden (niet-uniciteit) en er hier slechts één veld GekoppeldGoed of GekoppeldGebrek aanwezig is.

Opvraging van de gekoppelde goederen of de gekoppeld gebreken van de foto is mogelijk met GeefWKW onderzoek, waarbij dan wel in het XML antwoord meermaals de tag FotoMetTagType getoond wordt met dezelfde referte, maar met verschillend GekoppeldGoed/GekoppeldGebrek.

Document

Referte document (meer !)

- info document

- naam

- bestand zelf

- documenttype

- correspondenten

- koppelingen bij document

O

Voor de duidelijkheid worden naast de referte (met bestand), ook de eigenschappen herhaald die reeds eerder in GeefWKW werden vermeld.

Bij opvraging door niet-publieke afnemers (VMSW, CIB, Fednot) met verplichte invulling van het veld Rol, worden slechts een beperkt aantal documenttypes doorgegeven. Ook de koppelingen van document worden beperkt weergegeven, zijnde enkel de entiteit, en het object CA of Besluit. Mogelijks nog op basis van wat ingevuld is bij 'Rol' worden slechts beperkte documenttypes DT's doorgegeven. Rol kan dan bv 'CA' of 'Besluit' zijn. Nog verder af te stemmen met Magda.

Toegelaten documenttypes indien Rol:

Documenten CA

- DT113 CA kamerwoning

- DT114 CA woning

- DT115 CA seizoenarbeider

- DT124 PV van uitvoering

- DT600 CA arbeidskrachten

Documenten besluit

- DT034 beslissing burgemeester

- DT090 besluit Minister

- DT105 besluit NGW

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie document

(V)

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

Naam

 

(V)

Een document dient de naam van het bestand mee te geven.

Het document krijgt na de BewaarWKWBijlage echter een gegenereerde nieuwe naam bij de creatie van het document door VLOK zelf. Deze naam is dan te zien in de GeefWKW en GeefWKWBijlage response. De naamgeving start altijd met referte persoon, pand of entiteit. Het initieel veld Naam bij een document is dus niet relevant in de BewaarWKWBijlage request.

Referte

 

(V)

 

ExterneReferte

 

NVT

Het veld ExterneReferte bij foto’s en documenten in de BewaarWKWBijlage request wordt enkel gebruikt als teruggaveveld ter info voor de BewaarWKWBijlage response opdat de gemeente zou weten over welk document het gaat. Het wordt niet opgeslagen in de VLOK databank en dus ook niet gebruikt bij overzicht foto’s en documenten in de GeefWKW response.

Dit veld is niet zichtbaar voor niet-publieke afnemers (VMSW, CIB, Fednot).

Bestand

 

(V)

 

Type

 

(V)

Toegelaten formaten: PDF, DWG (enkel voor DT149 grondplan), Mail.

Data

 

(V)

Bestand voor foto’s en documenten in Base64 formaat.

 

DocumentType

Zie rapport documenttypes

(V)

Het rapport van documenttypes is beschikbaar in VLOK Online onder Mijn rapporten – Documentmodule – configuratie documentttypes: https://vlok.vlaanderen.be/reporting/. Om te kunnen inloggen als gemeente in VLOK Online dient met het afsprakenkader te ondertekenen, welke voorwaarden oplegt dat de gemeente in orde is met de informatieveiligheidsverplichtingen en dat de communicatie met Wonen-Vlaanderen digitaal verloopt.

Correspondenten

 

O

Correspondenten zijn afzenders/bestemmelingen bij documenten.

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

Bij opvraging door niet-publieke afnemers (VMSW, CIB, Fednot) met verplichte invulling van het veld Rol, worden correspondenten niet doorgegeven.

Identificatie

 

(V)

Alle gekoppelde correspondenten worden teruggegegeven.

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.

Indien RR/KBO gekend: RR/KBO, Referte, Telefoon, Telefoon2, E-mail.

Indien RR/KBO niet gekend (NAI):  Referte, Naam, Voornaam, Correspondentieadres, Referte, Telefoon, Telefoon2, E-mail.

INSZ

RR correspondent

(V)

 

Ondernemingsnummer

KBO correspondent

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.

Referte

Unieke referte per persoon

(V)

Referte van gekoppelde correspondent met NAI.

Naam

 

(V)

 

Voornaam

 

(O)

 

Correspondentie adres

Generiek adrestype uit adressenregister (met eigen entiteitsnr + VlokID)

(V)

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

Enkel het laagste niveau adresobject met CRABcode tot en met huisnummerCRABcode wordt teruggegeven. Informatie uit lagere niveaus wordt als tekst getoond alsook de postcode indien geen huisnummerCRABcode of busnummerCRABcode gekend is.

Bijvoorbeeld CRABingave tot en met huisnummer:

- Landobject niet teruggegeven

- Gemeenteobject niet teruggegeven

- PostcodeObject niet teruggegeven

- Straatobject niet teruggegeven

- Huisnummerobject met CRABcode

- Busnummerobject met tekst via busnummertag indien aanwezig

Bijvoorbeeld CRABingave tot en met straat:

- Landobject niet teruggegeven

- Gemeenteobject niet teruggegeven

- PostcodeObject met tekst via postcodetag omdat in dit geval de postcode enkel kan opgehaald worden via het huisnummerCRAB of busnummerCRAB

- Straatobject met CRABcode

- Huisnummerobject met tekst via huisnummertag

- Busnummerobject met tekst via busnummertag indien aanwezig

We noemen vrije ingave indien er geen CRABingave is voor straat, huisnummer of busnummer. Postcode, straat, huisnummer en busnummer (indien aanwezig) worden dan als tekst teruggegeven.

Bijvoorbeeld:

- Landobject met NIScode

- Gemeenteobject met NIScode en CRABcode ingevuld indien gekend, anders wordt de gemeentenaamtag ingevuld

- PostcodeObject met Postcode ingevuld

- Straatobject met tekst via straatnaamtag

- Huisnummerobject met tekst via huisnummertag

- Busnummerobject met tekst via busnummertag indien aanwezig

VlokId

 

(V)

VlokID wordt altijd teruggegeven.

VlokAdres

 

(V)

 

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

Voor land wordt enkel NIScode getoond (altijd beschikbaar!).

ISOCode

Zie ISO-codes van land

(V)

 

NISCode

Zie NIS-codes van land

 

Naam

Naam van land

 

Gemeente

 

O

Als voor gemeente de CRABcode getoond wordt, wordt ook de NIS-code meegegeven.

NISCode

Zie NIS-codes van gemeente

(V)

 

CrabCode

Zie CRAB-adressenregister

 

Gemeente naam

Naam van gemeente

 

Postcode

 

O

Voor het postcodeobject wordt steeds de postcodetag ingevuld aangezien er geen CRABcodes bestaan voor dit object (niet nodig indien CRABcode voor huisnr of busnr).

CrabCode

 

(V)

Geen Crabcodes voor postcode.

Postcode

 

 

Straat

 

O

 

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)

 

Huis nummer

 

 

Busnummer

 

O

 

CrabCode

Zie CRAB-adressenregister

(V)

 

Bus nummer

 

 

EigenNummer

 

NVT

Geen EigenNummer mogelijk voor adres persoon.

TijdstipLaatst Gewijzigd

Datum en tijdstip van mutatie correspondentieadres

(V)

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

TijdstipLaatstGewijzigd

Datum en tijdstip van mutatie persoon

(V)

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

Referte

Unieke referte per persoon

 

Referte van gekoppelde correspondent met RR/KBO/NAI.

Telefoon

 

O

 

Telefoon2

 

O

 

Email

 

O

 

Status

 

V

 

Omschrijving + Code

Opgeladen = 0

InOpmaak = 1

TerOndertekening = 2

Ondertekend = 3

Verwijderd = 4

Ingetrokken = 5

Aangemaakt = 6

TerManueleOndertekening = 7

V

Dit veld is niet zichtbaar voor niet-publieke afnemers (VMSW, CIB, Fednot).

Koppelingen

 

V

Bij opvraging door niet-publieke afnemers (VMSW, CIB, Fednot) met verplichte invulling van het veld Rol, worden slechts een beperkt aantal documenttypes doorgegeven. Ook de koppelingen van document worden beperkt weergegeven, zijnde enkel de entiteit, en het object CA of Besluit.

Referte

Unieke referte volgens type koppeling

V

 

Type

Pand = 1

Entiteit = 2

Onderzoek = 3

Correspondent = 4

Persoon = 5

ReactieHoorplicht = 6

ProcedureOo = 7

ProcedureCa = 8

DeelProcedureOo = 9

DeelProcedureCa = 10

Advies = 11

Beslissing = 12

BesluitNgw = 13

HoofdBeroep = 14

MinistrieelBesluit = 16

Conformiteitsattest OpEntiteit = 17

Conformiteitsattest

OpPand = 18

Dossier = 19

ProcesVerbaal = 20

Herstelvordering = 21

InstantieCorrespondent = 22

Vivoo = 23

DeelBeroep = 25

ProcedureKotlabel = 30

DeelProcedureKotlabel = 31

Beroepsprocedure = 40

Beroep = 41

Beroepsschrift = 42

OntwerpMB = 43

V

 

 

Validaties

1.   Een gemeente kan enkel foto’s en documenten opvragen van pand, entiteit, onderzoek, (deel)procedure voor haar eigen NIS-code volgens het adres van het pand. Voor personen gelden er geen restricties.

2.   Het is beter de resultaten reeds te filteren in VLOK zelf op NIS-code (gemeente), ipv. dit pas later te laten doen door MAGDA. De NIS-code dient dus meegegeven te worden door MAGDA, tesamen met het zoekcriterium. De filtering wie de opvraging heeft gedaan (machtiging, rol gebruiker), is de verantwoordelijkheid van de gemeente zelf. Ook de logging dient gedaan te worden door de externe applicatie. Er wordt om privacy-redenen geen RR opname doorgegeven aan VLOK van gebruiker bij gemeente.

3.   Niet-publieke afnemers (VMSW, CIB, Fednot) kunnen enkel documenten opvragen van pandbeperkt (waarvoor een herstelvordering is) en entiteitbeperkt (waarvoor een actueel CA is of indien de entiteit op VIVOO staat en er dus een actueel besluit is).