/
Hendelsevarsel til innbygger

Hendelsevarsel til innbygger

Owned by sven.christiansen
Last updated: Apr 11, 2025 by kjetill.vassmo.lund
5 min read

Dette er en funksjon for å varsle innbyggere via Helsenorge om viktige hendelser som skjer ute i sektoren og som har relevans for innbygger. Funksjonen kan brukes for å informere innbyggere om hendelser i tjenester som vises på Helsenorge, men hvor data er lagret i eksterne løsninger. For eksempel så kan innbygger se prøvesvar på Helsenorge, men fordi prøvesvarene hentes når innbygger går inn på siden, vet ikke Helsenorge at det har kommet nye prøvesvar og kan derfor ikke varsle selv.

Disse varslene vil vises for innbygger under Varsler på Helsenorge. En hendelse refererer til en ressurs som er kjent på Helsenorge, slik at når innbygger klikker på hendelsen, tas innbygger til den aktuelle ressursen. Avhengig av type hendelse det varsles om, kan innbygger også motta varsel om hendelsen via SMS/e-post. Det er Helsenorge som styrer om innbygger skal varsles på sms/e-post. Hvis det defineres at innbygger ikke skal eksplisitt varsels via e-post/SMS om ny hendelse, vil det gjelde alle varsler knyttet til den typen hendelsesvarsel. Det er ikke opp til aktøren selv å avgjøre om det skal sendes SMS/e-post varsel eller ikke.

Hendelsevarsel kan sendes til Helsenorge via API-integrasjon (REST). APIet returnerer respons på om Hendelsevarselet kunne mottas, og dermed vil vises for innbygger på Helsenorge.

Forutsetninger for bruk av Hendelsesvarsel:

  • Hva slags meldinger kan sendes med denne tjenesten:

    • Varsel om hendelser i tjenester som vises på Helsenorge.

    • Eksempelvis nytt prøvesvar eller påminnelse fra verktøy

  • Hvilke aktører kan bruke tjenesten:

    • Offentlig helseaktør, eller aktør med offentlig avtale

    • Aktører med tjenester på Helsenorge

API-navn

Hendelsevarsel

Funksjonelt område

Hendelsemeny

API-versjon og dato publisert

v1.0 Nov 17, 2023

Status

I DRIFT

API-dokumentasjon sist endret

Mar 26, 2025

Teknologi

REST + FHIR image-20240604-062506.png

Krever representasjon

Nei. Ikke relevant

 

Funksjonell beskrivelse

Id

Brukerhistorie

Forretningsmessige akseptansekriterier

 1

Som aktør vil jeg varsle innbygger om hendelse på Helsenorge

slik at innbygger tydelig blir gjort oppmerksom på hendelsen

 

 2

Som aktør vil jeg kunne sende med referanse til en tjeneste eller element som vises på Helsenorge,

slik at innbygger kan ledes direkte til relevant tjeneste eller spesifikt element fra hendelsen

 

3

Som Helsenorge vil jeg vite hva hendelsen gjelder

slik at vi kan vise relevant hendelse og evt varsle innbygger

Innbygger ser et varsel på Helsenorge som inneholder tittel, beskrivelse (valgfri), ikon som representerer hendelsesvarseltypen, tidspunkt for når hendelsesvarslet er mottatt samt lenke til elementet eller siden elementet ligger på.

Innbygger mottar sms/epost i henhold til varselprofilen hvis det er satt opp for hendelsesvarseltypen.

4

Som aktør vil jeg kunne oppgi at foreldre til barn ikke kan se hendelse,

slik at jeg kan ta hensyn til barnets rettigheter.

Støttes ikke i V1, vil implementeres som del av prosjektet der ungdom 13-15 år skal kunne benytte Helsenorge med foreldrenes samtykke.

5

Som aktør vil jeg kunne oppgi at bare foreldrene kan se hendelse jeg sender til et barn, slik at barn ikke får informasjon de ikke bør eksponeres for.

