Hendelsevarsel til innbygger

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 pushvarsel/sms/e-post. Det er Helsenorge som styrer om innbygger skal varsles på pushvarsel/sms/e-post. Hvis det defineres at innbygger ikke skal eksplisitt varsels via pushvarsel/sms/e-post 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 pushvarsel/sms/e-post 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 om noe i et 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
Krever representasjon	Nei. Ikke relevant

Funksjonell beskrivelse

Brukerhistorie	Forretningsmessige akseptansekriterier

Brukerhistorie	Forretningsmessige akseptansekriterier
Som aktør vil jeg varsle innbygger om hendelse på Helsenorge slik at innbygger tydelig blir gjort oppmerksom på hendelsen
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
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 pushvarsel/sms/epost i henhold til varselinnstillinger hvis det er satt opp for hendelsesvarseltypen.
Som aktør vil jeg kunne oppgi at foreldre til barn ikke kan se hendelse, slik at jeg kan ta hensyn til barnets rettigheter.	Foreldre vil ikke motta pushvarsel/sms/epost og ser ikke varsel inne på Helsenorge for hendelsesvarselet
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.	Ungdom 13-16 vil ikke motta pushvarsel/sms/epost og ser ikke varsel inne på Helsenorge for hendelsesvarselet

Ulike typer hendelsesvarsler

Type hendelsesvarsel	Beskrivelse	Hvem får varsel om hendelsen på pushvarsel/sms/e-post ?	Hvem sender ut varselet om hendelsen til innbygger på pushvarsel/sms/e-post?

Type hendelsesvarsel	Beskrivelse	Hvem får varsel om hendelsen på pushvarsel/sms/e-post ?	Hvem sender ut varselet om hendelsen til innbygger på pushvarsel/sms/e-post?
Varsel om 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å standard: Dvs. Innbyggere som har valgt: så mange varsler som mulig, eller standard varsling	Helsenorge sender ut varsel i henhold til innbyggers varselinnstillinger på Helsenorge
Påminnelse fra eksternt nasjonale verktøy	Brukes for å informere innbygger om viktige hendelser i eksterne nasjonale verktøy. I tillegg til standard regler for REST operasjoner varsles avsender med bruk av OperationOutcome i når pushvarselet er lagt på kø og når det ikke legges på kø (dvs. går rett ut eller feiler) https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/2065727489/Hendelsevarsel+til+innbygger#OperationOutcome-for-nasjonale-verkt%C3%B8y	Varselnivå standard: 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 siden denne type verktøy ikke har lov til å hente ut og benytte informasjon fra Kontakt og reservasjonsregistert. (Innbygger vil se hendelsen på Helsenorge etter innlogging)
Påminnelse som gjelder eksterne behandlerverktøy (under implementering)	Brukes for å informere innbygger om viktige hendelser i eksterne behandlerverktøy. Kan i prinsippet sendes fra verktøyet selv eller andre fagsystemer.	Varselnivå standard: Dvs. Innbyggere som har valgt: så mange varsler som mulig, eller standard varsling	Helsenorge sender ut varsel i henhold til innbyggers varselinnstillinger på Helsenorge
Varsel om nytt journaldokument (under implementering)	Brukes for å informere innbygger om at de har fått et nytt dokument i pasientjournalen	Varselnivå standard: Dvs. Innbyggere som har valgt: så mange varsler som mulig, eller standard varsling	Helsenorge sender ut varsel i henhold til innbyggers varselinnstillinger på Helsenorge
Påminnelse om vaksinasjon (under implementering)	Brukes for å påminne innbygger om vaksinasjon	Varselnivå standard: Dvs. Innbyggere som har valgt: så mange varsler som mulig, eller standard varsling	Helsenorge sender ut varsel i henhold til innbyggers varselinnstillinger på Helsenorge
Varsel om tilgang til behandlingshjelpemidler (under implementering)	Brukes for å informere innbygger om at de har fått tilgang til behandlingshjelpemidler	Varselnivå standard: Dvs. Innbyggere som har valgt: så mange varsler som mulig, eller standard varsling	Helsenorge sender ut varsel i henhold til innbyggers varselinnstillinger 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:

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

Bruk av API’et

(HTTP POST): Helsenorge bestemmer ressursens ID. https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1254654012/FHIR+-+REST+Operasjoner#Create---HTTP-POST
URL til REST API: POST [baseUrl for ekstern-API til HN-system]/videreformidling-fhir/v1/CommunicationRequest
- Se her for oversikt over baseURL’er til de forskjellige systemene: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1552384092

OperationOutcome for nasjonale verktøy

<OperationOutcome xmlns="http://hl7.org/fhir">
    <issue>
        <severity value="warning"/>
        <code value="informational"/>
        <diagnostics value="Push notification queued"/>
    </issue>
</OperationOutcome>

<OperationOutcome xmlns="http://hl7.org/fhir">
    <issue>
        <severity value="warning"/>
        <code value="informational"/>
        <diagnostics value="Could not queue push notification"/>
    </issue>
</OperationOutcome>

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.

Se prinsippene for meldingsbasert integrasjon med FHIR API’er på helsenorge: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/2050719804

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