Informatie:Voor de ontsluiting van een MAGDA 2.0 webservice, alsook het generieke proces binnen een 2.0 webservice, wordt verwezen naar Werking en gebruik MAGDA 2.0 Webservices. |
Doel: Met dit sjabloon kan u eenvoudig een nieuwe diensthandleiding aanmaken in Confluence. Gebruik de onderstaande knoppen om nieuwe componenten binnen de handleiding aan te maken. To do: - Vul de onderstaande handleidingsparagrafen in - Maak o.b.v. de specificaties van de dienst relevante subpagina's aan - Verwijder lege of niet-gebruikte paragrafen & pagina's - Let op: Gebruik de volledige naam van de dienst (Domein.DienstNaam-Versie).
De Excerpt bevat de tekst die wordt weergegeven in de overzichtspagina op domein niveau. De tekst die in dit kader staat wordt niet weergegeven in de handleiding zelf (deze pagina) en dient een korte omschrijving van de dienst te bevatten.
Via deze webservice vraagt men de historie op van één specifieke (eigendoms)toestand van een perceel, dit op basis van de identificatiegegevens van een toestand van een perceel. Hierbij kan steeds één stap achteruit en één stap vooruit gekeken worden. Omdat elke mutatie op een perceel leidt tot een nieuwe toestand van een perceel, en dergelijke mutaties sinds 1995 in dossiers worden geregistreerd, bevatten de individuele toestanden ook gegevens van het dossier(s) waarin de mutaties plaatsvonden. |
Via deze webservice vraagt men de historie op van een één specifieke (eigendoms)toestand van een perceel, dit op basis van de identificatiegegevens van een toestand van een perceel. Hierbij kan steeds één stap achteruit en één stap vooruit gekeken worden. Omdat elke mutatie op een perceel leidt tot een nieuwe toestand van een perceel, en een dergelijke mutaties sinds 1995 in dossiers worden geregistreerd, bevatten de individuele toestanden ook gegevens van het dossier(s) waarin de mutaties plaatsvonden.
Deze dienst kadert binnen het domein Kadaster van het MAGDA-platform.
ZoekEigendomstoestanden 2.0
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.Bekomt MAGDA gegevens vanuit AAPD (dus een positief antwoord), 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.
GeefHistoriekMutatiedossier 3.0
De gebruiker doet een opzoeking aan de hand van een dossiernummer, en krijgt de gegevens van het gevraagde dossier. Deze bevat naast de dossiergegevens ook de toestand(en) vóór mutatie en de toestand(en) na mutatie.
Onderstaand sequentiediagram geeft een grafische weergave van de interactie tussen de verschillende kadasterdiensten en de volgorde waarin opzoekingen zouden kunnen plaatsvinden.
In deze specifieke Use Case zoekt de afnemer eerst de Eigendomstoestanden van een persoon op op basis van diens INSZ nummer.
De MAGDA dienst ZoekEigendomstoestanden geeft hierop de gevonden Eigendomstoestanden terug. Deze hebben allemaal een EigendomId.
Met deze EigendomId kan een afnemer vervolgens de historiek van een specifieke Eigendomstoestand opvragen.
De MAGDA dienst GeefHistoriekEigendomstoestand geeft de vorige toestand(en), de volgende toestand(en) en de dossiers waarin de vorige toestand overging in de gevraagde toestand, alsook de dossiers waarin de gevraagde toestand overging naar een volgende toestand (indien de gevraagde toestand niet de huidige toestand is).
Met de vorige of volgende eigendomstoestandid kan verder het verleden of de "toekomst" ingekeken worden
Elke stap terug of vooruit levert weer een nieuwe eigendomstoestandid op waarmee de volgende stap naar voren of naar achteren gezet kan worden.
De afnemer kan eventueel ook met een verkregen dossiernummer, de historiek van een mutatiedossier ophalen.
De MAGDA dienst GeefHistoriekMutatiedossier geeft de gegevens van het mutatiedossier, alsmede de toestanden vóór mutatie en de toestanden na mutatie.
Door afwisseling van het gebruik van GeefHistoriekEigendomstoestand en GeefHistoriekMutatiedossier kan de volledige historiek van het eigendom waarmee gestart is en de dossiers waarin de mutaties plaatsvonden die uiteindelijk geleid hebben tot het gevraagde eigendom, gereconstrueerd worden.
Van waar komen de gegevens in deze dienst? NOOT: Verwijder indien er geen externe gegevensbronnen zijn of deze mededeling niet relevant is onderstaande informatiebel. Maak een koppeling op het woord Opvraging naar het anker lager op de pagina (#opvraging). Deze koppeling kan niet aangemaakt worden in de template.
De authentieke bron van de gegevens is de AAPD.
Meer informatie over hoe deze bronnen gebruikt worden in de opbouw van het antwoord vindt u onder Opvraging.
Opmerking:Agentschap Digitaal Vlaanderen is afhankelijk van de externe bron(nen) voor de kwaliteit en de aanlevering van de gegevens. |
Heeft de afnemer speciale toelatingen / machtigingen nodig voor consumeren van deze dienst?
Om gebruik te kunnen maken van deze dienst dient men een machtiging te hebben die toegang geeft tot deze gegevens en een aansluitingsprocedure te doorlopen.
Informatie:Meer informatie over deze voorwaarden is terug te vinden op de pagina “Machtigingen en toelatingen”. Meer informatie over het aansluitingsproces is terug te vinden op deze webpagina. |
Geef de volledige structuur op van de naam van de bestanden die klaar gezet worden voor de gebruiker. Prefixen zijn steeds in de form [domein].[ServiceNaam]-[Versie]_[timestamp].xml. Pas zeker de bestandsnamen aan in onderstaand voorbeeld als je het hergebruikt. Gebruik geen punt in de versie. Zet de vier cijfers van de versie achter mekaar. Gebruik Camel-case! De lengte van het deel voor de _timestamp mag maximaal 48 karakters lang zijn.
Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.
Prefix | Kadaster.GeefHistoriekEigendomstoestand-03.00 |
---|---|
Voorbeeld | Kadaster.GeefHistoriekEigendomstoestand-03.00_20131103115553530 |
De gebruiker vraagt de historiek van een eigendomstoestand op aan de hand van een eigendomstoestand-ID . Als antwoord vanuit AAPD bekomt men de gevraagde eigendomstoestand, de vorige toestand(en) en de volgende toestand(en), alsook het mutatiedossier waarin de gevraagde toestand tot stand kwam en het mutatiedossier waarin de gevraagde toestand overgaat naar de volgende toestand (voor zover die er zijn).
Concept | Verklaring |
---|---|
Toestand | Het geheel van perceelsgegevens, samen met zijn eigenaars en hun respectieve rechten, vormen de eigendomstoestand van een perceel. Indien er één of meerdere van deze elementen veranderen onstaat een nieuwe toestand. In deze MAGDA dienst heten deze toestanden HistoriekEigendomstoestand, om expliciet het onderscheid te maken met de Eigendomstoestand zoals de dienst GeefEigendomstoestanden die kent. |
Identificatie Toestand | Elke toestand krijgt zijn identificatie. Vóór de inwerkingtreding van STIPAD was dit de combinatie gemeentenummer+artikelnummer+volgnummer. Vóór de inwerkingtreding van CADNET was deze identificatie niet altijd uniek. Na de inwerkingtreding van CADNET is deze combinatie wel uniek. Vanaf de inwerkingtreding van STIPAD is de combinatie vervangen door het eigendomstoestandid: een getal toegekend door de computer. |
Mutatie | De veranderingen aan toestanden noemt men mutaties (verkopen, nieuwbouw, ..) die door de administratie worden verwerkt in mutatiedossiers. |
Mutatiejaar | Het jaartal waarin de verandering plaats heeft gevonden. |
Annulatie van een Toestand | Vanaf de inwerkingtreding van STIPAD is het mogelijk om toestanden te annuleren. Hiermee bedoelt men dat een toestand ooit heeft bestaan, maar foutief was. Door de annulatie vlagt men deze toestand, zonder evenwel hem te verwijderen. Meestal wordt er tegelijkertijd een vervangende toestand geschreven. |
Intermediaire toestand | Vanaf de inwerkingtreding van STIPAD is het mogelijk dat er toestanden bestaan die in éénzelfdemutatiedossier worden gecreëerd en tevens afgesloten. Deze toestanden bestaan dus maar eenfractie van een seconde. |
Opmerking:Uittreksel ConsultImmo handleiding Onderstaande paragraaf is een transcriptie uit de ConsultImmo handleiding. Deze uitleg verklaart waarom de opzet van de historische kadasterdiensten zo generiek is en waarom bijna alle elementen optioneel zijn. Deze informatie is voor afnemers van deze MAGDA dienst zeker van belang. |
Het historisch bestand doorloopt verschillende tijdsvakken, waarbij iedere periode zijn eigen specificiteit heeft wat betreft de verwerking van de kadastrale gegevens.
Periode | Invloed van de verschillende periodes op de historische gegevens | |
---|---|---|
Periode 1 | De digitale verwerking van de kadastrale veranderingen neemt een aanvang op 1.1.1979. Hierbij werden alle actieve percelen op deze datum opgeladen als vertrekbasis. De verwerking van de kadastrale mutatie gebeurde in de buitendiensten op papier, waarna deze geschriften door een centrale dienst werden ingebracht in het computersysteem. Alle kadastrale veranderingen aan een perceel werden per jaar samengenomen in één enkele mutatie. Het voornaamste output-product was de microfiche-reeks die de kadastrale legger weergaf op 1 januari van een jaar. Eenmaal deze microfiches klaar waren, werden de niet-meer-actieve percelen gewist uit de database. |
|
Periode 2 | De CADNET-software maakte het mogelijk om de mutatie door de buitendiensten rechtstreeks in de database te laten inbrengen. Geleidelijk aan werden de mutaties uitgesplitst per gebeurtenis en niet |
|
Periode 3 | De verwerking is identiek aan de Periode 2, maar de niet-actieve percelen werden niet meer verwijderd uit de database, maar bleven bewaard als passieve percelen. |
|
Periode 4 | Het mutatiejaar 2015 is een overgangsperiode van de CADNET-software naar de STIPAD-software. Tijdens deze periode werden de mutaties verwerkt, ofwel met CADNET ofwel met STIPAD. Tijdens |
|
Periode 5 | Vanaf 2016 tot heden gebeurt de verwerking van de mutaties enkel in STIPAD. |
|
Volgende configuratieparameters kunnen ingesteld worden in functie van de machtigingen en de wensen van de afnemer:
Zijn er specifieke parameters die ingesteld kunnen worden?
Configuratieparameters op het MAGDA platform zijn voor deze dienst niet van toepassing
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. Nadien worden de gegevens omgezet naar een AAPD XML en wordt de request uitgevoerd. Indien er bij AAPD geen gegevens gevonden werden voor de vraag verkrijgt men als fout 30001. Bekomt men gegevens, dan worden deze omgezet naar een GeefHistoriekEigendomstoestand reponse.Het antwoord wordt gevalideerd tegenover de xsd waarna het aan de afnemer ter beschikking gesteld wordt.
Welke responstijden worden voor deze dienst als "normaal" beschouwd? Hoe zit het met beschikbaarheid voor deze dienst? Verwijder de algemene informatiebel hieronder indien deze niet relevant zou zijn.
Opmerking:De MAGDA response tijden zijn heel sterk afhankelijk van de response tijden van de bron. Als de brongegevens heel traag worden aangeleverd kan het MAGDA antwoord niet snel worden aangeleverd. |
De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".
De afnemer verwacht vanuit een MAGDA-dienst een Nederlanstalig antwoord. Wanneer een antwoord mogelijk anderstalige informatie bevat is het relevant om dit hier mee te geven.
MAGDA ondersteunt de Nederlandse taal.
Indien in de brongegevens de Nederlandse tekst niet beschikbaar is voor een bepaald element zal de eerste vertaling van de tekst in de brongegevens gebruikt worden, onafhankelijk van de taal waarin dit gegeven beschikbaar is.
Op deze pagina
Binnen deze handleiding
Omgevingsinformatie
Domein | Kadaster |
---|---|
Classificatie | Persoonsgegevens |
Verwante diensten
Voor de functionaliteit verwante diensten wordt gebruik gemaakt van labels. Ken dus een bepaald label toe aan verwante diensten en pas onderstaande macro aan.
Met vragen kunt u steeds terecht bij de MAGDA Service Desk. |