BorgerBeskedService (2024-4)

Owned by Carsten Olsen
Last updated: Jul 31, 2024
9 min read

BorgerBeskedService giver mulighed for at oprette en besked til borger via mail, sms, notifikation på Jobnet eller som en besked mellem to myndigheder. Sidstnævnte er en trådbaseret kommunikationsform, hvor to myndigheder (fx A-kasse og Jobcenter) kan kommunikere med borgeren i midten. De beskeder, der er oprettet, vil borgeren kunne se via JobnetBorgerBeskedService.

Forretningsbeskrivelse

Se også Dialogmodul – beskrivelse typer.

Se også Beskedbakke på Jobnet.

Forretningsmæssig anvendelse af borgerbeskeder i specifikke situationer

Anvendelse af Dialogmodulet / beskedbakken til a-kassens og jobcentrets kommunikation om indstilling om tilbud

A-kassen anvender specifik beskedtype (id 11), der omhandler indstilling om tilbud, der sendes til jobcentret og tillige vises for borgeren i borgerens beskedbakke på Jobnet.

Beskeden vil indeholde

  • En sigende overskrift, der sættes af a-kasse fagsystemet som er eller kan være fælles for alle beskeder med indstilling om tilbud

  • Forslag til mulig titel "A-kassens indstilling til jobcentret om tilbud".

  • En beskedtekst, der i fritekst indeholder a-kassens indstilling af tilbud, herunder fx tilbudstype, forslag til varighed, eventuel konkret virksomhed ved virksomhedsrettede tilbud eller konkret kursusleverandør ved indstilling om vejledning og opkvalificering

  • Der er mulighed for at vedhæfte et dokument / bilag (i form af et pdf- eller xml-dokument), hvor det foreslåede tilbud kan være nærmere beskrevet.

Beskeden vil udover at blive sendt fra a-kasse til jobcenter også blive lagt i borgers beskedbakke på Jobnet og dermed også være synlig for borger på Jobnet.

Notifikation om beskeden vil også være synlig på Jobnet, hvor Jobnet informerer om dette.

CreateMessage

Forretningsregler vedrørende beskedtype "Indstilling om tilbud" (id 11)

  • “Indstilling om tilbud” (Id 11) må kun laves af a-kasse center og må kun anvende "Myndighed til myndighed", dvs. kanal (afsendelseskanal) skal være "Myndighed til myndighed" (Id 4)

  • “Indstilling om tilbud” (Id 11) kan forretningsmæssigt anvendes for følgende personkreds - OBS DFDG validerer ikke for dette:

    • Dagpengemodtager (Kontaktgruppe 1)

Opsætning af besked fra a-kasse til jobcenter

Nedestående beskriver hvordan beskeden med indstilling om tilbud skal sættes op for udvalgte felter, så den vil optræde korrekt for borger på Jobnet og kan modtages og besvares af jobcentret:

Besvarelse af besked

Se eksisterende forretningsregler på CreateBorgebeskedsvar (POST /v1/Borgerbeskedsvar/{borgerbeskedIdentifier})

Lukning af beskedtråd

Det er kun det jobcenter eller den a-kasse, der har oprettet en besked, der kan sættes status på beskeden, herunder lukke en beskedtråd for yderligere dialog.

Anvendelse af Dialogmodulet / beskedbakken til a-kassens og jobcentrets kommunikation om dagpengemodtagere antruffet i kontrolaktion

A-kassen anvender specifik beskedtype (id 12), der omhandler situationer, hvor a-kassen beder jobcentret om at iværksætte tilbud inden for 2 uger, fordi en dagpengemodtager er antruffet i en kontrolaktion, jf. LAB § 38, stk. 2, 2. pkt.

Beskeden vil indeholde

  • En sigende overskrift, der sættes af a-kasse fagsystemet som er eller kan være fælles for alle beskeder med anmodninger om at iværksætte tilbud foranlediget af, at en dagpengemodtager er antruffet i en kontrolaktion, jf. LAB § 38, stk. 2, 2. pkt.

  • Forslag til mulig titel "A-kassen beder jobcentret iværksætte tilbud inden for 2 uger, jf. LAB § 32, stk. 2".

  • En beskedtekst, der i fritekst indeholder en nærmere beskrivelse, fx om dato for hvornår medlemmet er antruffet i kontrolaktion.

  • Der er mulighed for at vedhæfte et dokument / bilag (i form af et pdf- eller xml-dokument), hvis der foreligger et sådant fra Lufthavstilsynets orientering af a-kassen og dette er relevant for jobcentret.

