VNG-Realisatie / Haal-Centraal-BRK-bevragen

Project repository tbv de ontwikkeling van de Haal Centraal BRK Bevragen API
https://vng-realisatie.github.io/Haal-Centraal-BRK-bevragen/
Other
19 stars 15 forks source link

Aanpassen BRK provider API v1.5 naar v2.0 - zakelijke gerechtigde identificaties & zakelijk gerechtigde links komen niet in het antwoord terug #995

Open norbertveldman opened 6 months ago

norbertveldman commented 6 months ago

Bij het aanpassen van de BRK provider API van v1.5 naar v2.0, zie onze leverancier het volgende: In de nieuw toegevoegde kadastrale onroerende zaken BSN API web-methode, komen de zakelijk gerechtigde identificaties & zakelijk gerechtigde links niet in het antwoord terug. Als dezelfde kadastraal onroerende zaak wordt opgevraagd m.b.v. de kadastrale aanduiding, zijn deze gegevens wel aanwezig. Dit lijkt een issue in de bron?

Wel resultaat via bevraging via kadastrale aanduiding (get) : URL: https://api.brk.kadaster.nl/esd-eto-apikey/bevragen/v2/kadastraalonroerendezaken?kadastraleAanduiding=Odoorn N 2340

image

Geen resultaat via bevraging via BSN 999990482 (post) : URL: https://api.brk.kadaster.nl/esd-eto-apikey/bevragen/v2/kadastraalonroerendezaken Body: {"burgerservicenummer": 999990482}

image

melsk-r commented 6 months ago

Norbert,

Zoals je in de issues 956 en 953 kunt zien traden er in versie 1.5 time-out problemen op op de zakelijkgerechtigden bij het opvragen van een persoon of de kadastraalOnroerendeZaken bij een persoon. Om die reden komen de zakelijk gerechtigde identificaties en zakelijk gerechtigde links dus niet voor in het resultaat van het post bericht van versie 2.0 en moeten in die API de zakelijk gerechtigden via een tweetraps route worden opgevraagd. Het is dus geen issue in de bron maar een weloverwogen ontwerpbeslissing.

fsamwel commented 5 months ago

Hoi @melsk-r ik snap dat keuze gemaakt is, maar de specificaties bevatten wel zakelijkGerechtigdeIdentificaties in de response-definitie (KadastraalOnroerendeZaakHal). Dat veroorzaakt blijkbaar verwarring bij ontwikkelaars die een API client implementeren.

Nu vind ik hierover alleen een opmerking "LET OP: dit endpoint geeft geen informatie over Zakelijk Gerechtigden (zakelijkGerechtigdeIdentificaties) terug bij een KadastraalOnroerendeZaak." Ik denk dat dit niet genoeg is, aangezien de specificaties iets anders suggereren.

Kan je de specificaties niet aanpassen, zodat die alleen dingen bevatten die ook daadwerkelijk geleverd worden? Dat je bijvoorbeeld een KadastraalOnroerendeZaakBeperktHal maakt voor de zoekoperaties?