Støttes ikke i V1, vil implementeres som del av prosjektet der ungdom 13-15 år skal kunne benytte Helsenorge med foreldrenes samtykke.

Ulike typer hendelsesvarsler

Type hendelsesvarsel

Beskrivelse

Hvem får varsel om hendelsen på sms/e-post ?

Hvem sender ut varselet om hendelsen til innb ygger på e-post/SMS

Type hendelsesvarsel

Beskrivelse

Hvem får varsel om hendelsen på sms/e-post ?

Hvem sender ut varselet om hendelsen til innb ygger på e-post/SMS

  1. Nytt eller endret prøvesvar

Brukes for å informere innbygger om at de har fått et nytt eller endret prøvesvar i prøvesvartjenesten

Varselnivå normal: Dvs. Innbyggere som har valgt:

  • så mange varsler som mulig, eller

  • standard varsling

Helsenorge sender ut varsel i henhold til innbyggers oppsett på Helsenorge

  1. Hendelse/påminnelse fra eksternt verktøy

Brukes for å informere innbygger om viktige hendelser i eksterne verktøy

Varselnivå normal: Dvs. Innbyggere som har valgt:

  • så mange varsler som mulig, eller

  • standard varsling

Aktøren/verktøyet må sende ut varselet selv på SMS eller e-post dirkete til innbygger. (Innbygger vil se hendelsen på Helsenorge etter innlogging)

  1. Nytt journaldokument (under implementering)

Brukes for å informere innbygger om at de har fått et nytt dokument i pasientjournalen

Varselnivå normal: Dvs. Innbyggere som har valgt:

  • så mange varsler som mulig, eller

  • standard varsling

Helsenorge sender ut varsel i henhold til innbyggers oppsett på Helsenorge

  1. Varsel om endret status i Digital Helsekort for Gravide

Brukes av tjenesten Digitalt Helsekort for Gravide som er under utprøving. Varsler innbygger når status er oppdatert i DHG av helsepersonell.

Varselnivå normal: Dvs. Innbyggere som har valgt:

  • så mange varsler som mulig, eller

  • standard varsling

Helsenorge sender ut varsel i henhold til innbyggers oppsett på Helsenorge

Flere typer kan bli utviklet og tilrettelagt ved behov

For oversikt over de konkrete varslene som Helsenorge sender ut se: https://helsenorge.atlassian.net/wiki/x/BIDekQ

Prosesser og flyt

 

Teknisk implementasjon av Hendelsevarsel

Payload

En Hendelsesvarsel er alltid representert ved en FHIR CommunicationRequest: Detaljert beskrivelse: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/2066120717

REST API

Autorisasjon

HelseId sin autoriseringstjeneste for maskin-til-maskin skal benyttes:

  1. Velg Helsenorge Ekstern API i HelseId sin selvbetjeningsløsning

    1. Velg deretter scope “Hendelsevarsel”

    2. Når tilgangen er godkjent av Helsenorge, kan aksesstoken hentes ut fra HelseId

Se ytterligere detaljer her: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1886191617

AksessToken som mottas fra HelseId eller Helsenorge STS skal deretter være med i Authorization header i alle HTTP-requestene. Se: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/23789578

Bruk av API’et

Ikke implementert - Meldingsbasert integrasjon (AMQP)

Sending av Hendelsesvarsel kan også skje ved meldingsbasert integrasjon. (Vil først implementeres når første aktør har slik behov). Hodemeldingen inneholder da eksakt samme “payload” som det som postes i REST-API’et.

Struktur på AMQP-melding ved meldingsbasert integrasjon

Tjeneste

Hendelsesvarsel

Bruksområde

Ekstern aktør ønsker å sende et hendelsesvarsel til innbygger

Hodemelding

Obligatorisk, og benyttes i henhold til beskrivelse i https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1348174397

Obligatorisk verdi i MsgHead/MsgInfo/Type er:

