Haal-Centraal-BRK-bevragen
Haal-Centraal-BRK-bevragen copied to clipboard
VNG-Realisatie
Response Zak gerechtigde inconsistent
In het geval van een zak gerechtigde met een persoon dat type "ingeschreven_niet_natuurlijk_persoon" komt de identificatie van persoon niet overeen met de identificatie uit de _links.persoon href link.
{
"identificatie": "50037358",
"type": "artikel5_3b",
"aanvangsdatum": "2018-10-11",
"tenaamstelling": {
"aandeel": {
"noemer": 1,
"teller": 1
},
"isGebaseerdOpStukdeelIdentificaties": [
"1022941586"
],
"stukIdentificaties": [
"20140206000047"
]
},
"zakelijkRecht": {
"stukIdentificaties": [
"18011017010446",
"20200617001838"
],
"isGebaseerdOpStukdeelIdentificaties": [
"1022500606"
],
"isVermeldInStukdeelIdentificaties": [
"32790054",
"32790055"
]
},
"persoon": {
"identificatie": "900000001",
"omschrijving": "Gassie Test B.V.",
"type": "ingeschreven_niet_natuurlijk_persoon"
},
"_links": {
"self": {
"href": "/kadastraalonroerendezaken/56020234070000/zakelijkgerechtigden/50037358"
},
"persoon": {
"href": "/kadasternietnatuurlijkpersonen/440650207"
},
"stukken": [
{
"href": "/stukken/{tenaamstelling.stukIdentificaties}",
"templated": true
},
{
"href": "/stukken/{zakelijkRecht.stukIdentificaties}",
"templated": true
}
],
"stukdelen": [
{
"href": "/stukdelen/{tenaamstelling.isGebaseerdOpStukdeelIdentificaties}",
"templated": true
},
{
"href": "/stukdelen/{zakelijkRecht.isGebaseerdOpStukdeelIdentificaties}",
"templated": true
},
{
"href": "/stukdelen/{zakelijkRecht.isVermeldInStukdeelIdentificaties}",
"templated": true
}
]
}
}
Het is te zien dat persoon een RSIN bevat (als deze kadaster niet natuurlijk persoon apart wordt bevraagd dan is dit gelijk duidelijk) met als waarde "900000001", maar de link naar deze persoon is daarentegen "440650207" wat overeenkomt met de daadwerkelijke kadastrale identificatie. Naar verwachting was identificatie bij persoon ook "440650207" maar nu ontstaat er een verwarring dat het de ene keer een rsin is en de andere keer een kadastrale identificatie. Waarom deze niet altijd het laatste houden?
Daarnaast is het ook opvallend dat een zak gerechtigde met een kadaster natuurlijk persoon altijd een _links.persoon bevat om naar dat kadaster natuurlijk persoon te verwijzen, maar in geval van een ingeschreven natuurlijk persoon dan zal er geen link naar de BRP worden getoond zoals te zien hier:
{
"identificatie": "150561358",
"type": "eigenaar",
"aanvangsdatum": "2018-10-11",
"tenaamstelling": {
"aandeel": {
"noemer": 2,
"teller": 1
},
"burgerlijkeStaatTenTijdeVanVerkrijging": {
"code": "5",
"waarde": "Zie akte(n)"
},
"isGebaseerdOpStukdeelIdentificaties": [
"1014600872",
"1014436359"
],
"stukIdentificaties": [
"18011209006307",
"20021220001664"
]
},
"persoon": {
"identificatie": "71303564",
"omschrijving": "Christiaan de Goede",
"type": "kadaster_natuurlijk_persoon"
},
"_links": {
"self": {
"href": "/kadastraalonroerendezaken/65490485270000/zakelijkgerechtigden/150561358"
},
"persoon": {
"href": "/kadasternatuurlijkpersonen/71303564"
},
"stukken": [
{
"href": "/stukken/{tenaamstelling.stukIdentificaties}",
"templated": true
}
],
"stukdelen": [
{
"href": "/stukdelen/{tenaamstelling.isGebaseerdOpStukdeelIdentificaties}",
"templated": true
}
]
}
}
{
"identificatie": "90283613",
"type": "eigenaar",
"aanvangsdatum": "2018-10-11",
"tenaamstelling": {
"aandeel": {
"noemer": 1,
"teller": 1
},
"isGebaseerdOpStukdeelIdentificaties": [
"1008269067"
],
"stukIdentificaties": [
"18050504014555"
]
},
"persoon": {
"identificatie": "999991905",
"omschrijving": "Linda Haglund",
"type": "ingeschreven_natuurlijk_persoon"
},
"_links": {
"self": {
"href": "/kadastraalonroerendezaken/22310827210003/zakelijkgerechtigden/90283613"
},
"stukken": [
{
"href": "/stukken/{tenaamstelling.stukIdentificaties}",
"templated": true
}
],
"stukdelen": [
{
"href": "/stukdelen/{tenaamstelling.isGebaseerdOpStukdeelIdentificaties}",
"templated": true
}
]
}
}
Ook deze inconsistentie is verwarrend. Graag zien we hier verbetering in zodat het een conformiteit hanteert.
Zie ook mijn reacties in #810
Het idee is dat property "identificatie" de werkelijke functionele identificatie van de persoon bevat. Dus burgerservicenummer of rsin als die er is, anders kadasterpersoonidentificatie.
De link in _links.persoon kan gebruikt worden om de persoon in de BRP of BRK API op te halen. Helaas is er op dit moment nog geen BRP API beschikbaar waarnaar verwezen kan worden. Een gemeente kan die zelf wel hebben gerealiseerd (al dan niet op basis van Haal Centraal specificaties), maar het Kadaster kan die link niet opstellen want kent deze (gemeentelijke) BRP API nu niet. In de toekomst willen we die link wel graag, zodra en een landelijke BRP API beschikbaar is (wordt aan gewerkt door RvIG). Maar in dit geval levert BRK geen link naar BRP omdat het deze niet kent en geen link naar kadasternatuurlijkpersonen, omdat we graag willen dat deze gegevens uit de BRP worden gehaald (bijvoorbeeld via een gemeentelijke BRP API of StuF bg soap service). De client moet voorlopig deze link zelf samenstellen.
@KayodeBakker vind jij dat hier toch al een link naar BRP zou moeten worden opgenomen, bijvoorbeeld in de vorm "{brpserverurl}/ingeschrevenpersonen/{burgerservicenummer}"?
@MelvLee de constructie om in relaties naar personen (in zakelijk gerechtigde) een vast veld "identificatie" te hebben die soms een kadastraalpersoonidentificatie is, soms een burgerservicenummer en soms een rsin, is destijds gemaakt om het voor een client developer makkelijker te maken. Als ik @KayodeBakker hier en in #810 hoor maakt dit het juist ingewikkelder. De client moet dus code maken die op basis van type interpreteert wat de identificatie betekent. Bij een ingeschreven niet-natuurlijk persoon stoppen we de rsin in "identificatie" en maken we in _links de uri op basis van de kadasterpersoonidentificatie.
Heb jij een idee hoe we dit kunnen oplossen zodat de responses duidelijker en eenvoudiger in het gebruik zijn voor gebruikers?
