Persoon.ZoekPersoonOpNaam-02.02
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.
Situering
Deze dienst kadert binnen het domein Persoon van het MAGDA-platform. Via deze dienst kunnen lijsten van personen opgevraagd worden bij het Rijksregister of bij de KSZ.
Verwante diensten
Na het ontvangen van de lijst van personen kan de volledige informatie van een persoon opgevraagd worden via de GeefPersoon 02.00 of GeefPersoon 02.02 dienst
Gegevensbronnen
Zowel KSZ als Rijksregister kunnen geconsulteerd worden.
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.
Gebruiksvoorwaarden
Afnemers moeten aan volgende voorwaarden voldoen om deze dienst te mogen gebruiken:
Toelating tot het MAGDA-platform
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.
Batch
Deze webservice is eveneens beschikbaar in een batch-variant (enkel XML). Voor meer informatie: Webservice In Batch bevragen.
Prefix | Persoon.ZoekPersoonOpNaam-02_02 |
---|---|
Voorbeeld | Persoon.ZoekPersoonOpNaam-02_02_20131103115553530 |
Functionaliteiten
De webservice ZoekPersoonOpNaam-02.02 laat de afnemer van het MAGDA-platform toe personen op te zoeken in het Rijksregister of de KSZ, dit op basis van verschillende parameters:
Achternaam (zie paragraaf “belangrijke opmerkingen” voor de schrijfwijze van de achternaam en de voornamen).
Tot twee voornamen
Geboortedatum (eventueel met een tolerantie)
Geslacht
NIS-code van de gemeente van woonplaats
Het is mogelijk om enkel op achternaam te zoeken.
Eens de afnemer de request gelanceerd heeft, wordt de vraag doorgestuurd naar het Rijksregister of de KSZ. MAGDA ontvangt het antwoord en transformeert dit naar één of meerdere Persoon-elementen. Afhankelijk van de verkregen machtigingen worden bepaalde gegevens al dan niet gefilterd.
Onderstaande tabel geeft een overzicht van de in de ZoekPersoonOpNaam-02.02 beschikbare persoonsgegevens en hun relatie met de informatietypes van het Rijksregister.
Persoonsgegeven | Rijksregister Informatietype | Rijksregister beschikbaarheid | KSZ beschikbaarheid |
---|---|---|---|
< |