Notificeren: verschil tussen versies

Huidige versie van 8 jan 2026 15:21

Deze pagina is onderdeel van de Architectuur Notificeren in het Federatief Datastelsel. Het geeft een algemene beschrijving van wat notificeren is en welke vormen van notificatie bestaan. Het beschrijft vooral een aantal kernbegrippen, die zijn gebaseerd op de architectuur die eerder is opgesteld in VNG project Notificatieservices en de CloudEvents standaard.

Notificeren is het door een aanbieder aan afnemers verstrekken van informatie over binnen zijn domein plaatsgevonden gebeurtenissen. Een gebeurtenis is iets dat plaatsvindt op een bepaald moment in de tijd waardoor de toestand in de werkelijkheid verandert. Deze veranderingen treden typisch op als gevolg van bedrijfsprocessen in de organisatie van de aanbieder.

De waarde van notificeren:

Geïnformeerd worden over gebeurtenissen
Snel kunnen reageren op gebeurtenissen
Hogere robuustheid, flexibiliteit en schaalbaarheid door ontkoppeling van systemen
Mogelijk maken van andere vormen van samenwerking

Er zijn verschillende categorieën van gebeurtenissen:

Een levensgebeurtenis is een gebeurtenis die zich tijdens het leven van een persoon voordoet (zoals een geboorte). Het kan leiden tot een business-gebeurtenis (zoals het aangeven van een geboorte). Een levensgebeurtenis is een specifiek geval van een gebeurtenis die optreedt in de werkelijkheid, los van de trigger in de vorm van een business-gebeurtenis.
Een business-gebeurtenis (of 'bedrijfsgebeurtenis') is een gebeurtenis die plaatsvindt binnen een bepaald businessdomein. Het corrigeren van de aangifte van een geboorte is ook een business-gebeurtenis.
Een systeem-gebeurtenis is een gebeurtenis die plaatsvindt binnen software- of registratiesystemen.

Naast deze categorieën zijn gebeurtenissen ook van een bepaald gebeurtenistype, dat beschrijft wat er is gebeurd in de werkelijkheid. De aangifte van een geboorte is een gebeurtenistype, waarvan er dus heel veel instanties bestaan.

Business-gebeurtenissen en systeem-gebeurtenissen bevatten gegevens over wat er precies is gebeurd. Deze gegevens worden omgezet in een notificatie richting afnemers. Notificaties zijn daarmee de door een aanbieder aan afnemers verstrekte gegevens over binnen zijn domein plaatsgevonden gebeurtenissen. De meest voorkomende, maar niet enige, manier om notificaties te verstrekken is om gebruik te maken van berichten.

Er zijn twee soorten notificaties:

Informatiearme notificaties: deze bevatten weinig informatie over de gebeurtenis, maar kunnen gebruikt worden door afnemers om zelf meer gedetailleerde informatie op te halen.
Informatierijke notificaties: deze bevatten alle beschikbare informatie over de gebeurtenis, op basis waarvan afnemers direct over kunnen gaan tot verwerking.

In technische zin kunnen notificaties worden verzonden naar afnemers (push) of door afnemers worden opgehaald (pull).

In deze architectuur worden ook een aantal begrippen gebruikt die zijn gebaseerd op de CloudEvents standaard. Deze begrippen zijn van toepassing op de applicatielaag en zitten dus op een ander niveau dan begrippen zoals aanbieder, intermediair en afnemer die op organisatieniveau zijn gedefinieerd.

Producer: Een specifieke instantie, proces of apparaat die de datastructuur creëert voor het beschrijven van de gebeurtenis.
Consumer: Ontvangt de notificatie en acteert op basis hiervan. Het gebruikt de context en de gegevens om logica uit te voeren, die weer tot nieuwe events kan leiden.
Intermediary: Ontvangt een bericht die gegevens over een gebeurtenis bevat met als doel om het door te sturen naar de volgende ontvanger, wat een andere intermediary of consumer kan zijn.

Meer informatie over notificeren is te vinden in de uitgebreide documentatie op GitHub die is opgesteld in het project Notificatieservices in 2021 en 2022.

@@ Regel 20: / Regel 20: @@
 Er zijn twee soorten notificaties:
 * Informatiearme notificaties: deze bevatten weinig informatie over de gebeurtenis, maar kunnen gebruikt worden door afnemers om zelf meer gedetailleerde informatie op te halen.
-* Informatierijke notificaties: deze bevatten alle beschikbare informatie over de gebeurtnis, op basis waarvan afnemers direct over kunnen gaan tot verwerking.
+* Informatierijke notificaties: deze bevatten alle beschikbare informatie over de gebeurtenis, op basis waarvan afnemers direct over kunnen gaan tot verwerking.
 In technische zin kunnen notificaties worden verzonden naar afnemers (push) of door afnemers worden opgehaald (pull).