GEBRUIKERSHANDLEIDING DOMEIN K ADASTER ZOEKEIGENDOMSTOESTANDEN 2.0. Versie /// 3.0 Publicatiedatum /// /// Gebruikershandleiding

Transcriptie

1 /// Gebruikershandleiding GEBRUIKERSHANDLEIDING DOMEIN K ADASTER ZOEKEIGENDOMSTOESTANDEN 2.0 Versie ///.0 Publicatiedatum ///

2 Informatie Vlaanderen /// Auteur: Elin Vanlierde Datum aanmaak: Wijzigingsdatum: Datum afdruk: Interne bestandsnaam: Gebruikershandleiding ZoekEigendomstoestanden 2.0 Documenthistoriek: Versie Opmerking Datum Auteur Status 0.1 Eerste versie Michaël Loedts Concept 0.2 Review Valère Bouserie Concept 0. Verwerking review Michaël Loedts Concept 1.0 acceptatie Bruno De Vrieze Concept 1.1 Toevoeging foutcodes Michaël Loedts Concept 1.2 Aanpassing mapping en xsd gestructureerde Michaël Loedts Concept rechten element 1. Toevoeging nieuw element Beheerder Jan Van Geert Concept onder EigenaarRecht. 2.0 Publicatie Jan Van Geert Finale versie.0 Nieuwe lay-out Elin Vanlierde Finale versie 2 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

3 /// Informatie Vlaanderen INHOUD Inhoud... 1 Inleiding Verklarende woordenlijst Doel Opbouw document Algemeen Omgevingsinformatie Functionaliteiten Leverancier van de gegevens Gebruiksvoorwaarden Verwante diensten GeefEigendomstoestanden ZoekPerceel Batch Aanpassingen aan deze versie van de dienst... 9 Interface Vraag Algemeen XSD visueel Detail Functionele validaties/beperkingen Voorbeelden Antwoord Algemeen XSD visueel Voorbeeld... 5 Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

4 Informatie Vlaanderen /// 4 Codetabellen en foutcodes Codetabellen Foutcodes Voorbeeld uitzonderingen Annotaties Werking Opvraging Werking met betrekking tot de bronnen en VLABEL Logging Beschikbaarheid Testgegevens en voorbeelden Testgegevens Voorbeelden Contactgegevens /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

5 /// Informatie Vlaanderen 1 INLEIDING 1.1 VERKLARENDE WOORDENLIJST Term VLABEL MAGDA FodFin KBO INSZ GW BD Omschrijving Algemene Administratie van de Patrimoniumdocumentatie Vlaamse Belastingsdienst. Zal als bron gebruikt worden voor het ophalen van de gestructureerde zakelijke rechten en de aanduiding of de persoon op de eigendom woont. Maximale gegevensdeling tussen administraties Federale overheidsdienst financiën Kruispuntbank Ondernemingen Rijksregisternummer MAGDA Gateway MAGDA Businessdienst 1.2 DOEL Dit document beschrijft het gebruik en de werking van de webservice ZoekEigendomstoestanden 2.0 zoals deze door Informatie Vlaanderen op het MAGDA platform aangeboden wordt. Via deze webservice bekomt de gebruiker de eigendomstoestanden van een persoon of onderneming. De eigendomstoestanden bevatten gegevens afkomstig van en bij een opzoeking voor een persoon, worden aan deze gegevens, afhankelijk van de vraagcriteria, gegevens afkomstig van VLABEL toegevoegd. Een eigendomstoestand bevat de volgende informatie over het perceel: de kadastrale legger, het kadastraal inkomen, de aard van het perceel, eigenschappen van de bebouwing op het perceel Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

6 Informatie Vlaanderen /// de eigenaars en hun zakelijke rechten. Of er al dan niet een opvraging bij VLABEL plaatsvindt hangt af van - de machtiging - of er al dan niet gegevens gevonden werden binnen - de aanduiding in de vraag Verder in dit document wordt hier dieper op ingegaan. 1. OPBOUW DOCUMENT Het algemeen overzicht van de functionaliteiten en het gebruik van deze webservice is opgenomen in hoofdstuk 2. Hoofdstuk behandelt de interface van de webservice, dit zowel de Vraag als Antwoord inclusief voorbeelden en bevindingen. Hoofstuk 4 bevat de codetabellen. Hoofdstuk 5 geeft meer informatie over de werking. Hoofdstuk 6 bevat informatie voor het uitvoeren van testen alsook de nodige voorbeelden. De contactgegevens zijn opgenomen in hoofdstuk 7. Daar het de eerste versie van de dienst betreft is er geen hoofdstuk met de wijzigingen tegenover de voorgaande versie. 6 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

