Atlassian uses cookies to improve your browsing experience, perform analytics and research, and conduct advertising. Accept all cookies to indicate that you agree to our use of cookies on your device. Atlassian cookies and tracking notice, (opens new window)
Notifikasjon Helsekontakt kan benyttes for å sende en ny helsekontakt til innbygger, eller oppdatere en eksisterende helsekontakt
Dersom denne prosessen benyttes for en Helsekontakt som tilbyr Digital Dialog gjelder følgende forutsetninger:
Avsender må være registrert i Adresseregisteret med en Nivå 2 HerId som representerer Helsekontakten
Avsender må være i stand til å ha en elektronisk meldingsutveksling med Helsenorge i henhold til kommunikasjonsprosessen AMQP Dialog helsepersonell
13.nov 2025:
Det er ønsket at en helsekontakt i EPJ kan settes opp med kategorisering av innbygger dialog. Dersom en helsekontakt ønsker slik kategorisering sendes dette med når helsekontakten opprettes.
Formålet er at det i EPJ skal være lettere å se hvilken type henvendelse som mottas og potensielt kunne rute internt til rett type personell for å håndtere henvendelsen.
Innbygger vi i sin dialog funksjon på Helsenorge få valg mellom de aktuelle kategorier som er definert på den aktuelle helsekontakten, og dialogmeldingene vil merkes tilsvarende med hvilken kategori de tilhører.
Dersom en helsekontakt ikke angir noe kategorier, vil dette heller ikke framkomme for innbygger på Helsenorge (og meldingene med en slik helsekontakt vil heller ikke merkes med kategori)
Dokumentasjonen her er oppdatert med forslag til hvordan dette teknisk løses. Det er konseptuelt løst ved at et CareTeam kan ha flere deltagere som er roller i forhold til pasienten.
API-navn
NOTIFIKASJON_INNBYGGER_HELSEKONTAKT
Funksjonelt område
Helsekontakter
API-versjon og dato publisert
v1.0 Apr 28, 2023
Status
I DRIFT
API-dokumentasjon sist endret
Nov 13, 2025
Teknologi
AMQP + FHIR
Prosesser og flyt
Her er info om prosesser og flyt
Følgende prosess skal aktiveres i adresseregisteret for å støtte funksjonaliteten.
Prosess
Funksjonalitet
Versjon
Notifikasjon_Innbygger_Helsekontakt
Avsender kan sende en helsekontakt til innbygger på Helsenorge.
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 for de ulike versjonene.
Hodemelding er å betrakte som transport for selve Helsekontakten og inneholder informasjon om avsender, mottakende system samt pasient for notifikasjonen om en ny- eller endret helsekontakt. Selve Helsekontakten er i sin helhet beskrevet i Document-delen av hodemeldingen i form av FHIR-ressurs.
Den unike id (MsgId) i Hodemeldingen skal være en UUID (Universally Unique Identifier).
Elementet «MsgHead/MsgInfo/Type» skal angi at meldingen er Notifikason - helsekontakt og skal angis med følgende kodeverdi fra kodeverk 8279 Meldingens funksjon:
Kodeverdi
Kodetekst
NOTIFIKASJON_INNBYGGER_HELSEKONTAKT
Notifikasjon til innbygger – Helsekontakt
Elementet «MsgHead/MsgInfo/Ack» skal angi at det kreves applikasjonskvittering på meldingen.
Verdi og kode
<Ack DN="Ja" V="J" />
Informasjon om avsender og mottaker av Hodemeldingen skal være i henhold til beskrivelsen i standardene for tjenestebasert adressering tilgjengelig her:
I avsender av en melding skal informasjon på to organisasjonsnivå oppgis, virksomhet og kommunikasjonspart. Her-id på begge nivåer skal brukes som identifikator. Dette er altså avsender av notifikasjonen, og er ikke relatert til selve helsekontakten.
XML eksempel med “Universitetssykehuset i Nord-Norge HF” som avsender:
I mottager av en melding skal informasjon på to organisasjonsnivå oppgis, virksomhet og kommunikasjonspart. Her-id på begge nivåer skal brukes som identifikator, et XML eksempel er vist under.
For identifikasjon av en pasient benyttes kodeverket «ID-type for personer» 8116, se http://www.volven.no . Skjemaet støtter flere identifikatorer, men for digital dialog benyttes bare en identifikator og det er bare støtte for fødselsnummer eller D-nummer
Følgende informasjon er obligatorisk å oppgi for pasient.
meta.security - Tilgangsbegrensning (betinget) - ikke implementert håndhevelse på Helsenorge pr. 13. november 2025
Denne parameteren kan være med på alle Helsekontakter. Det anbefales at den er med der pasienten er under 16 år (0-16). Parameteren skal være med dersom melding/ressurs inneholder informasjon om en innbygger som er fra og med 12 år og opp til og med 15 år. Elementet er altså "conditional" (og ikke obligatorisk i skjemaet). Parameteren skal angi om det ikke er noen tilgangsbegrensning (dvs. at både foreldre og ungdommen selv har tilgang til informasjonen), eller om bare foreldre har tilgang eller bare ungdommen selv. Årsaken til at vi krever denne er satt når pasienten er 12-16 år, er at den indikerer at det er gjort et bevisst valg/vurdering om hvem som skal ha tilgang til informasjonen. (Selv om konklusjonen er at både foreldre og ungdom kan få tilgang).
Gyldige verdier fra dette kodeverket som kan settes på elementer som kommuniseres med Helsenorge:
N - Normal (både foreldre og ungdom selv har tilgang)
NORN_FORANS - Nektet, foreldreansvarlig. (Kan kun ses og benyttes av ungdommen selv (foreldre vil ikke kunne se eller benttte dette informasjonselementet)).
NORN_UNGDOM - Nektet, ungdom. (Kan kun ses og benyttes av foreldre (ungdommen vil ikke kunne se eller benytte dette informasjonselementet))
Øvrige kodeverdier i Volven 9603 tilsier at pasienten og dens pårørende ikke skal ha innsyn. Slike informasjonselementer skal ikke utveksles med Helsenorge, men holdes igjen i fagsystemene.
<meta>
<security>
<!-- Når pasienten er fra 12 år og til og med 15 år skal avsender angi hvilken vurdering
som er gjort i forhold til om ungdom- og eller foreldre skal kunne ha dialog på Helsekontakten -->
<!-- Volven kodeverk 9603 -->
<system value="urn:oid:2.16.578.1.12.4.1.1.9603"/>
<code value="NORN_FORANS"/>
<display value="Nektet, foreldreansvarlig"/>
</security>
</meta)
Unik forretningsidentifikator for denne EpisodeOfCare. Tilordnes av den som oppretter helseko takten. All senere dialog og andre type hendelser vil refere til denne identifikatoren. Skal være en GUID.
<identifier>
<!-- GUID satt av den som har generert ressursen -->
<system value="urn:ietf:rfc:3986"/>
<value value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
</identifier>
status
Ja
Påkrevd felt. Helsenorge tar enda ikke hensyn til verdien her, men forutsetter "active". Mer forretningslogikk kan bli definert senere. Se under "period.end" for hvordan en helsekontakt "avsluttes".
Elementet skal være med dersom det tilbys digital dialog for denne Helsekontakten. Dersom det ikke tilbys digital dialog for Helsekontakten skal telefonnummer angis i CareTeam, og dette elementet utelates.
Skal peke til en unik HERID i Adresseregisteret.
Adressen vil senere benyttes for digital dialog mellom innbygger og helsekontakten.
Skal være HERID til tjenesteadressen (dvs. HERID nivå 2 i Adresseregistret). NB! Det er ikke krav om at dette er samme HERID som nivå 2 i hodemeldingen, dersom Helsekontakten sendes via AMQP.
Dersom denne er med vil helsekontakten flyttes til "tidligere helsekontakter" når period.end er nådd, og det er ikke lenger mulig å ha dialog med helsekontakten.
referralRequest
Betinget
Dersom helsekontakten er opprettet som resultat av en henvisning skal dette elementet være med. Det kreves at EPJ genererer en ekstern unik business “identifier” (GUID) som entydig identifiserer henvisning.
Eks:
<referralRequest>
<identifier>
<!-- GUID generert som identifiserer den aktuelle henvisning unikt -->
<system value="urn:ietf:rfc:3986"/>
<value value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
</identifier>
</referralRequest>
team
Ja
Referanse til contained FHIR-ressurs CareTeam (under)
Navnet på CareTeam. Altså et fellesnavn for hele teamet (alle deltagere). Merk! Det er dette navnet som blir benyttet som navn på helsekontakten i dialogmeldingene.
Eks.
<name value="UNN - Alderspsykiatrisk avdeling" />
participant.role (forslag utvidelse 2025-11-13)
Frivillig
(hvis ikke med, ingen kategori-sering)
Dersom en helsekontakt ønsker å kategorisere dialog med innbygger kan man angi hvilke roller hos helseaktøren som inngår i et CareTeam. Dersom angitt vil innbygger få tilsvarende valg på Helsenorge. Vi vil registrerer et eget kodeverk for dette formål som benyttes ved opprettelse av helsekontakten og i etterfølgende digital dialog. Verdiene i kodeverket vil kunne utvides etter hvert som man får mer erfaring. Foreløpig er følgende verdier definert (antatt at det registreres som Volven kodeverk 76xx):
1 - Administrativ kontakt
2 - Helsefaglig kontakt
3 - Legemiddel ansvarlig kontakt (benyttes ved ønske om fornying av H-resept)
Helseaktøren/avdelingen bestemmer selv hvilke av disse de ønsker