<Type V="DIALOG_INNBYGGER_HENDELSESVARSEL" DN="Dialog med innbygger – hendelsesvarsel" />

Obligatorisk verdi i MsgHead/MsgInfo/Ack er:

<Ack DN="Ja" V="J"/>

Dialogmelding

Ikke aktuelt å bruke for denne tjenesten.

iCalender

Ikke aktuelt å bruke for denne tjenesten

Helsepersonell

Ikke aktuelt å bruke for denne tjenesten.

Pasientrelasjon

Ikke aktuelt å bruke for denne tjenesten.

Vedlegg

Ikke aktuelt å bruke for denne tjenesten

FHIR ressurs (i Document)

CommunicationRequest: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/2066120717

Støtte for kommunikasjonsprosessen i Adresseregisteret

Følgende prosess skal aktiveres i adresseregisteret for å støtte funksjonaliteten.

Prosessen er ikke etablert i Adresseregisteret ennå og er ikke valgbar.

Prosess

Funksjonalitet

Versjon

Dialog_Innbygger_Hendelsesvarsel

Basisversjon for kommunikasjonsprosess

1.0

Tabellen under viser hvilke roller som inngår i prosessen, hvilke funksjoner de ulike rollene kan gjøre og hvilke meldinger som benyttes.

Versjon

Rolle

Funksjon

Meldingsinnhold

1.0

Innbygger

Applikasjonskvittering

 

Helsepersonell

Hendelsesvarsel

Hodemelding

FHIR CommunicationRequest

Eksempel på bruk av FHIR CommunicationRequest i Hodemelding

<?xml version="1.0" encoding="iso-8859-1"?> <MsgHead xmlns="http://www.kith.no/xmlstds/msghead/2006-05-24"> <MsgInfo> <!-- Meldingens funksjon Volven-kodeverk 8279 --> <Type V="DIALOG_INNBYGGER_HENDELSESVARSEL" DN="Dialog med innbygger - hendelsesvarsel" /> <MIGversion>v1.2 2006-05-24</MIGversion> <GenDate>2023-12-29T11:34:00.0513824+01:00</GenDate> <MsgId>d43723fe-a526-4c00-86b2-da3f4ae52cb8</MsgId> <Ack DN="Ja" V="J" /> <Sender> <Organisation> <OrganisationName>HELSEDIREKTORATET</OrganisationName> <Ident> <Id>2397</Id> <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="Her-id" /> </Ident> <Organisation> <OrganisationName>DD.TEST</OrganisationName> <Ident> <Id>8091467</Id> <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="Her-id" /> </Ident> </Organisation> </Organisation> </Sender> <Receiver> <Organisation> <OrganisationName>Direktoratet for e-helse</OrganisationName> <Ident> <!-- HERID i TEST: 115851, HERID i Prod: ? --> <Id>115851</Id> <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="Her-id" /> </Ident> <Organisation> <OrganisationName>Digitale innbyggertjenester</OrganisationName> <!-- HERID'er i DEV/TEST: TEST01: 8093248, TEST02: 8093247, QA: 8093249, MAS-01: 8093244, MAS-02: 8093239 --> <Ident> <Id>8093248</Id> <TypeId V="HER" S="2.16.578.1.12.4.1.1.9051" DN="Her-id" /> </Ident> </Organisation> </Organisation> </Receiver> </MsgInfo> <Document> <!-- Dette er et selvstendig objekt som inneholder all informasjon knyttet til Hendelsesvarselet. Resten av (hode) meldingen er i utgangspunktet KUN transport. --> <ContentDescription>FHIR CommunicationRequest</ContentDescription> <RefDoc> <MsgType V="XML" DN="XML-instans" /> <Content> <CommunicationRequest> ………….. </CommunicationRequest> </Content> </RefDoc> </Document> </MsgHead>

Generell info om meldingsutveksling med Helsenorge

For overordnet informasjon om meldingsutveksling med Helsenorge se her: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/690913297