7 /// Informatie Vlaanderen 2 ALGEMEEN 2.1 OMGEVINGSINFORMATIE Naam: ZoekEigendomstoestanden Versie: Classificatie: Privacy gevoelig Endpoint T&I: /soap/WebService Endpoint PROD: /soap/WebService 2.2 FUNCTIONALITEITEN De gebruiker doet een opzoeking aan de hand van het INSZ van de persoon of het ondernemingsnummer van de onderneming en krijgt een lijst eigendomstoestanden die aan de opgegeven criteria voldoen. Het antwoord dat MAGDA ontvangt van, eventueel gecombineerd met het antwoord ontvangen van VLABEL, wordt getransformeerd naar eigendomstoestanden. Afhankelijk van de verkregen machtigingen worden bepaalde gegevens al dan niet gefilterd. De logica die de MAGDA dienst volgt om de bevraging van te combineren met de bevraging van VLABEL, wordt uitgelegd in hoofdstuk LEVERANCIER VAN DE GEGEVENS De authentieke bron van de gegevens is de. Bijkomende gegevens worden opgehaald bij VLABEL. Informatie Vlaanderen is dan ook afhankelijk van deze bronnen voor de kwaliteit en de aanlevering van de gegevens. 2.4 GEBRUIKSVOORWAARDEN Afnemers moeten aan volgende voorwaarden voldoen om deze webservice te mogen gebruiken: Toelating tot het MAGDA platform Machtiging van het sectoraal comité van de Federale Overheid Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

8 Informatie Vlaanderen /// Machtiging van de Vlaamse ToezichtsCommissie (VTC) voor de VLABEL gegevens Meer informatie over deze voorwaarden is terug te vinden in het document Machtigingen en toelatingen [MT]. 2.5 VERWANTE DIENSTEN GeefEigendomstoestanden 2.0 De gebruiker vraagt de eigendomstoestanden van één specifiek perceel op, dit op basis van de unieke identificatiegegevens van dat perceel. Als antwoord vanuit bekomt men de lijst van de eigendomstoestanden en de eigenaars (personen en/of ondernemingen) voor dit perceel. Deze dienst gaat enkel naar, er worden geen gegevens opgehaald bij VLABEL ZoekPerceel 2.0 De gebruiker doet een opzoeking aan de hand van de (gedeeltelijke) perceelidentificatiegegevens en krijgt een lijst van percelen beginnende met de percelen die voldoen aan de opgegeven criteria en, zolang de maximum opgegeven lengte van de lijst dit toelaat, ook alle percelen binnen de opgegeven kadastrale afdeling en sectie waarvan de grondnummers één voor één oplopen ten opzichte van het opgegeven grondnummer. Deze dienst gaat enkel naar, er worden geen gegevens opgehaald bij VLABEL. 2.6 BATCH Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Hiervoor moet men de Service-xsd gebruiken en niet de Webservice. Door de Service-xsd te gebruiken zijn er meerdere vragen mogelijk in één bestand. De vraag-bestanden worden op de MAGDA FTP geplaatst in een afnemer specifieke folder. Deze folder wordt tijdens het aansluitingsproces toegekend. Als prefix voor de batchbestanden wordt ZEDT gebruikt. Meer informatie hierover kan u vinden via Aansluiting op het MAGDA-platform in het document MS Gebruikershandleiding_WebserviceInBatch, of neem contact op met helpdesk.magda@vlaanderen.be. 8 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

9 /// Informatie Vlaanderen 2.7 AANPASSINGEN AAN DEZE VERSIE VAN DE DIENST Datum Aanpassing Het xsd-element GestructureerdeRechten heeft een wijziging ondergaan. Deze wijziging heeft impact naar de gebruikers toe indien de gebruikers deze gestructureerde rechten verkrijgen. De wijziging houdt in: aanpassing xsd structuur en mapping van de gegevens komende uit VLABEL. De wijzigingen zijn verder in dit document uitgelegd Toevoeging van het element Beheerder onder EigenaarRecht Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

10 Informatie Vlaanderen /// INTERFACE.1 VRAAG.1.1 Algemeen De vraag bestaat uit het INSZ of ondernemingsnummer. Bijkomend kunnen er ook nog enkele andere zoekcriteria opgegeven worden, waaronder taal en periode of referentiedatum of referentiejaar. De opzoeking kan beperkt worden tot de eigendommen van het opgegeven INSZ of KBO nummer gelegen in één kadastrale afdeling of één gemeente door deze zoekcriteria toe te voegen aan de vraag. Met het criterium MedeEigenaars wordt aangeduid of de personen of de ondernemingen die mede-eigenaar zijn van de percelen waarvan het opgegeven INSZ of ondernemingsnummer, ook mede-eigenaar is, al dan niet opgenomen worden in het antwoord. Met het criterium TypeZoekopdracht wordt aangeduid of de eigendomstoestanden moeten geldig zijn op fiscaal of juridisch vlak voor de opgegeven periode of referentiedatum of referentiejaar. Met het criterium GestructureerdeRechten wordt aangeduid of de gestructureerde zakelijke rechten en de koppeling tussen de bewoner en de eigendom al dan niet uit de VLABEL referentiedatabank moeten opgehaald worden. Het ophalen van de gegevens uit de VLABEL databank is enkel mogelijk indien de opzoeking gebeurt met een INSZ..1.2 XSD visueel 10 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

