LO-430 Oplegnotitie Aanpassingen in BRP API
Wat kun je vinden op deze pagina?
LO-430 Oplegnotitie Aanpassingen in BRP API
1 Probleemstelling
1.1 Omschrijving
Sinds LO BRP 2024.Q2 (22 april 2024) verstrekt de BRP API informatie over alle gezagsrelaties van een persoon: van alle minderjarigen waarover de persoon gezag heeft en alle meerderjarigen onder wiens gezag de persoon staat, wordt het burgerservicenummer verstrekt. Dat is voor sommige afnemers wat summier; zouden graag meer informatie over de betreffende personen meegeleverd krijgen. Daarnaast wordt alleen bij GezagNietTeBepalen een toelichting verstrekt waarom het gezag niet te bepalen is, terwijl die ook nuttig zou zijn bij TijdelijkGeenGezag. Verder is het endpoint /bewoningen op dit moment alleen opengesteld voor gemeentes terwijl het ook relevant is voor andere afnemers, en wordt het endpoint /reisdocumenten uitgefaseerd omdat er inmiddels goede alternatieven zijn op het Basisregister Reisdocumenten. In het endpoint /personen is het mogelijk om te zoeken op postcode en huisnummer, maar sommige afnemers vinden het handig als daar (een deel van) de geslachtsnaam aan kan worden toegevoegd om het zoekresultaat te verkleinen. Tenslotte is er nu nog een informatierubriek voor Geheimhouding persoonsgegevens, terwijl dit eigenlijk een andere representatie betreft van de inhoud van rubriek 07.70.10 Indicatie geheim en er dus geen sprake is van informatie in de zin van het experimentbesluit dataminimalisatie BRP.
Strategische keuze
Door zowel de gemeentelijke leveranciers als de RvIG is de voorkeur uitgesproken voor het bouwen van een centrale voorziening die REST API's aanbiedt aan bijhouders en afnemers, waarmee berichten in JSON-formaat kunnen worden uitgewisseld. Dit lost de huidige knelpunten op en kan worden gezien als een eerste stap richting de nieuwe architectuur, zonder daar al te ver op vooruit te lopen.
Deze nieuw te bouwen centrale voorziening kan ingezet worden voor al het huidige berichtenverkeer, maar dit project is een goede aanleiding om te bezien of er van sommige berichtsoorten en berichtencycli afscheid kan worden genomen.
1.2 Herkomst
Deze wijziging is aangevraagd door afnemers bij de Product Owner van het BRP API team.
1.3 Raakvlakken
Er zijn geen raakvlakken met andere LO-wijzigingen.
2 Oplossing
2.1 Huidige situatie
Op dit moment:
- verstrekt de BRP API in het informatieproduct Gezagsrelaties alleen het burgerservicenummer van personen waarmee de bevraagde persoon een gezagsrelatie heeft;
- verstrekt de BRP API alleen een toelichting bij GezagNietTeBepalen;
- is het endpoint /bewoningen alleen opengesteld voor gemeenten;
- is het endpoint /reisdocumenten open voor nieuwe aansluiters;
- kan er nog niet worden gezocht op geslachtsnaam bij de zoekingang ZoekMetPostcodeEnHuisnummer in het endpoint /personen;
- bestaat er een informatierubriek voor Geheimhouding persoonsgegevens.
2.2 Oplossing
De BRP API wordt zodanig uitgebreid, dat die in het informatieproduct PA.GZ.01 Gezagsrelaties niet alleen de burgerservicenummers levert van de minderjarige over wie iemand gezag heeft of de meerderjarigen onder wiens gezag iemand staat, maar ook de volledige naam en de leeftijd van die minderjarige en de volledige naam van de meerderjarige. Daarnaast gaat de BRP API ook een toelichting leveren bij TijdelijkGeenGezag.
Verder wordt het endpoint /bewoningen opengesteld voor alle afnemers, zodat die ervoor geautoriseerd kunnen worden en wordt het endpoint /reisdocumenten juist uitgefaseerd: er worden geen nieuwe afnemers meer op aangesloten.
In het endpoint /personen wordt de zoekingang ZoekMetPostcodeEnHuisnummer uitgebreid met het optionele element geslachtsnaam.
Tenslotte wordt de informatierubriek PA.IN.01 Geheimhouding persoonsgegevens verwijderd uit het LO omdat het hier geen echt informatieproduct betreft.
2.3 Openstaande punten
Er zijn geen relaties met wijzigingen in wet- en regelgeving.
2.4 Openstaande punten
In deze LO-wijziging wordt alleen nog de BRP Berichten API toegevoegd aan het Logisch Ontwerp BRP, als derde mogelijke manier voor het uitwisselen van berichten, naast de MBS en de webservice StuurGBAbericht. In een latere LO-wijziging zal de MBS worden uitgefaseerd (en de beschrijving ervan dus ook worden verwijderd uit het LO). Nog weer later zal ook de webservice StuurGBAbericht worden uitgefaseerd en wordt ook de beschrijving dáárvan uit het LO verwijderd.
3 Invoering
Deze wijziging zal op of rond 1 april worden opgenomen in de productieomgeving van de BRP API en wordt daarom gepland voor LO 2025.Q2.
4 Gevolgen
4.1 Documentatie
Deze wijziging in LO BRP heeft geen gevolgen voor andere logisch ontwerpen (LO BSN, LO BRPk, LO BES en LO PBK), ook niet voor de HUP en de WIR.
4.2 Gemeenten
Geen gevolgen.
4.3 Afnemers
Voor afnemers die al gebruik maken van het informatieproduct Gezagsrelaties in de BRP API verandert het koppelvlak omdat er nieuwe gegevens worden meeverstrekt in dat informatieproduct. Het betreft echter een toevoeging van nieuwe elementen in het JSON-object en daar hoeft programmatuur niet op te worden aangepast als afnemers die nieuwe elementen niet nodig hebben. Verder kunnen afnemers anders dan gemeenten voortaan geautoriseerd worden voor /bewoningen, en kunnen er geen nieuwe afnemers worden geautoriseerd voor /reisdocumenten. Het schrappen van PA.IN.01 Geheimhouding persoonsgegevens heeft geen gevolgen, omdat de BRP API al controleerde of afnemers geautoriseerd waren voor de onderliggende rubriek 07.70.10, en ook protocolleerde dat die rubriek was verstrekt. Daar verandert dus niets aan.
4.4 IND
Geen gevolgen.
4.5 Caribische landen en Caribisch Nederland
Geen gevolgen.
4.6 RvIG-systemen
De BRP API moet conform bovenstaande worden aangepast.
