AMQP Helsekontakttilknytning

Helsekontakttilknytning er en melding som beskriver at en innbygger er knyttet til en bestemt helsekontakt. Meldingen representerer pasientens aktive eller historiske tilknytning til en avdeling, enhet, team eller helsepersonell, og danner grunnlaget for dialog og oppfølging mellom innbygger og helsetjenesten.

Helsekontakttilknytning refererer til en allerede definert Helsekontakt og inneholder informasjon som er spesifikk for den enkelte innbygger og det aktuelle forløpet, som status, periode og organisatorisk ansvar. Selve definisjonen av helsekontakten vedlikeholdes separat og gjenbrukes for flere innbyggere.

API-navn	DIALOG_INBYGGER_HELSEKONTAKTTILKNYTNING
Funksjonelt område	Helsekontakter
API-versjon og dato publisert	v1.0 Apr 14, 2026
Status	Under UTVIKLING
API-dokumentasjon sist endret	Apr 14, 2026
Teknologi	AMQP + FHIR

Prosesser og flyt

Her er info om prosesser og flyt

Følgende prosess skal aktiveres i adresseregisteret for å støtte funksjonaliteten (TODO: oppdatere AR).

Prosess	Funksjonalitet	Versjon
Helsekontakttilknytning	Avsender kan sende en Helsekontaktknytning som girt relasjon mellom Helsekontakt og innbygger med informasjon om hvilke periode knytningen/relasjonen er gyldig	1.0

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Hodemelding

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

XML eksempel:

<MsgId>9713cf31-f4a0-49da-b4d6-75887502f0d3</MsgId>

Elementet «MsgHead/MsgInfo/Type» skal angi at meldingen er Helsekontakttilknytning og skal angis med følgende kodeverdi fra kodeverk 8279 Meldingens funksjon (TODO: oppdatere kodeverk):

Kodeverdi	Kodetekst
DIALOG_INNBYGGER_HELSEKONTAKTTILKNYTNING	Knytning mellom Helsekontakt og inbygger

Elementet «MsgHead/MsgInfo/Ack» skal angi at det kreves applikasjonskvittering på meldingen.

Verdi og kode

Informasjon om avsender og mottaker av Hodemeldingen skal være i henhold til beskrivelsen i standardene for tjenestebasert adressering tilgjengelig her:

Avsender: MsgHead/MsgInfo/Sender

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:

<Sender>
   <Organisation>
      <OrganisationName>UNIVERSITETSSYKEHUSET NORD-NORGE HF</OrganisationName>
      <Ident>
         <Id>9</Id>
         <TypeId V="HER" DN="HER-id" S="2.16.578.1.12.4.1.1.9051" />
       </Ident>
      <Organisation>
         <OrganisationName>Digitale innbyggertjenester</OrganisationName>
         <Ident>
            <Id>8135429</Id>
            <TypeId V="HER" DN="HER-id" S="2.16.578.1.12.4.1.1.9051" />
         </Ident>
      </Organisation>
   </Organisation>
</Sender>

Mottaker: MsgHead/MsgInfo/Receiver

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.

<Receiver>
<Organisation>
		<OrganisationName>Norsk helsenett SF</OrganisationName>
		<Ident>
			<Id>93580</Id>
			<TypeId DN="HER-id" V="HER" S="2.16.578.1.12.4.1.1.9051"/>
		</Ident>
		<Organisation>
			<OrganisationName>Digitale innbyggertjenester</OrganisationName>
			<Ident>
				<Id>93239</Id>
				<TypeId DN="HER-id" V="HER" S="2.16.578.1.12.4.1.1.9051"/>
			</Ident>
		</Organisation>
	</Organisation> 
</Receiver>

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.

fornavn
etternavn
fødselsnummer eller d-nummer

XML eksempel for pasient med fødselsnummer:

<Patient>
	<FamilyName>Danser</FamilyName> 
	<GivenName>Line</GivenName> 
	<Ident>
		<Id>13116900216</Id> 
		<TypeId V="FNR" DN="Fødselsnummer" S="2.16.578.1.12.4.1.1.8116" /> 
	</Ident>
</Patient>

Hodemeldingen skal inneholde en FHIR-ressurs av typen EpisodeOfCare.

FHIR-innhold

For overføring av helsekontakter FHIR ressursen EpisodeOfCare, med referanse til et CareTeam

Metainformasjon om Helsekontakten

For generell informasjon om tilgjengelige opsjoner som kan gjelde alle FHIR-ressurser se: Meta informasjon som kan benyttes for alle FHIR ressurser

Følgende av disse er relevante for Helsekontakt:

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

Kodesystem: Volven kodeverk 9603

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)

EpisodeOfCare