11 /// Informatie Vlaanderen.1. Detail Element Cardinaliteit Extra INSZ Choice Verplicht Hierop zal er een checksum 97 validatie plaatsvinden. Indien het nummer niet voldoet aan deze validatie zal er een uitzondering aangemaakt worden. Kan niet samen opgegeven worden met het ondernemingsnummer. Ondernemingsnummer Hierop zal er een checksum 97 validatie plaatsvinden. Indien het nummer niet voldoet aan deze validatie zal er een uitzondering aangemaakt worden. Kan niet samen opgegeven worden met het INSZ. MedeEigenaars Verplicht 0 of 1 TypeZoekopdracht Optioneel J of F (J = Juridisch / F = Fiscaal) Referentie/Jaar Referentie/Datum Periode/Begin Periode/Einde Choice Optioneel Onder formaat jjjjj. Kan niet samen met Datum of Periode Onder formaat jjjj-mm-dd. Kan niet samen met Jaar of Periode. Indien Periode opgegeven zijn Begin en Einde verplicht. Kan niet samen met Jaar of Datum. Formaat: jjjj-mmdd. KadastraleAfdeling Optioneel De kadastrale afdeling van het perceel. GemeenteNISCode Optioneel Gemeente NISCode Taal Verplicht Steeds nl, andere talen worden op dit ogenblik niet ondersteund GestructureerdeRechtenWoontOp Optioneel Indien niet aanwezig of 0 : er worden geen gegevens opgehaald bij VLABEL Indien 1: bijgekomende gegevens worden bij VLABEL opgehaald Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

12 Informatie Vlaanderen ///.1.4 Functionele validaties/beperkingen Volgende functionele validaties/beperkingen zijn van toepassing op de vraag. Element Validatie Foutcode Ondernemingsnummer Het ondernemingsnummer in de vraag moet voldoen aan de checksum 97 validatie INSZ Het INSZ in de vraag moet voldoen aan de checksum validatie Referentie/Jaar Indien een Referentie/Jaar opgegeven werd moet ook 0026 TypeZoekopdracht opgegeven zijn Referentie/Datum Indien een Referentie/Datum opgegeven werd moet ook 0028 TypeZoekopdracht opgegeven zijn Periode Begindatum van de periode moet kleiner of gelijk zijn aan de 2000 einddatum GestructureerdeRec Indien 1 en er is GEEN INSZ opgegeven 0028 GestructureerdeRec Indien 1 en Periode is opgegeven Voorbeelden Voorbeeld 1 <Vraag> <Referte>5780</Referte> <Inhoud> <Criteria> <INSZ>***********</INSZ> <MedeEigenaars>1</MedeEigenaars> <TypeZoekopdracht>J</TypeZoekopdracht> <Referentie> <Jaar>2015</Jaar> </Referentie> </Criteria> <Taal>nl</Taal> </Inhoud> </Vraag> 12 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

13 /// Informatie Vlaanderen Voorbeeld 2 <Vraag> <Referte>5788</Referte> <Inhoud> <Criteria> <INSZ>***********</INSZ> <MedeEigenaars>0</MedeEigenaars> </Criteria> <Taal>nl</Taal> </Inhoud> </Vraag> Voorbeeld <Vraag> <Referte>5810</Referte> <Inhoud> <Criteria> <INSZ>***********</INSZ> <MedeEigenaars>0</MedeEigenaars> <TypeZoekopdracht>J</TypeZoekopdracht> <Referentie> <Jaar>2015</Jaar> </Referentie> </Criteria> <Taal>nl</Taal> </Inhoud> </Vraag> Voorbeeld 4 <Vraag> Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

14 Informatie Vlaanderen /// <Referte>5820</Referte> <Inhoud> <Criteria> <INSZ>**********</INSZ> <MedeEigenaars>1</MedeEigenaars> <TypeZoekopdracht>F</TypeZoekopdracht> <Referentie> <Jaar>2014</Jaar> </Referentie> </Criteria> <Taal>nl</Taal> <GestructureerdeRechtenWoontOp>1</GestructureerdeRechtenWoontOp> </Inhoud> </Vraag> Voorbeeld 5 <Vraag> <Referte>5781</Referte> <Inhoud> <Criteria> <Ondernemingsnummer> </Ondernemingsnummer> <MedeEigenaars>0</MedeEigenaars> <TypeZoekopdracht>J</TypeZoekopdracht> <Referentie> <Jaar>2015</Jaar> </Referentie> </Criteria> <Taal>nl</Taal> </Inhoud> </Vraag> 14 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

15 /// Informatie Vlaanderen Een volledig voorbeeld is terug te vinden in hoofdstuk 6..2 ANTWOORD.2.1 Algemeen Het antwoord bestaat uit de eigendomstoestanden die van toepassing zijn voor de opgegeven persoon of onderneming. Het antwoord bevat naast de eigendomstoestanden ook gegevens omtrent de eigenaar(s) (partijen), personen en ondernemingen waaronder INSZ en ondernemingsnummer. De eigenaars en de eventuele mede-eigenaars van alle eigendomstoestanden die van toepassing zijn voor het opgegeven INSZ of KBO nummer, zijn opgelijst in de elementen Personen en/of Ondernemingen. De eigenaar(s) en eventuele mede-eigenaars worden in het element Personen geïdentificeerd met hun INSZ en in het element Ondernemingen met hun KBO nummer. Daarnaast staat in deze elementen ook een unieke sleutel, eigen aan, voor elke eigenaar en mede-eigenaar. Deze unieke sleutel, eigen aan, is de identificatie van de eigenaars en mede-eigenaars in het element Eigendomstoestand/EigenaarsRechten. Een eigendomstoestand bevat de volgende informatie over het perceel: de kadastrale legger, het kadastraal inkomen, de aard van het perceel, eigenschappen van de bebouwing op het perceel de eigenaars en hun zakelijke rechten. Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