Beskeden vil udover at blive sendt fra a-kasse til jobcenter også blive lagt i borgers beskedbakke på Jobnet og dermed også være synlig for borger på Jobnet (med mindre a-kassen aktivt fravælger dette).

Notifikation om beskeden vil også være synlig på Jobnet, hvor Jobnet informerer om dette.

CreateMessage

Forretningsregler vedrørende beskedtype "Indstilling om tilbud" (id 12)

  • “Antruffet i kontrolaktion - anmodning om iværksættelse af tilbud” (Id 12) må kun laves af a-kasse center og må kun anvende "Myndighed til myndighed", dvs. kanal (afsendelseskanal) skal være "Myndighed til myndighed" (Id 4)

  • “Antruffet i kontrolaktion - anmodning om iværksættelse af tilbud” (Id 12) kan forretningsmæssigt anvendes for følgende personkreds - OBS DFDG validerer ikke for dette (da borger kan have skiftet KG på tidspunktet, hvor beskeden sendes af a-kassen):

    • Dagpengemodtager (Kontaktgruppe 1)

Opsætning af besked fra a-kasse til jobcenter

Nedestående beskriver hvordan beskeden med indstilling om tilbud skal sættes op for udvalgte felter, så den vil optræde korrekt for borger på Jobnet og kan modtages og besvares af jobcentret:

Besvarelse af besked

Se eksisterende forretningsregler på CreateBorgebeskedsvar (POST /v1/Borgerbeskedsvar/{borgerbeskedIdentifier})

Rich text og link funktionalitet ved visning på Jobnet

Jobnet benytter specifik markdown i besked teksten, til at bestemme, hvorvidt tekst i beskedteksten er et link.

Syntaks for visning af links i Jobnet, afsendelseskanal = 3 (Jobnet beskedbakke):

  • Tekst indenfor de kantede parenteser vil fremstå på Jobnet som link teksten.

  • Tekst indenfor de alm. parenteser vil være det link bruger vil blive redirected til ved tryk på link teksten.

  • Links skal starte med http:// eller https://

  • Bemærk at der ikke må være mellemrum imellem den sidste kantede parentes på link teksten og start parentesen på, hvor burger vil blive redirected til.



Link til snitfladebeskrivelser

Link fra forretningsbeskrivelser 

 

BorgerBeskedService

Metoder

Rettigheder til at kalde metoderne

Jobcentre, kommuner og anden aktør

Obs disse erstattes af Scopes

Metode

Alle borgere

Egne borgere

Mulighed for gæsteadgang

Beskrivelse

Metode

Alle borgere

Egne borgere

Mulighed for gæsteadgang

Beskrivelse

CreateMessage



JC, AA(JC)





CreateMessageReply



JC, AA(JC)





GetMessage



JC, AA(JC)





GetMessages



JC, AA(JC)





SetMessageStatus



JC, AA(JC)





SetMessageReplyStatus



JC, AA(JC)





MarkMessage

JC

AA(JC)





GetCitizenMessageDocument



JC, AA(JC), K





A-kasser

Metode

Alle personer

Egne medlemmer

Tidligere medlemmer

Mulighed for gæsteadgang

Beskrivelse

Metode

Alle personer

Egne medlemmer

Tidligere medlemmer

Mulighed for gæsteadgang

Beskrivelse

CreateMessage



X

X





CreateMessageReply



X

X





GetMessage



X

X





GetMessages



X

X





SetMessageStatus



X

X





SetMessageReplyStatus



X

X





MarkMessage

X









GetCitizenMessageDocument



X







CreateBorgerbesked (POST /v1/Borgerbesked)

Metoden bruges til at oprette og sende en besked via en kommunikationskanal. For kommunikationskanaler som SMS, mail og notifikationer på Jobnet, vil dette være at betragte som envejskommunikation til borger, uden mulighed for at borger kan returnere med svar. 

Kommunikationskanalen "myndighed-til-myndighed" er en trådbaseret besked, hvor både myndigheder og borger har mulighed for at tilføje svar. 

Det er muligt at sende beskeden til et antal borgere. 

Beskedteksten har en max. længde som er afhængig af den valgte kanal (fejlkode 8143)

  • SMS 160 karakterer

  • Mail 2000 karakterer

  • Notifikation 500 karakterer

  • Myndighed-til-myndighed 2000 karakterer

Det er alene STAR der kan anvende SMS som afsendelseskanal (fejlkode 9014)

Det er muligt at vedhæfte flere dokumenter og herunder XML og PDF samtidigt, men man gør det ved at bruge vedhaeftetDokumenter tagget flere gange. Det er faktisk en fejl. Fejlen fremgår også af Wiki'en for CreateMessageRequestType idet MessageDocumentCollection er angivet til at være af typen MessageDocumentType. Den burde være MessageDocumentCollectionType. FB79506 holder i problemet til det kan løses når der er andre ændringer til servicen.

