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

Is de omschrijving van de property 'zakelijkGerechtigdeIdentificatie' duidelijk genoeg? #985

Open melsk-r opened 1 year ago

melsk-r commented 1 year ago

Properties en query parameters met de naam 'zakelijkGerechtigdeIdentificaties'/'zakelijkGerechtigdeIdentificatie' bevatten/krijgen een identificatie van een zakelijk gerechtigde. Zo'n zakelijk gerechtigde is een natuurlijk of niet natuurlijk persoon en je zou dus de neiging kunnen hebben om te denken dat dit tevens de identificatie van een natuurlijk of niet natuurlijk persoon is. Dat is echter niet het geval.

Ik vraag me daarom af of het verstandig is om hierover in de omschrijvingen van deze properties/query parameters duidelijker over te zijn ter voorkoming dat de verkeerde waardes worden meegegeven aan sommige berichten.

Dus i.p.v.

De identificatie van de zakelijk gerechtigde

juist

De identificatie van de zakelijk gerechtigde. Dit is geen identificatie van een natuurlijk of niet natuurlijk persoon

en i.p.v.

Alle personen en rechtspersonen die een zakelijk recht hebben op deze kadastraal onroerende zaak

juist

Alle personen en rechtspersonen die een zakelijk recht hebben op deze kadastraal onroerende zaak. Dit zijn geen identificaties van die natuurlijke of niet natuurlijke personen