16 Informatie Vlaanderen ///.2.2 XSD visueel Wegens de grootte van het xsd wordt deze (inhoudelijk) niet volledig besproken. Enkel de belangrijkste onderdelen worden aan bod gebracht. Partijen/Personen Elke persoon die betrokken is in de eigendomstoestand van de gevonden Eigendom wordt hier opgenomen, dit met zijn INSZ, naam en voornaam, geboortedatum, gemeente en land. Elke persoon verkrijgt vanuit een unieke ID. Via deze ID is het mogelijk de eigendomsrechten, die in het antwoord element EigenaarsRechten terugkomen, te koppelen aan de persoon. Persoon/ PartijId INSZ Naam Opmerking Beschrijving Op basis van dit ID kunnen de eigendomsrechten gekoppeld worden aan de juiste persoon. Authentieke bron voor de persoonsgegevens 16 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

17 /// Informatie Vlaanderen -Achternamen --Achternaam -Voornamen --Voornaam -- Geboortedatum Gemeente -NISCode -PostCode -Naam Land -NISCode -ISOCode -Naam Maar één Achternaam-element kan voorkomen Maar één Voornaamelement kan voorkomen Nooit aanwezig Nooit aanwezig Nooit aanwezig Kan niet aanwezig zijn (wordt toegevoegd door MAGDA) Kan niet aanwezig zijn (wordt toegevoegd voor MAGDA) Formaat dd-mm-jjjj Gemeente van beheer van de persoonsgegevens Land van beheer van de persoonsgegevens Partijen/Ondernemingen Elke onderneming die betrokken is in de eigendomstoestand van de gevonden eigendom wordt hier opgenomen, dit met zijn ondernemingsnummer en naam. Elke onderneming verkrijgt vanuit een unieke ID. Via deze ID is het mogelijk de eigendomsrechten, dit in het antwoord element EigenaarsRechten terugkomen, te koppelen aan de onderneming. Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

18 Informatie Vlaanderen /// Onderneming/ PartijId Ondernemingsnummer Naam Opmerking.. Beschrijving Op basis van dit ID kunnen de eigendomsrechten gekoppeld worden aan de juiste onderneming. Ondernemingsnummer steeds met voorloopnul. Authentieke bron voor de ondernemingssgegevens Eigendomstoestand/StatusInformatie 18 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

19 /// Informatie Vlaanderen StatusInformatie/ ArtikelInschrijving/Huidig ArtikelInschrijving/Voorgaand Versie -Begin -Einde -Annulatie StatusEigendom -Code -Omschrijving PeriodeStatus -Begin -JaarBegin -Einde -JaarEinde PeriodeJuridisch -Begin -Einde Opmerking Beschrijving, Oorsprong en TaalCode komen niet terug Beschrijving Historisch eerste artikelinschrijving die aan deze eigendomstoestand is toegekend Artikelinschrijving die de hierboven aangeduide artikelinschrijving voorafging Timestamp validatie dossier bij creatie eigendomstoestand Timestamp validatie dossier bij afsluiten eigendomstoestand Timestamp validatie dossier bij annulatie eigendomstoestand Code status eigendomstoestand Beschrijving status eigendomstoestand Fiscale begindatum eigendomstoestand Jaar van de fiscale begindatum Fiscale einddatum van de eigendomstoestand Jaar van de fiscale einddatum Juridische begindatum van de eigendomstoestand Juridische einddatum van de eigendomstoestand Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

20 Informatie Vlaanderen /// Dubieus EigendomId MartkWaarde -Berekende -DatumBerekening -MinimaleWaarde -MaximaleWaarde Aanduiding voor eigendomstoestand waarvan de eigendomsrechten dubieus zijn ID eigendomstoestand PATRIS Berekende venale waarde Datum berekende venale waarde Minimum berekende venale waarde Maximum berekende venale waarde 20 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

21 /// Informatie Vlaanderen Eigendomstoestand/Perceel Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

22 Informatie Vlaanderen /// Eigendomstoestand/Perceel/Identificatie Identificatie Opmerking Beschrijving KadastraleAfdeling -Code -Omschrijving Sectie Grondnummer Bisnummer Cijferexponent Letterexponent Partitie NoemerGemeneDelen Precad Code kadastrale afdeling Beschrijving kadastrale afdeling Sectie Grondnummer Bisnummer Cijferexponent Letterexponent Deelnummer (P0000 -> P9999) Noemer bij gemene delen Precad (Ja/Nee) Eigendomstoestand/Perceel/AlgemeneInformaties AlgemeneInformatie KadastraalInkomen KadastraalInkomenPerOppervlakte Gemeente -NISCode -PostCode -Naam IdentificatiePolderOfWatering -Code -Omschrijving Opmerking Zie KadastraalInkomen Komt niet voor in het antwoord Beschrijving, Oorsprong en TaalCode komen niet terug Beschrijving Kadastraal Inkomen per hectare NISCode van de administratieve gemeente Beschrijving van de administratieve gemeente Code Polders&Wateringen Beschrijving Polders&Wateringen 22 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

23 /// Informatie Vlaanderen IndicieGrond -Code -Omschrijving HuurwaardeGrond -Code -Omschrijving ValidatieOppervlakte -Code -Omschrijving AandeelNietAangeduid Nummer VolgordeOnderdelen Oppervlakte -Belast -NietBelast SleutelToestandPUR Coordinaat -x -y Beschrijving, Oorsprong en TaalCode komen niet terug Beschrijving, Oorsprong en TaalCode komen niet terug Beschrijving, Oorsprong en TaalCode komen niet terug Code indicie van de waarde van de grond Beschrijving indicie van de waarde van de grond Code huurwaarde van de grond Beschrijving huurwaarde van de grond Code validatie van de oppervlakte Beschrijving validatie van de oppervlakte Aandeel niet aangeduid Nummer proportie Volgorde van de onderdelen volgens inbreng en regelmenteringen Oppervlakte belast Oppervlakte niet belast Sleutel purtoestand betrokken bij dit onderdeel X coordinaat Y coordinaat Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

