Berichten

Auteur: Jan Brekelmans | Status: TODO

Biedt de mogelijkheid om informatieve berichten of meldingen te versturen aan inwoners. Bijvoorbeeld over een genomen besluit of andere bekendmakingen. Dit werkt hetzelfde als de berichtenbox van MijnOverheid.

Deze service is overgenomen vanuit MijnOverheid en heeft dezelfde functie. Dit leidt tot gelijke informatie in eigen MijnOmgeving van de overheidsinstelling als in MijnOverheid. Voor dit bericht geldt dus dezelfde definitie als voor MijnOverheid.

Vaststellingen

• Bericht = bekendmaking (Van bijvoorbeeld een besluit)

• Bericht moet optionele relatie naar zaak hebben

• Vooralsnog is berichten alleen voor burger/DigiD

• Bericht (zoals in vooronderzoek van Paul) heeft een BSN

• Bericht moet altijd een link naar document (informatieobject) hebben (Link naar DRC)

• 'geopend' vlag is puur UI

• Document kan aan meerdere berichten gekoppeld worden (Dus many - many)

• Besluit, leidt (meestal?) tot bericht

  • Bericht kan ook alleenstaand gemaakt worden (Dus zonder besluit, etc.)

  • OMC kan een bericht genereren in het geval dat een systeemnotificatie tot een bericht moet leiden. Dit is nu geïmplementeerd voor besluiten.

  • Een ZAC kan zelf ook een bericht genereren

• In geval van post, nog steeds digitaal schaduwen (Dus altijd digitaal!)

  • Maar dan geen notificatie nodig

  • Aangeven in bericht dat bijlage ook per post is verstuurd

  • En mag digitaal nooit aangepast of verwijderd worden i.v.m. wetgeving

• Informeren moet gerespecteerd worden (Bij gemeente vastgelegd of notificatie wil ontvangen)

  • Dit moet nog wel een plek krijgen ergens in een systeem. Momenteel geen veld in KlantInteracties API

• Een bericht is voor de burger pas zichtbaar na het verstrijken van de publicatiedatum van het bericht

• Een contactmoment dat een bericht is geplaatst in de Berichtenbox is voor de burger pas zichtbaar na het verstrijken van de publicatiedatum van het bericht

  • Toevoegen aan contactmomenten API Spec…

• Als een bericht per post of naar MBB (dus dubbel) wordt verstuurd, pas je het bericht altijd aan met een algemeen bericht dat de bijlage in MB en de dubbele locatie is verstuurd bijv. ‘U heeft deze bijlage ontvangen via post en MB’

• Bericht flow zoals hier onder beschreven wordt alleen afgetrapt op het moment dat een nieuw ‘Bericht’ object wordt aangemaakt. Een aangepast bericht is namelijk een nieuw bericht.

  • Hierdoor is er geen idempotentie probleem

  • Er is wel een edit actie in het geval dat het bericht wordt aangevuld met een notitie over het versturen van het bericht over meerdere kanalen. Als gevolg van deze edit actie wordt automatisch een systeemnotificatie verstuurd (zoals het ZGW platform werkt) maar hier wordt niks mee gedaan.

  • In het geval van besluiten e.d. waar een publicatiedatum is gevuld, is deze leidend, anders plaatsingsdatum

• Volgens logius: Bericht tekst mag wel urls bevatten maar geen andere opmaak. Een newline is \r\n

  • https://www.logius.nl/domeinen/interactie/mijnoverheid/documentatie/technische-aansluithandleiding-mijnoverheid-berichtenbox

MVP scope

• Voorkeurskanaal; Waarde uit klantsysteem. Daarna onderzoeken hoe machtigingen en andere speciale gevallen te supporten…

Samenhang

Flowchart aanvullen bericht

Wordt alleen uitgevoerd bij bericht - CREATE actie

MO BB = Mijn Overheid BerichtenBox

MB = Mijn Berichten (Gemeentelijk)

Zo lang de integratie met MijnOverheid Berichtenbox nog niet is gebouwd halen we de voorkeur voor digitale post alleen uit de gemeentelijke registratie (Klanten API)

Sequences

Generiek

Afleveren digitale post

Afleveren MO BB

Notificeren

Afleveren per post

Weergave portaal

Besluit

• Trigger op besluitinformatieobject, Wat als er meerdere documenten worden gekoppeld?

  • Of pas als eindresultaat gezet wordt?

  • Kijken naar koppeling aan / naar zaak of publicatie datum

• Ophaalflow: BesluitInformatieObject → Besluit → Zaak → Resultaat?

Van Vincent:

