/
Hendelsevarsel til innbygger

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 i tillegg også motta varsel om hendelsen via pushvarsel/sms/e-post. Dette defineres og avtales for hvert enkelt hendelsesvarsel. Det er innbyggers egne valg på Helsenorge som styrer om innbygger 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.

      • For eksempel 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 image-20240604-062506.png (STS - S2S for nasjonale helseverktøy)

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?

 

  1. 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å anbefalte og obligatoriske varsler: Dvs. innbyggere som har valgt:

  • alle standardvarsler, eller

  • anbefalte og obligatoriske varsler

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

 

  1. Førstegangsvarsel om prøvesvar

Brukes for å informere innbygger første gang de mottar et prøvesvar fra prøvesvartjenesten

Varselnivå anbefalte og obligatoriske varsler: Dvs. innbyggere som har valgt:

  • alle standardvarsler, eller

  • anbefalte og obligatoriske varsler

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

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

  1. Påminnelse fra eksternt nasjonalt verktøy

Brukes for å informere innbygger om viktige hendelser i eksterne nasjonale verktøy som er integrert med Helsenorge.

Se nærmere beskrivelse og forutsetninger som må være oppfylt for å ta dette i bruk: Samspill med Helsenorge for nasjonale helseverktø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) Hendelsevarsel til innbygger

Varselnivå anbefalte og obligatoriske varsler: Dvs. innbyggere som har valgt:

  • alle standardvarsler, eller

  • anbefalte og obligatoriske varsler

Helsenorge kan sende pushvarsel til innbyggere som har aktivert pushvarsel i Helsenorge-appen. For innbyggere som ikke har aktivert pushvarsel, må aktøren/verktøyet sende ut varselet selv på SMS eller e-post direkte 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)

 

  1. Påminnelse fra eksternt behandlerverktøy

    Viktige forhold som alltid skal varsles

    Under implementering - forventes klart ila 2.halvår 2026

Brukes for å informere innbygger om viktige hendelser i eksterne behandlerverktøy som er integrert med Helsenorge. Gjelder forhold som er helt sentrale at innbygger får med seg. Kan sendes fra verktøyet selv eller fra andre fagsystemer.

Se nærmere beskrivelse og forutsetninger som må være oppfylt for å ta dette i bruk: Samspill med Helsenorge for behandlerverktøy

Varselnivå kun obligatoriske varsler: Dvs. alle innbyggere vil får dette varselet, uavhengig av hvilket varselnivå de har valgt.

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

 

  1. Påminnelse fra eksternt behandlerverktøy

    Mindre viktige forhold og som også kan komme relativt hyppig

Brukes for å informere innbygger om forhold som er mindre viktig og som evt. kommer relativt hyppig. i eksterne behandlerverktøy som er integrert med Helsenorge. Kan sendes fra verktøyet selv eller fra andre fagsystemer.

Se nærmere beskrivelse og forutsetninger som må være oppfylt for å ta dette i bruk: Samspill med Helsenorge for behandlerverktøy

Varselnivå anbefalte og obligatoriske varsler: Dvs. innbyggere som har valgt:

  • alle standardvarsler, eller

  • anbefalte og obligatoriske varsler

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

 

  1. Varsel om nytt journaldokument

    Under implementering

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

Varselnivå anbefalte og obligatoriske varsler: Dvs. innbyggere som har valgt:

  • alle standardvarsler, eller

  • anbefalte og obligatoriske varsler

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

 

  1. Påminnelse om vaksinasjon

Brukes for å påminne innbygger om vaksinasjon

Varselnivå anbefalte og obligatoriske varsler: Dvs. innbyggere som har valgt:

  • alle standardvarsler, eller

  • anbefalte og obligatoriske varsler

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

 

  1. Varsel om ny rekvisisjon
    Under implementering

Brukes for å informere innbygger om en ny rekvisisjon

Varselnivå kun obligatoriske varsler: Dvs. alle innbyggere vil får dette varselet, uavhengig av hvilket varselnivå de har valgt.

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

 

  1. Varsel om påminnelse om rekvisisjon
    Under implementering

Brukes for å påminne innbygger om en rekvisisjon

 

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

 

Flere typer kan bli utviklet og tilrettelagt ved behov