24 Informatie Vlaanderen /// KadastraalInkomen KadastraalInkomen/ Bedrag Decreten -Decreet --Code --Omschrijving Motivatie Motiveringen -Motivering --Code --Omschrijving Lettercode -Code -Omschrijving Cijfercode -Code -Omschrijving DatumEindeVrijstelling Opmerking Meerdere Decreetelementen kunnen terugkomen Beschrijving, Oorsprong en TaalCode komen niet terug Meerdere Motiveringelementen kunnen terugkomen (max drie) Beschrijving, Oorsprong en TaalCode komen niet terug Beschrijving, Oorsprong en TaalCode komen niet terug Beschrijving, Oorsprong en TaalCode komen niet terug Beschrijving Bedrag van het niet-geïndexeerd kadastraal inkomen in euro. Code decreet Kadastraal Inkomen Beschrijving decreet Kadastraal Inkomen Code motivering Beschrijving motivering Code fiscaal statuut van het Kadastraal Inkomen Beschrijving fiscaal statuut van het Kadastraal Inkomen Code aard Kadastraal Inkomen Beschrijving aard Kadastraal Inkomen Datum einde vrijstelling 24 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

25 /// Informatie Vlaanderen Eigendomstoestand/Perceel Perceel/ AantalLiften BeschrijvingPrivatiefGedeelte BeschrijvingTweedeAardBassin DatumValidatieDossier PeriodeVersie -Begin -Einde Gebouwen/ RedenPerimeter -Code -Omschrijving EPC -Code -Omschrijving -DatumUitgifte AardKadastraalPerceel -Code Opmerking Zie Gebouwen Beschrijving, Oorsprong en TaalCode komen niet terug Beschrijving, Oorsprong en TaalCode komen niet terug Beschrijving, Oorsprong en TaalCode komen niet terug Beschrijving Aantal liften Beschrijving van het privatief deel Aanduiding van tweede aard BASSIN Timestamp validatie dossier bij creatie perceelstoestand Timestamp validatie dossier bij mutatie perceelstoestand Code reden waarom het perceel kandidaat is voor dodehand Beschrijving reden waarom het perceel kandidaat is voor dodehand Code type energie prestatie certificaat Beschrijving type energie prestatie certificaat Datum aflevering certificaat Code kadastrale aard van het perceeel Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

26 Informatie Vlaanderen /// -Omschrijving StatusPatrimoniaalPerceel -Code -Omschrijving Gebruik -Code -Omschrijving PeriodeGeldigheidPerceel -Begin -JaarBegin -Einde -JaarEinde CodeCadnetDetail Energieverbruik DrempelBelastbaar Isolatiewaarde BeschrijvingKlaarpan MaximaleThermischeGeleidbaarheid LijstOnbebouwd MaterieelEnOutillage - Beschrijving - NietBelast Beschrijving, Oorsprong en TaalCode komen niet terug Overn Beschrijving, Oorsprong en TaalCode komen niet terug Zie Perceel/Onbebouwd Beschrijving kadastrale aard van het perceeel Code status van het perceel Beschrijving status van het perceel Code gebruik Beschrijving gebruik Begindatum perceelstoestand Beginjaar perceelstoestand Einddatum perceelstoestand Eindjaar perceelstoestand Detailcode perceel uit CADNET Het energieverbruik van het huis Drempelwaarde belastbaarheid mat & out De isolatiewaarde van het huis aanduiding van tweede aard KLAARPAN De maximum thermische geleidingscoëfficiënt van de bouwelementen Aanduiding van tweede aard Mat&Out Niet belastbaar mat & out 26 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

27 /// Informatie Vlaanderen LiggingIdPerceel Breedte -Hoofdgebouw -PerceelStraatkant EnergieZuinigeWoning Rootput Schetsnummer ID van de perceelstoestand Breedte van het hoofdgebouw Breedte van het perceel langs de straat 0 of 1 Energie zuinige woning aanduiding van tweede aard ROOTPUT Schetsnummer betrokken bij creatie of mutatie van de perceelstoestand Gebouwen Gebouw/ Adres Adres@DatumBegin Adres@DatumEinde -Straat --Code --Naam -Huisnummer -Busnummer -Gemeente --NISCode --PostCode --Naam -Land Opmerking Beschrijving Begindatum adrestoestand Einddatum adrestoestand Straatcode, eigen aan Straatnaam, schrijfwijze kan verschillend zijn tov het Rijksregister of KBO. Huisnummer NIS code Postcode Gemeentenaam Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

