Situering

Dit document beschrijft het gebruik en de werking van de webservice GeefLandbouwer-01.00 zoals deze door Agentschap Digitaal Vlaanderen op het MAGDA platform aangeboden wordt. De opvraging kan gebeuren via verschillende parameters waaronder een ondernemingsnummer of een INSZ.

Het domein waarbinnen de dienst kadert is Landbouw.

Verwante diensten

Wanneer ondernemingsgegevens worden opgevraagd dient eerst te worden gecontroleerd of het opgegeven ondernemingsnummer in de vraag ingeschreven is in het MAGDA onderneming repertorium (OND_REPERTORIUM). Wanneer het gaat om persoonsgegevens dient te worden gecontroleerd of het opgegeven INSZ in de vraag is ingeschreven in het MAGDA personen repertorium (PRS_DSSR). Beide inschrijvingen gebeuren via de diensten Repertorium.RegistreerInschrijving-02.01 en Repertorium.RegistreerUitschrijving-02.00.

Gegevensbronnen

De dienst maakt gebruik van gegevens van het Departement Agentschap Landbouw en VisserijZeevisserij. Voor bevragingen op onderneming, vestiging of persoon geld de voorwaarde dat de onderneming, vestiging of persoon is ingeschreven in het MAGDA- of KSZ-inschrijvingsrepertorium.

Meer informatie over hoe deze bronnen gebruikt worden in de opbouw van het antwoord vindt u onder Opvraging.

Gebruiksvoorwaarden

Om gebruikt 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 webservice GeefLandbouwer-01.00 laat de afnemer van het MAGDA-platform toe om de gegevens van een landbouwer op te vragen. Deze gegevens komen van het Departement Agentschap Landbouw en VisserijZeevisserij, welke de authentieke bron is.

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.

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.