CitizenMessageService (2024-2)

CitizenMessageService 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 JobnetCitizenMessageService.

Udkast til Min plan

Servicen giver også mulighed for, at a-kassen kan sende udkast til Min Plan til jobcentret. Ved fremsendelsen af udkast til Min plan sendes udkastet dels som tekst og dels i et vedlagt XML-dokument (ESCOSTAR-version).

Se XSD (ESCOSTAR-version, der anvendes fra release 2021-3) og eksempel på siden Sagsbehandlerkommunikation via CitizenMessageService

Sammenhænge i kanaler, typer, afsendere m.m. kan ses i bilag fra epic 609.1

Forretningsbeskrivelse

Se også Dialogmodul – beskrivelse typer.

Se også Beskedbakke på Jobnet og hvorledes beskeder fra Kampagnemodulet sendes til beskedbakken.

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, CitizenMessageChannelTypeIdentifier = 3 (Jobnet beskedbakke):

[Link til bm.dk](https://bm.dk)

• 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.

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 (CitizenMessageChannelTypeIdentifierType) skal være "Myndighed til myndighed" (Id 4)

  • Fejlkode 9013 'The submitted MessageType is not allowed for sender' kastes, hvis andre end a-kasse forsøger at oprette beskedtypen

• “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:

• Afsender (UserTypeIdentifier - CitizenMessageUserTypeIdentifierType) sættes til Sagsbehandler (Id 2)

• Organisation (OrganisationTypeIdentifierType) sættes a-kasse (Id 2)

• Svarmulighed (CitizenMessageResponseTypeIdentifierType) sættes til kan besvares af sagsbehandler (Id 3)

• Kontekst / indholdstype (ContextTypeIdentifier - CitizenMessageContextTypeIdentifierType) sættes til "Indstilling om tilbud" (Id 11)

• Titel sættes til en sigende overskrift. 

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

• Se i øvrigt Kommunikation om og med borger og Beskedbakke på Jobnet for en generel beskrivelse.

• Beskedtekst (Text), 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.  Husk der er en max længde på 2000 karakterer i beskedteksten. 

• Kanal (CitizenMessageChannelTypeIdentifierType) sætte til "Myndighed til myndighed" (Id 4)

• Besked skal vises for borger (ShowInMessagebox er sat til sand)

• Vigtighed af besked (MessageImportantIdentifierType) sættes til "Almindelig besked" (Id 1)

• Dokumenttype (DocumentExtensionTypeIdentifier) for et evt. oploadet dokument med nærmere beskrivelse af tilbud sættes til Pdf (Id 1), hvis det er et pdf-dokument.

Besvarelse af besked

Se eksisterende forretningsregler på CitizenMessageService (2023-4)#4)-CreateMessageReply

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 (CitizenMessageChannelTypeIdentifierType) skal være "Myndighed til myndighed" (Id 4)

  • Fejlkode 9013 'The submitted MessageType is not allowed for sender' kastes, hvis andre end a-kasse forsøger at oprette beskedtypen

• “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:

• Afsender (UserTypeIdentifier - CitizenMessageUserTypeIdentifierType) sættes til Sagsbehandler (Id 2)

• Organisation (OrganisationTypeIdentifierType) sættes a-kasse (Id 2)

• Svarmulighed (CitizenMessageResponseTypeIdentifierType) sættes til kan besvares af sagsbehandler (Id 3)

• Kontekst / indholdstype (ContextTypeIdentifier - CitizenMessageContextTypeIdentifierType) sættes til “Antruffet i kontrolaktion - anmodning om iværksættelse af tilbud” (Id 12)

• Titel sættes til en sigende overskrift. 

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

• Se i øvrigt Kommunikation om og med borger og Beskedbakke på Jobnet for en generel beskrivelse.

• Beskedtekst (Text), der i fritekst indeholder en nærmere beskrivelse, fx om dato for hvornår medlemmet er antruffet i kontrolaktion.  Husk der er en max længde på 2000 karakterer i beskedteksten. 

• Kanal (CitizenMessageChannelTypeIdentifierType) sætte til "Myndighed til myndighed" (Id 4)

• Besked skal vises for borger (ShowInMessagebox er sat til sand)

• Vigtighed af besked (MessageImportantIdentifierType) sættes til "Almindelig besked" (Id 1)

• Dokumenttype (DocumentExtensionTypeIdentifier) for et evt. oploadet dokument med nærmere beskrivelse af tilbud sættes til Pdf (Id 1), hvis det er et pdf-dokument.

Besvarelse af besked

Se eksisterende forretningsregler på CitizenMessageService (2023-4)#4)-CreateMessageReply

Metoder

Rettigheder til at kalde metoderne

Jobcentre, kommuner og anden aktør

A-kasser

CreateMessage

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 - The submitted text length exceeds maximum length for the channeltype)

• 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 - The submitted ChannelType is not allowed for sender and messagetype)

Det er muligt at vedhæfte flere dokumenter og herunder XML og PDF samtidigt, men man gør det ved at bruge <MessageDocumentCollection> 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 i praksis omkring 11,2 MB (teknisk begrænsning er 15 MB, når dokumentet er base64 encoded af DFDF).

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 MessageRecipient.OrganisationCode med borgers a-kasse eller jobcenter i følgende scenarier:

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

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

CreateMessageReply

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

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

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

GetMessage

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 ShowInMessagebox er alene en boolean om beskeder også skal vises i beskedbakken)

• Jobcenter har adgang til alle beskeder, men for beskeder, hvor den 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 (Title - 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 rekrutteringsstyrelsen"

  • Indhold  (Text - 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 (MessageReplyCollection.Text - Tekst retursvar indeholder) med "Du må ikke få adgang til indholdet i denne besked. Det skyldes reglerne om brevhemmelig i Straffeloven."

  • Vedhæftninger (MessageDocumentCollection - dokumenter) medtages ikke 

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

GetMessages

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 GetMessage

SetMessageReplyStatus

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.

SetMessageStatus

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

Det er kun den myndighed, der har oprettet beskeden, der kan sættes status for beskeden. Fejlkode 8211 - 'You are not allowed to Update this message since you did not create it'.

MarkMessage

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. 

GetCitizenMessageDocument

Metoden bruges til at hente et dokument.