28 Informatie Vlaanderen /// --NISCode --ISOCode --Naam -Sortering --StraatNaam --Huisnummer -PeriodeVersie --Begin --Einde Beschrijving AantalKelderverdiepingen AantalBadkamers AantalSlaapkamers NummerBlok BebouwdeOppervlakte CentraleVerwarming Airco -Code -Omschrijving Constructie -Indicatie --Code Aangevuld door MAGDA Aangevuld door MAGDA Aangevuld door MAGDA Steeds 150 Steeds BE Steeds België Straatnaam gebruikt om te sorteren. Huisnummer gebruikt om te sorteren. Timestamp begin versie Timestamp einde versie Beschrijving in akte Aantal kelders Aantal badkamers Aantal slaapkamers Bloknummer Bebouwde oppervlakte 0 of 1 Centrale verwarming Code type airconditioning Beschrijving type airconditioning Code en beschrijving indicie van het gebouw 28 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

29 /// Informatie Vlaanderen --Omschrijving -Kwaliteit --Code --Omschrijving -Type --Code --Omschrijving -Jaar --Code --Omschrijving BeschrijvingPrivatiefDeel -Code -Omschrijving TypeDomotica -Code -Omschrijving LiggingPrivatiefDeel -Code -Omschrijving Zwembad -Code -Omschrijving PUR -Id Code kwaliteit van het gebouw Beschrijving kwaliteit van het gebouw Code bouwtype Beschrijving bouwtype Code bouwjaar Beschrijving bouwjaar Code type van privatief deel Beschrijving type van privatief deel Code type domotica Beschrijving type domotica Code ligging privatief deel op de verdieping Beschrijving ligging privatief deel op de verdieping Code type zwembad Beschrijving type zwembad Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

30 Informatie Vlaanderen /// -Aard --Code --Omschrijving -Type --Code --Omschrijving -Gemeenschappelijk -Hoofd -Nummer -Locatie Renovatie -TypeRenovatie --Code --Omschrijving -Oppervlakte -Jaar AantalOverdekteParkeerplaatsen DetailOverschrijding Denom Beschrijving2 CADNET Verdieping Code PUR aard Beschrijving PUR aard Code PUR type Beschrijving PUR type Hoofd PUR Nummer van de PUR Code type verbeteringswerken Beschrijving type verbeteringswerken Oppervlakte betrokken bij verbeteringswerken Jaar van de verbeteringswerken Aantal overdakte standplaatsen Gebouw gelegen op meerdere percelen (#DEEL) Detailcode CADNET Verdiep 0 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

31 /// Informatie Vlaanderen SpecificatieEigendomZonderAkte -Van -Tot AantalVerdiepingen -Bovengronds -Ondergronds TotaleOppervlakteVloer AantalGarages Dakverdieping TotaalAantalLiften AantalWoongelegenheden Gemeenschappelijk AnderNummer PercetageVerwarmdeOppervlakte JaarFysiekeModificatie AantalRuimtes Zonnepanelen AantalTerrassen Tekst Oppervlakte -Totaal Specificatie over de verdieping maar zonder dat dit vermeld staat op een officieel document (akte). Vanaf verdieping Tot verdieping aantal verdiepingen bovengrond aantal verdiepingen ondergrond Vloeroppervlakte Aantal garages Mansarde Aantal liften Aantal woongelegenheden Percent verwarmde oppervlakte Jaar van de verbeteringswerken Aantal woonplaatsen Fotovoltaïsche zonnepanelen (true/false) Terrassen Vrije tekst Totale oppervlakte Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

32 Informatie Vlaanderen /// -Gebruikte Jaar -Begin -Einde Nuttige oppervlakte Onbebouwd Onbebouwd PUR -Id -Aard --Code --Omschrijving -Type --Code --Omschrijving Opmerking Beschrijving, Oorsprong en TaalCode komen niet terug Beschrijving, Oorsprong en TaalCode komen niet terug Code PUR aard Beschrijving PUR aard Code PUR type Beschrijving PUR type - Gemeenschappelijk -Hoofd -Nummer Hoofd PUR Nummer van de PUR Locatie Ligging ongebouwd (toponiemen) 2 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

33 /// Informatie Vlaanderen Eigenaarsrechten/Eigenaarsrecht/ EigenaarsRechten/EigenaarRecht LijstId -PartijId Anoniem Type -Code Opmerking Bevat één van deze drie waardes: - Gemeenschap - Onderneming - Individueel Dit ID komt overeen met het ID binnen Partijen/Personen/Persoon/PartijId Komt enkel terug vanuit VLABEL rnemen Beschrijving Koppeling van het recht aan de persoon/onderneming. Duidt aan of de partij al dan niet op deze eigendom woont. Tekst met de anonieme eigenaars + niet genormaliseerde zakelijke rechten (# en 2 rechthebbenden -BE 1/4- #) Code titularistype Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

34 Informatie Vlaanderen /// -Omschrijving MedeEigenaars Beheerder ZakelijkRecht/Ongestructureerd -Recht -Rechten --Recht ---Omschrijving ---Type ----Code ----Omschrijving ---Verval ----Jaar ----Datum ---Aandeel ----Noemer ----Teller ---NietBepaald ---Afpaling ---CANietAfgepaald ZakelijkRecht/Gestructureerd Beschrijving titularistype Tekst met mede-eigenaars De beheerder van het perceel Zakelijk recht in tekstvorm (niet genormaliseerd) Code genormaliseerd zakelijk recht Beschrijving genormaliseerd zakelijk recht Jaar waarin het zakelijk recht vervalt Vervaldatum van het zakelijk recht Noemer van de aandelen van een genormaliseerd zakelijk recht Teller van de aandelen van een genormaliseerd zakelijk recht 0 of 1 Aandeel niet bepaald 0 of 1 Niet afpaling Zie onderstaande tabel Aantal centiares die niet afgepaald zijn 4 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