Aanpassing 1 betreft altijd 1 document bij besluit. Dus 1 bericht is 1 document. (MVP) OMC haalt juiste Bodytekst template op vanuit OMC of Notify obv zaaktype en Besluittype OMC haalt juiste prefill gegevens op die nodig zijn om template te vullen (titel Besluit, Zaaktype, data..., basisset voorbereiden, rekening houden dat deze uitgebreid wordt waarschijnlijk OMC voegt template en prefill data samen, incl relatie naar Besluit OMC schrijft Bericht incl bijlage link weg in Objects API

BesluitInformatieObjecten moeten aan de Logius BB aansluitvoorwaarden voldoen (PDF grootte onder (500?)kb.

Bericht opmaak

Bericht structuur

Element	BB Verplicht?	Toelichting
PublicatieDatum	Ja	Tijdstip van verwerken van het bericht of de PublicatieDatum indien deze is ingevuld
Onderwerp	Ja	Onderwerp van het bericht
Berichttekst	Ja	Tekst van het bericht. Mag URL bevatten en /r/n voor newline. Geen verdere opmaak mogelijk (logius standaard)
Referentie (optioneel)	Ja	Berichtreferentie
HandelingsPerspectief	Ja	Benodigde reactie van de geadresseerde (bijv: betalen, informatie verstrekken)
EindDatumHandelingsTermijn	Ja	Termijn waarbinnen de geadresseerde moet reageren
Geopend	Nee	Het bericht is door de geadresseerde geopend of nog niet geopend
BerichtType	Ja	Type bericht. 7 vanuit logius berichtenbox. 5 vanuit de gemeente(?)

Voorbeeld tekst in bericht toevoegen:

Geautomatiseerde toevoeging aan bericht: ‘Dit bericht is zowel in {gemeente} berichten als in de berichtenbox geplaatst’

[Of]

Geautomatiseerde toevoeging aan bericht: 'Dit bericht is zowel in {gemeente} berichten geplaatst als per post verzonden'

Beste {inwoner},

{We hebben een aanslag voor u. Zie bijlages…}

fijne dag…

TODO

Generiek:

1. Paul & Jan B; Sequence voor afwegingen die gemaakt moeten worden om naar de berichtenbox te gaan

   1. (Paul) Zijn er situaties waarbij (kanaal) override nodig is? (Moet bijv. altijd per (aangetekende?) post verstuurd worden) —> Dat bepaalt de uitvoeringsorganisatie. Is niet wettelijk verplicht, is lokaal beleid. Aangetekende post kent MO niet. Er zijn ook Betekende Berichten. D.w.z. dat aan de verzendende organisatie aangegeven wordt of het bericht geopend is. Dat kan alleen als het wettelijke geregeld is voor een organisatie.

      1. Default / fallback kanaal per berichttype of vergelijkbaar?

      2. Bij jurist navragen of voorkeur ‘per post versturen’ uberhaubt genegeerd mag worden in specifieke gevallen

Doorontwikkeling / Techniek

1. Hoe berichtenbox issues handelen? Wat doe je als berichtenbox niet bereikbaar is

   1. Bij OpenWebConcepts hebben ze een ‘interne’ queue

   2. (Paul) Is het een eis van Logius dat je een bericht opnieuw moet kunnen aanleveren? Wordt ondervangen door ebMS. 8x proberen per 3 uur max 1 dag.

      1. Info verzamelen en volgende keer over debateren…

2. (Paul) Vinger aan de pols houden bij het toepassen van een profielservices. Voorkom meerdere profielen. → Bij IA Jop beleggen

3. (Paul) ebMS kan 1x per 24 uur worden bevraagd, kan in geheel (BSN volledige lijst) maar kan ook met delta (BSN mutatie) en BSN validatie (1..1mio en dan als resultaat alleen geldige BSN). WUS beperkt tot 250 BSN’s per vraagbericht (validatie). 1000 bevragingen per dag over alle aangesloten partijen

4. MVP pakken we standaard waarde uit klantsysteem. Daarna onderzoeken hoe machtigingen en andere speciale gevallen

Verdere vragen

• Wat voor extra info moet er beschikbaar zijn?

• Override kanaal - Soms moet het een brief zijn...

• Additionele info per bericht type…?

• Contactmomenten registreren; Wordt altijd een contactmoment aan een klant gehangen of alleen als er geen zaak is

  • Bij OpenWebConcepts; Hangt altijd contactmoment aan klant dmv zaak→rol relatie

• Meerdere documenten/bijlagen bij besluit en/of bericht

  • Bij MOBB; gesplitst tussen

    • max 3 standaard bijlagen van gezamenlijk max grootte van 2Mb die gekoppeld is aan het berichttype (bijv info-folder)

    • max 2 gepersonaliseerde bijlage (gezamenlijke grootte max 500k —> base64). Dus gezamenlijk mogen ze niet meer zijn dan ca. 375Kb omdat base64 30% meer wordt.

  • Besluit; Welke bijlage moet bij een bericht horen? Door medewerker geïdentificeerd? Hoe wordt dit vastgelegd?

  • Gemeentelijk bericht ook rechttrekken met MOBB requirements? (max bijlagen?)

• Hoe om te gaan met printer configuratie? (Gewaarmerkt papier, papiergrootte, etc)

  • Evt extra printconfiguratie meegeven?

  • VNG kan niet specificeren wat de printstraat opties kunnen zijn…

  • Voor notify sturen we al een template id mee… Misschien ook voor printstraat (config)?

• Hoe contactmomenten registreren als niet afgeleverd kan worden? Kan uit het verwerkingsverslag worden gehaald!

  • Contactmoment vastleggen voor bevestiging (Geen hard bounce) of erna?

  • Complete historie is wel handig; Dus contactmoment dat verstuurd is, daarna extra contactmoment in geval van hard bounce

  • (Paul) Hoe hard/soft bounce handelen na aflevering bij Logius

• Burgeronderzoek; Is het duidelijk bij een post contactmoment dat het nog even duurt voordat de post daadwerkelijk aankomt? -> publicatiedatum!

  • Bij MOBB kan het ook tot 24u duren voordat een bericht verwerkt is (beschikbaar is voor de burger (uitgaande van geen publicatiedatum)

[Concept] JSON structuur

https://www.jsonschemavalidator.net/s/rqR7CW2X