Den maksimale dokumentstørrelse er 15 MB.

Forretningsregler

  • Beskeder, der sendes til specifikke jobcentre (til en af afsender specifikt anført jobcenter-id'er) skal sendes til hovedjobcentrets jobcenternummer - og ikke til subjobcentre 

  • Hovedjobcentrets nummer ender på 00; fx 14700 for Jobcenter Frederiksberg

    • Hvis der sendes til et andet specifikt jobcenter-id end hovedjobcentrets, eller borger ikke hører til under jobcentret, kastes fejlkode 9310

  • Work-arorund hvis jobcenter ikke kender a-kasse, som borger er medlem af, eller a-kasse ikke kender jobcentrets id:

    • DFDG erstatter modtagendeMyndighed.organisationskode med borgers a-kasse eller jobcenter i følgende scenarier:

      • Hvis modtagendeMyndighed.organisationskode er "99999" og MessageRecipient.OrganisationType er Jobcenter => DFDG sætter automatisk modtagendeMyndighed.organisationskode til at være borgerens hovedjobcenter

      • Hvis modtagendeMyndighed.organisationskode er "99999" og MessageRecipient.OrganisationType er A-kasse => DFDG sætter automatisk modtagendeMyndighed.organisationskode til at være borgerens a-kasse

CreateBorgerbeskedsvar (POST /v1/Borgerbeskedsvar/{borgerbeskedIdentifier})

Metoden bruges som svar på en eksisterende meddelelse – dermed kan skabes beskedtråd. 

Denne servicemetode kan dog kun anvendes hvis besvarelsestype på den oprindelige besked er sat til værdien "Kan besvares af sagsbehandler" eller "Kan besvares af borger og sagsbehandler" (Borgerkommunikation.BesvarelsestypeCodeList).

Et svar vil altid ske inden for samme kontekst som tråden er blevet oprettet i.

Forretningsregler

  • Beskedtekst

    • Max 2000 karakter 

  • Beskeder til jobcentre skal sendes til hovedjobcentrets jobcenternummer - og ikke til subjobcentre 

    • Hovedjobcentrets nummer ender på 00; fx 14700 for Jobcenter Frederiksberg

Getbeskeder (GET /v1/Beskeder/{borgerbeskedIdentifier})

Metoden bruges til at hente en specifik besked relateret til en borger. Beskeden indeholder hovedbeskeden og evt. tilhørende svar til denne hovedbesked.

Forretningsregler

Alle dialoger og beskeder medtages uanset status for fejloprettet.

Adgang til beskedindhold

  • Borger (Jobnet) har adgang til alle beskeder og alt indhold (bemærk visIBeskedbakke er alene en boolean om beskeder også skal vises i beskedbakken)

  • Jobcenter har adgang til alle beskeder, men for beskeder, hvor det specifikke jobcenter ikke er afsender eller modtager, dvs. beskeder fra andre organisationer (STAR, a-kasser og virksomheder) eller andet jobcenter må indholdet ikke vises. 

  • A-kasse har adgang til alle beskeder, men for beskeder, hvor den specifikke a-kasse ikke er afsender eller modtager, dvs. beskeder fra andre organisationer (STAR, jobcentre og virksomheder) eller andre a-kasser må indholdet ikke vises. 

  • STAR har adgang til alle beskeder, men for beskeder, hvor STAR eller et jobcenter ikke er afsender eller modtager, dvs beskeder fra andre organisationer (a-kasser og virksomheder) må indholdet ikke vises. Alle jobcentre betragtes som en organisation

  • Når en organisation ikke må se indhold erstattes

    • Titel (titel - Titlen på dialogen) med

      • "Besked fra virksomhed" når afsender er en virksomhed

      • "Besked fra jobcenter" når afsender er et jobcenter

      • "Besked fra a-kasse" når afsender er en a-kasse

      • "Besked fra Styrelsen for Arbejdsmarked og Rekruttering"

    • Indhold  (tekst - Tekst dialogen skal indeholde) erstattes med "Du må ikke få adgang til indholdet i denne besked. Det skyldes reglerne om brevhemmelig i Straffeloven."

    • Indhold i svar (borgerbeskedsvar.tekst - Tekst retursvar indeholder) med "Du må ikke få adgang til indholdet i denne besked. Det skyldes reglerne om brevhemmelig i Straffeloven."

    • Vedhæftninger (vedhaeftetDokumenter - dokumenter) medtages ikke 

WSRM-besked (GetCitizenMessageEvent) indeholder af hensyn til brevhemmeligheden ikke selve beskedindholdet længere. WSB indeholder heller ikke selve beskedindholdet.

Getbeskeder (GET /v1/Beskeder)

Metoden bruges til at hente alle de beskeder, der er oprettet for en borger. Af performancemæssige hensyn giver servicemetoden mulighed for kun at returnere hovedbeskeden uden de underliggende svar.

Forretningsregler Alle dialoger og beskeder medtages uanset status for fejloprettet. Rettigheder: Det vil kun være det jobcenter eller den a-kasse borgeren er medlem af, der vil kunne kalde denne servicemetode. Alle andre vil får en fejlmeddelelse om at servicemetoden ikke kan kaldes.

  • Adgang til beskedindhold Samme regler gælder som ved Getbeskeder (GET /v1/Beskeder/{borgerbeskedIdentifier})

UpdateBeskedsvar (PUT /v1/Beskedsvar/{borgerbeskedIdentifier}/action/setstatus)

Denne metode anvendes til at markere at et svar er blevet fejlagtigt oprettet.

Forretningsregler:

  • Status kan kun ændres til "Fejloprettet".

  • Myndighed må kun sætte status for egen svar. (Valideres ikke af DFDG)

  • Der skal i DFDG være historik for statusændringer, inklusiv hvornår den er skiftet til fejloprettet.

UpdateBesked (PUT /v1/Besked/{borgerbeskedIdentifier}/action/setstatus)

Metoden bruges til at angive, om en besked er afsluttet eller fejlagtigt oprettet. Denne servicemetode kan kun anvendes, hvis afsendelseskanal = 4 "Myndighed til Myndighed"

UpdateBesked (PUT /v1/Besked/{borgerbeskedIdentifier}/action/setmarkering)

Metoden bruges til at angive at borgeren, i regi af Jobnet, har fået vist eller har læst beskeden. Metoden anvendes også til at angive at borgeren, i regi af Jobnet, har læst et svar. Vise/læsestatus er i form af en status, dato og tid for hvornår borgeren sidst har fået vist beskeden eller har læst beskeden eller svaret på Jobnet. Metoden anvendes også til at angive at en arbejdsgiver (kontaktperson), har læst en besked eller et svar.

Forretningsregler:

  • Kan angives på alle typer af beskeder, dog med udtagelse af arkiverede beskeder.

  • Kan sættes både i forbindelse med en besked og på et svar.

  • Når der er tale om en tråd, altså en besked med et eller flere svar, så sættes tidspunktet på de svar, som ikke har et tidspunkt samt på beskeden, hvis denne ikke har et tidspunkt.

  • Hver gang MarkMessage anvendes, sættes et nyt tidspunkt med den pågældende MarkMessageIdentifierType, hvis denne ikke allerede er sat.


I forhold betydningen af disse status så betyder:

  • "Vist", at borgeren på Min side på Jobnet har fået vist beskeden på skærmen, Men borgeren har ikke fortaget nogen aktiv handling i forhold til beskeden.

  • "Læst" Borgeren har på Jobnet aktivt valgt beskeden og læst denne. F.eks. ved at borgeren i sin beskedbakke har valgt beskeden og fået beskeden åbent. 

Getbeskeddokument (GET /v1/Beskeddokument/{DocumentIdentifier})

Metoden bruges til at hente et dokument.

Nedenstående metoder forventes ikke at blive medtaget i ny REST service

https://starwiki.atlassian.net/wiki/spaces/FYS/pages/3461218474

CreateHistoricMessage

Metode der bruges i forbindelse med at kunne lægge historiske beskeder ind. f.eks. ved konverteringer.

Forretningsregler

 

  • Uanset hvilken kanal der vælges sker der ikke en afsendelse af WSRM, SMS eller mail.

  • MessageVisibleFromDate skal ligge på eller før dagsdato

  • Hvis beskeden er læst af borger, sættes statusmarkering = Læst af borger (Id 1) og haendelsestidspunkt til tidspunkt for læsning.

  • Borgerkommunikation.BorgerBeskedStatusCodeList kan kun sættes aktiv eller lukket.

    • DFDG validere ikke for dette

CreateHistoricMessageReply

Metode der bruges i forbindelse med at kunne lægge historiske svar ind. f.eks. ved konverteringer.

Forretningsregler

  • Uanset hvilken kanal der vælges sker der ikke en afsendelse af WSRM, SMS eller mail.

  • Eventdag skal ligge på eller før dags dato.

 

 



 

 

Tilgængelighed: https://starwiki.atlassian.net/was