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

[melsk-r]

Originally created by norbertveldman (kadaster/BRK-bevragen#995):

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

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

[melsk-r]

This comment originally might have been created by someone else.

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.

[melsk-r]

This comment originally might have been created by someone else.

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?