(FHIR-profil http://helsenorge.no/fhir/StructureDefinition/hn-specialist-EpisodeOfCare, basert på EpisodeOfCare.)

Elementnavn	Påkrevd	Beskrivelse

Elementnavn	Påkrevd	Beskrivelse
Identifier	Ja	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	active \| cancelled \| entered-in-error
patient.identifier	Ja	Innbyggers fødselsnummer eller d-nummer. Eks: `<patient> <identifier> <system value="urn:oid:2.16.578.1.12.4.1.4.1" /> <value value="13116900216" /> </identifier> </patient>`
period.start	Ja	Helsekontaktens starttidspunkt Eks: `<period> <start value="2022-08-18T02:00:00+02:00" /> </period>`
period.end	Nei	Helsekontaktens sluttidspunkt 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 CareTeam Eks: `<team> <identifier> <system value="urn:ietf:rfc:3986"/> <value value="urn:uuid:bb12c1f4-7d9a-4e1b-9e3a-123456789abc"/> </identifier> </team>`

Eksempelmelding

<MsgHead xmlns="http://www.kith.no/xmlstds/msghead/2006-05-24"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
    xsi:schemaLocation="http://www.kith.no/xmlstds/msghead/2006-05-24 MsgHead-v1_2.xsd">
    <MsgInfo>
        <Type V="NOTIFIKASJON_INNBYGGER_HELSEKONTAKT" DN="Helsekontakt" />
        <MIGversion>v1.2 2006-05-24</MIGversion>
        <GenDate>2022-08-18T14:32:28</GenDate>
        <MsgId>341c7be7-bf2f-4a41-9cc4-f7489f319a10</MsgId>
        <Ack DN="Ja" V="J" />
        <Sender>
            <Organisation>
                <OrganisationName>UNIVERSITETSSYKEHUSET NORD-NORGE HF</OrganisationName>
                <Ident>
                    <Id>9</Id>
                    <TypeId V="HER" DN="HER-id" S="2.16.578.1.12.4.1.1.9051" />
                </Ident>
                <Organisation>
                    <OrganisationName>Digitale innbyggertjenester</OrganisationName>
                    <Ident>
                        <Id>8135429</Id>
                        <TypeId V="HER" DN="HER-id" S="2.16.578.1.12.4.1.1.9051" />
                    </Ident>
                </Organisation>
            </Organisation>
        </Sender>
        <Receiver>
            <Organisation>
                <OrganisationName>DIREKTORATET FOR E-HELSE</OrganisationName>
                <Ident>
                    <Id>115851</Id>
                    <TypeId V="HER" DN="HER-id" S="2.16.578.1.12.4.1.1.9051" />
                </Ident>
                <Organisation>
                    <OrganisationName>Digitale innbyggertjenester</OrganisationName>
                    <Ident>
                        <Id>8093247</Id>
                        <TypeId V="HER" DN="HER-id" S="2.16.578.1.12.4.1.1.9051" />
                    </Ident>
                </Organisation>
            </Organisation>
        </Receiver>
        <Patient>
            <FamilyName>Sørve von</FamilyName>
            <GivenName>Æss</GivenName>
            <Ident>
                <Id>05073500186</Id>
                <TypeId V="FNR" S="2.16.578.1.12.4.1.1.8116" DN="Fødselsnummer" />
            </Ident>
        </Patient>
    </MsgInfo>
    <Document>
        <RefDoc>
            <IssueDate V="2022-08-18T14:32:28" />
            <MsgType V="A" DN="Vedlegg" />
            <MimeType>application/xml</MimeType>
            <Description>HelseKontakt</Description>
            <Content>
                <EpisodeOfCare xmlns="http://hl7.org/fhir"
                    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
                    xsi:schemaLocation="http://hl7.org/fhir fhir-single.xsd">
                    <identifier>
                        <system value="urn:ietf:rfc:3986"/>
                        <value value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
                    </identifier>
                    <status value="active" />
                    <patient>
                        <identifier>
                            <system value="urn:oid:2.16.578.1.12.4.1.4.1" />
                            <value value="05073500186" />
                        </identifier>
                    </patient>
                    <period>
                        <start value="2022-08-18T02:00:00+02:00" />
                    </period>
                    <referralRequest>
                      <identifier>     
                          <system value="urn:ietf:rfc:3986"/>
                          <value value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
                      </identifier>
                    </referralRequest>
                    <team>        
                        <identifier>            
                           <system value="urn:ietf:rfc:3986"/>            
                           <value value="urn:uuid:bb12c1f4-7d9a-4e1b-9e3a-123456789abc"/>        
                        </identifier>   
                    </team>
                </EpisodeOfCare>
            </Content>
        </RefDoc>
    </Document>
</MsgHead>