Wat kun je vinden op deze pagina?
LO-469 Null-bericht in BRP Berichten API
1 Probleemstelling
1.1 Omschrijving
Volgens het Logisch Ontwerp BRP bevat het Null-bericht (ook wel de Verwerkbevestiging genoemd) geen berichtkop en geen berichtinhoud. In termen van de mailboxserver en het sPd-protocol: de MessageBody is leeg. Bij het ontwerp van de BRP Berichten API is er echter voor gekozen om óók bij het Null-bericht het element berichtType op te nemen in de berichtkop, om ervoor te zorgen dat het element berichtInhoud geen leeg JSON-object is en ook om te zorgen dat op dit punt alle berichttypen het element berichtType ín de berichtInhoud hebben staan. Daarmee zijn de specificaties van de BRP Berichten API gaan afwijken van het Logisch Ontwerp en dat wordt met deze wijziging in orde gebracht door het Logisch Ontwerp aan te passen.
1.2 Herkomst
Deze wijziging komt voort uit de constatering (tijdens testen) dat de specificaties van de BRP Berichten API afwijken van het Logisch Ontwerp.
1.3 Raakvlakken
Er zijn vooralsnog geen raakvlakken met andere LO-wijzigingen.
2 Oplossing
2.1 Huidige situatie
In de huidige definitie van het Null-bericht is als volgt: zowel de kop als de inhoud zijn leeg (LO BRP, par. 5.4.9.2).
2.2 Oplossing
Het Null-bericht in het nieuwe JSON-formaat moet voortaan het element berichtType bevatten in de kop van het bericht. Null-berichten in het oude TLV-formaat die worden uitgewisseld via de mailboxserver of via de webservice StuurGBAbericht, blijven zoals ze zijn: leeg.
In par. 5.4.9.2 van het LO BRP wordt de definitie van het Null-bericht dan dus als volgt:
| Berichtnummer | Null |
| Berichtnaam | Verwerkbevestiging (Null-bericht) |
| Omschrijving | Bericht dat in bepaalde cycli wordt verstuurd ter bevestiging van de verwerking van de gegevens die opgenomen zijn in het eraan voorafgaande bericht in de cyclus. |
| Te verzenden door | gemeente, RNI, terugmeldvoorziening, afnemer, BRP-V |
| Te verzenden aan | gemeente, RNI, IND, RvIG |
| Volgt op bericht | Av01, Cb01, Ct01, Cw01, Dt01, Dw01, Iv01, Jv01, Og11, Rv01, Tb02, Tv01 en Wa01 |
| Wordt gevolgd door | |
| Kop bevat | berichtnummer = 4 posities (alléén in het JSON- berichtformaat) |
| Inhoud bevat |
NB: in par. 5.1.7.1 staat bij de beschrijving van het kop-element “berichtnummer” vermeld dat dit element in de BRP Berichten API wordt aangeduid als “berichtType”. Omwille van de consistentie in de beschrijving van alle berichten gebruiken we hier tijdelijk “Berichtnummer”. Wanneer de mailboxserver, de webservice StuurGBAbericht en dus ook het TLV-berichtformaat worden uitgefaseerd, zullen deze benamingen overal in het LO in lijn worden gebracht met de naamgeving in de BRP Berichten API.
2.3 Openstaande punten
Er zijn na implementatie van deze LO-wijziging geen openstaande punten.
3 Invoering
Aangezien de specificaties van de BRP Berichten API al vereisen dat berichtType is opgenomen in de kop van het Null-bericht, en bij nieuwe aansluitingen op de BRP Berichten API wordt getest tegen die specificaties, zou deze wijziging in het Logisch Ontwerp geen impact moeten hebben op bestaande systemen. Daarom wordt deze wijziging opgenomen in LO BRP versie 2027.Q1 van 1 januari 2027.
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) en ook niet voor de HUP en de WIR.
4.2 Gemeenten
Geen gevolgen.
4.3 Afnemers
Geen gevolgen.
4.4 IND
Geen gevolgen.
4.5 Caribische landen en Caribisch Nederland
Geen gevolgen.
4.6 RvIG-systemen
Geen gevolgen.