Via deze webservice vraagt men de transacties op die hebben plaatsgevonden op onroerende goederen, aan de hand van opzoekcriteria. Deze transacties bevatten de onroerende goederen, de bijbehorende percelen en de met de transactie gemoeide bedragen.
Per perceel worden ook de perceelentiteiten (bijvoorbeeld een gebouw of een tuin) die betrokken waren bij de transactie teruggegeven.

Wijzigingshistoriek

Datum

Aanpassingen

13 Feb 2020  

Situering

Deze dienst kadert binnen het domein Kadaster van het MAGDA-platform.

Verwante diensten

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.

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 AAPD bekomt men de lijst van de eigendomstoestanden en de eigenaars (personen en/of ondernemingen) voor dit perceel.

Deze dienst gaat enkel naar AAPD, er worden geen gegevens opgehaald bij VLABEL.

Gegevensbronnen

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.

Gebruiksvoorwaarden

Afnemers moeten aan volgende voorwaarden voldoen om deze dienst te mogen gebruiken:

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.

Batch

Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.

Functionaliteiten

De gebruiker vraagt de verkoopprijzen op aan de hand van een set zoekcriteria met betrekking tot de transactie en de goederen . Als antwoord vanuit AAPD bekomt men de gevraagde transacties met daarin de betrokken goederen, percelen en verkoopsprijzen. De percelen bevatten daarenboven ook de entiteiten die zich op het perceel bevinden.

Werking

Opties

Volgende configuratieparameters kunnen ingesteld worden in functie van de machtigingen en de wensen van de afnemer:

• Configuratieparameters op het MAGDA platform zijn voor deze dienst niet van toepassing

Anchor
opvraging opvraging

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. 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 ZoekVerkoopprijzen reponse.

Het antwoord wordt gevalideerd tegenover de xsd XSD waarna het aan de afnemer ter beschikking gesteld wordt.

Responsetijden & Beschikbaarheid

Logging

De opvragingen die gebeuren via deze webservice worden bewaard zoals beschreven op de pagina "MAGDA logging".

Ondersteunde talen

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.