35 /// Informatie Vlaanderen Gestructureerde rechten: dit element heeft een wijziging van structuur ondergaan in november Rechten/Recht PartijId Omschrijving Percentage_VG Percentrage_VE Opmerking Dit ID komt overeen met het ID binnen Partijen/Personen/Persoon/PartijId VLABEL VLABEL VLABEL Beschrijving Koppeling van het recht aan de persoon/onderneming. Beschrijving genormaliseerd zakelijk recht Percentage genormaliseerd zakelijk recht. Beidi percentages zullen steeds gelijk zijn. Dit doordat _VG en _VE beide.2. Voorbeeld Zie bijlage. voorbeeld.xml Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

36 Informatie Vlaanderen /// 4 CODETABELLEN EN FOUTCODES 4.1 CODETABELLEN Geen codetabellen van toepassing op deze webservice. heeft wel codetabellen, van hen verkrijgen we voor de gecodeerde velden ook altijd de omschrijving van. 4.2 FOUTCODES Wat betreft de Uitzonderingen wordt dezelfde werking gevolgd als de overige MAGDA webservices. Enkel de dienst specifieke foutcodes zijn opgenomen in het overzicht. Voor een volledig overzicht van de MAGDA foutcodes wordt verwezen naar de generieke handleiding. Het is steeds mogelijk dat er in de toekomst foutcodes toegevoegd worden. Identificatie 2000 Niveau Type Diagnose Oorsprong FOUT Begindatum van de periode moet kleiner MAGDA of gelijk zijn aan de einddatum FOUT Geen gegevens gevonden voor de vraag MAGDA FOUT VLABEL: geen gegevens MAGDA FOUT VLABEL: Databank niet bereikbaar of MAGDA ander technisch probleem FOUT VLABEL: Fout tegenover xsd of in het soapbericht MAGDA 4550 FOUT VLABEL: Persoon niet gevonden MAGDA 6 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

37 /// Informatie Vlaanderen FOUT VLABEL: Ongeldig party ID MAGDA FOUT VLABEL: Ongeldige person key MAGDA FOUT VLABEL: Geen ValidityDate ingevuld MAGDA FOUT VLABEL: Ongeldige ValidityDate ingevuld MAGDA FOUT VLABEL: Verplichte zoekparameter MAGDA ontbreekt FOUT VLABEL: Ongeldige combinatie van zoekparameters. Meer dan één van de MAGDA unieke inputsleutels (person key, party ID) ingevuld FOUT VLABEL: geen gegevens koppelbaar met MAGDA FOUT Gemeente niscode niet gevonden MAGDA FOUT Kadastrale divisie niet gevonden MAGDA FOUT Of gemeente NISCode of kadastrale afdeling moet ingevuld worden MAGDA FOUT Onbestaande partitie MAGDA FOUT Onbestaand exponentletter MAGDA FOUT Onbestaand exponentcijfer MAGDA FOUT Onbestaand bisnummer MAGDA FOUT Onbestaand grondnummer MAGDA FOUT Onbestaande sectie MAGDA FOUT Gemeente niscode niet gevonden MAGDA Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

38 Informatie Vlaanderen /// FOUT Straatcode niet gevonde MAGDA FOUT Referentie jaar en datum ingevuld, kies MAGDA één van de twee FOUT Einddatum verplicht MAGDA FOUT Begindatum verplicht MAGDA FOUT Type zoekopdracht verplicht MAGDA FOUT Referentie jaar, datim begin/einde MAGDA verplicht FOUT F60 niet gevonden MAGDA FOUT Datum ligt in de toekomst MAGDA FOUT Niet mogelijk om meer dan drie jaar voor de opgegeven datum (jaar) te zoeken MAGDA FOUT Geen antwoord van de bron ontvangen MAGDA 2 FOUT Kan antwoord van bron niet interpreteren WAARSCHUWING Landgegeven van de bron niet gekend binnen Magda, contacteer VIP FOUT Broncode niet aanwezig voor opgegeven Magda code in de vraag, contacteer VIP WAARSCHUWING Magda code niet aanwezig voor teruggekomen broncode, contacteer VIP FOUT Ongekende foutcode van de bron, contacteer VIP MAGDA MAGDA MAGDA MAGDA MAGDA Voorbeeld uitzonderingen Ongeldig INSZ <Antwoorden> <Antwoord> <Referte>5800</Referte> 8 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

39 /// Informatie Vlaanderen <Uitzonderingen> <Uitzondering> <Identificatie>20002</Identificatie> <Oorsprong>MAGDA</Oorsprong> <Type>FOUT</Type> <Tijdstip> <Datum> </Datum> <Tijd>17:29:51.106</Tijd> </Tijdstip> <Diagnose>INSZ in de vraag heeft een ongeldige structuur</diagnose> </Uitzondering> </Uitzonderingen> </Antwoord> </Antwoorden> Referentie jaar/datum zonder typezoek <Antwoorden> <Antwoord> <Referte>5801</Referte> <Uitzonderingen> <Uitzondering> <Identificatie>0026</Identificatie> <Oorsprong>MAGDA</Oorsprong> <Type>FOUT</Type> <Tijdstip> <Datum> </Datum> <Tijd>17:44:45.901</Tijd> </Tijdstip> <Diagnose>TypeZoekopdracht verplicht bij opgeven van Referentie/Jaar</Diagnose> Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

