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

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

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.

Gebruiksvoorwaarden

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.

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

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