For full oversikt over varslene som Helsenorge sender ut i ekstern kanal se: https://helsenorge.atlassian.net/wiki/x/BIDekQ

Prosesser og flyt

Gliffy Diagram

 

Teknisk implementasjon av Hendelsevarsel

Payload

En Hendelsesvarsel er alltid representert ved en FHIR CommunicationRequest: Detaljert beskrivelse: CommunicationRequest - Hendelsesvarsel

REST API

Autorisasjon

Hovedregelen er at HelseID sin autoriseringstjeneste for maskin-til-maskin skal benyttes ved system-til-system-kall mot Helsenorge.

Det finnes et unntak for nasjonale helseverktøy. Nasjonale helseverktøy er verktøy som innbygger kan ta i bruk på egen hånd, og som ikke leveres på vegne av en helsevirksomhet. For nasjonale helseverktøy som omfattes av dette unntaket, kan Innbygger STS benyttes for system-til-system-tilgang ved sending av Hendelsesvarsel. Hendelsesvarsel sendes uavhengig av om innbygger har en aktiv sesjon på Helsenorge eller i det nasjonale helseverktøyet. Kallet utføres i systemkontekst. Innbyggeren som skal motta varslet identifiseres i CommunicationRequest.subject.

HelseId:

  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: 3. Ekstern applikasjon kaller Helsenorge API i systemkontekst

Innbygger STS (kun for nasjonale helseverktøy):

Bruk av Innbygger STS for system-til-system-tilgang er et unntak fra hovedregelen om bruk av HelseID. Bruken må være avklart med Norsk helsenett.

  1. Det nasjonale helseverktøyet må ha en API-klient registrert på Helsenorge for system-til-system-tilgang.

    1. API-klienten må være konfigurert hos Helsenorge med nødvendige tilganger til Hendelsesvarsel og nødvendig sikkerhetsinformasjon for autentisering av klienten.

    2. Verktøyets backend autentiserer API-klienten mot Helsenorge Innbygger STS og henter et AccessToken. System-til-system-token hentes fra STS-en i det aktuelle miljøet.

    3. AccessToken representerer det nasjonale helseverktøyets systemklient og krever ikke at innbygger har en aktiv Helsenorge- eller OIDC-sesjon.

    4. AccessToken sendes som Bearer-token i Authorization-headeren ved kall til Hendelsesvarsel.

    5. Innbyggeren som skal motta Hendelsesvarslet identifiseres i CommunicationRequest.subject med fødselsnummer eller D-nummer.

    6. For hendelsestypen 1010 – Påminnelse fra nasjonalt verktøy skal hendelsen i tillegg referere til det aktuelle nasjonale helseverktøyet i Verktøykatalogen, i henhold til beskrivelsen av CommunicationRequest.

Det er dermed ikke nødvendig å etablere eller opprettholde en aktiv innbyggersesjon for å sende Hendelsesvarsel fra et nasjonalt helseverktøy. Innbygger STS benyttes i dette tilfellet som sikkerhetstjeneste for system-til-system-kallet, ikke for å etablere en aktiv innbyggerkontekst.

 

Bruk av API’et

  • (HTTP POST): Helsenorge bestemmer ressursens ID. FHIR - REST Operasjoner

  • URL til REST API: POST [baseUrl for ekstern-API til HN-system]/videreformidling-fhir/v1/CommunicationRequest

OperationOutcome for nasjonale verktøy (inkludert HTTP kode)

HTTP 201 Created <OperationOutcome xmlns="http://hl7.org/fhir"> <issue> <severity value="information"/> <code value="informational"/> <diagnostics value="Push notification queued"/> </issue> </OperationOutcome> HTTP 201 Created <OperationOutcome xmlns="http://hl7.org/fhir"> <issue> <severity value="information"/> <code value="informational"/> <diagnostics value="Could not queue push notification"/> </issue> </OperationOutcome> HTTP 404 Not Found <OperationOutcome xmlns="http://hl7.org/fhir"> <issue> <severity value="warning"/> <code value="not-found"/> <diagnostics value="Pasienten er ikke digitalt aktiv for tjeneste: {scope}"/> </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.

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

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: Meldingsutveksling med Helsenorge