40 Informatie Vlaanderen /// </Uitzondering> </Uitzonderingen> </Antwoord> </Antwoorden> Annotaties In bepaalde omstandigheden komen er ook annotaties terug bij een Uitzondering. Voor een overzicht van de gebruikte annotaties binnen de MAGDA 2.0 webservices wordt verwezen naar de generieke handleiding. Voorbeeld: <Uitzonderingen> <Uitzondering> <Identificatie>99981</Identificatie> <Oorsprong>MAGDA</Oorsprong> <Type>WAARSCHUWING</Type> <Tijdstip> <Datum> </Datum> <Tijd>11::4.108</Tijd> </Tijdstip> <Diagnose>Land gegevens van de bron niet gekend binnen Magda, contacteer VIP</Diagnose> <Annotaties> <Annotatie> <Naam>LandISOCode</Naam> <Waarde>99</Waarde> </Annotatie> </Annotaties> </Uitzondering> </Uitzonderingen> 40 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

41 /// Informatie Vlaanderen 5 WERKING 5.1 OPVRAGING Van zodra de vraag gesteld is wordt er een XSD-validatie uitgevoerd. Is de ontvangen vraag XML niet geldig tegenover het schema, dan stopt de verwerking en wordt een foutmelding aangemaakt, anders gaat de verwerking verder. Na de XSD-validatie vinden de nodige authenticatie- en autorisatiecontroles plaats. Hierna vinden de nodige functionele validaties van de vraag plaats. Indien aan één functionele validatie niet voldaan wordt stopt de verwerking en verkrijgt men een gepaste uitzondering. Indien een opzoeking op ondernemingsnummer uitgevoerd wordt dan is naast dit ondernemingsnummer ook minstens een NISCode of een kadastrale afdeling vereist. Indien er geen functionele validatiefout is opgetreden zal de webservice de gegevens ophalen bij de en deze omvormen tot een ZoekEigendomstoestand response. Werd de vraag uitgevoerd op basis van een INSZ en er werd aangegeven dat de gestructureerde rechten gewenst zijn wordt er een bijkomende opvraging uitgevoerd bij VLABEL. Indien er bij geen gegevens gevonden werden voor de vraag verkrijgt men als fout Bekomt men geen gegevens vanuit VLABEL, dan zullen de gegevens wel nog steeds in het antwoord opgenomen worden. Het antwoord wordt gevalideerd waarna het aan de afnemer ter beschikking gesteld wordt. 5.2 WERKING MET BETREKKING TOT DE BRONNEN EN VLABEL. Wordt de opvraging uitgevoerd op basis van een INSZ en bekomt de MAGDA dienst gegevens van (dus een positief antwoord en geen foutmelding), dan zal, indien gevraagd, nog een tweede request uitgevoerd worden naar VLABEL toe. Bij VLABEL worden de zakelijke rechten namelijk op een gestructureerde manier bewaard. Deze worden toegevoegd aan het antwoord. Onderstaande afbeelding toont de eenvoudige flow van een request. Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

42 Informatie Vlaanderen /// GW BD Vlabel Of er al dan niet een opvraging bij VLABEL gebeurt hangt af van verschillende factoren. - Indien opvraging op ondernemingsnummer zullen er nooit VLABEL gegevens opgenomen worden in het antwoord - Indien opvraging op INSZ maar er worden geen gegevens gevonden bij : geen VLABEL opvraging - Indien opvraging op INSZ, er worden gegevens gevonden én GestructureerdeRechtenWoontOp = 0: er worden geen VLABEL gegevens opgehaald - Indien opvraging op INSZ, er worden gegevens gevonden én GestructureerdeRechtenWoontOp = 1: VLABEL gegevens worden opgehaald Onderstaande afbeelding geeft deze logica nog eens weer. 42 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

43 /// Informatie Vlaanderen 5. LOGGING De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven in het document MAGDA logging [ML]. 5.4 BESCHIKBAARHEID De webservice op het MAGDA platform is 24 uur op 24 en 7 dagen op 7 beschikbaar. Bij geplande onbeschikbaarheden worden de afnemers op de hoogte gebracht via mail. Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45

44 Informatie Vlaanderen /// 6 TESTGEGEVENS EN VOORBEELDEN 6.1 TESTGEGEVENS Wat betreft de T&I omgeving is het mogelijk om productieve data op te vragen en dit zowel bij als VLABEL. Testgegevens zijn bijgevolg in principe voldoende voor hande. 6.2 VOORBEELDEN In bijlage een volledig werkende request. Enkel de correcte gebruikersnaam (URI), wachtwoord, Identificatie (URI) en hoedanigheid moeten ingevuld worden. Wijzig het INSZ naar een geldig INSZ vooraleer een request uit te voeren. Untitled.xml 44 /// /// Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0

45 /// Informatie Vlaanderen 7 CONTACTGEGEVENS Informatie Vlaanderen is elke werkdag bereikbaar van 9.00 tot uur. Postadres: Herman Teirlinckgebouw - Havenlaan 88, 1000 Brussel Virginie Lovelinggebouw - Koningin Maria Hendrikaplein 70, 9000 Gent Tel: 02/ helpdesk.magda@vlaanderen.be Gebruikershandleiding Domein Kadaster ZoekEigendomstoestaden 2.0 /// /// 45