AMQP HelsekontaktDefinisjon

HelsekontaktDefinisjon er en melding som brukes til å definere og vedlikeholde et pasientuavhengig kontaktpunkt mellom innbygger og helsetjenesten, for eksempel en avdeling, enhet eller tjeneste. Meldingen beskriver felles egenskaper ved helsekontakten, som identifikator, navn, type og kontaktinformasjon.

HelsekontaktDefinisjon kan gjenbrukes av flere innbyggere og danner grunnlaget for digital dialog og oppfølging på Helsenorge. Selve tilknytningen mellom helsekontakten og den enkelte innbygger håndteres i en separat melding, Helsekontakttilknytning.

API-navn	DIALOG_INBYGGER_HELSEKONTAKTDEFINISJON
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

HelsekontaktDefinisjon benyttes for å formidle informasjon om helsekontakter som det kan opprettes dialog og oppfølging mot på Helsenorge. Meldingen sendes fra avsendersystem og mottas av Helsenorge via AMQP.

Her er info om prosesser og flyt

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

Prosess	Funksjonalitet	Versjon
HelsekontaktDefinisjon	Avsender kan sende informasjon om bahandlingsteam som det skal kunne opprettes helsekontakter mot	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.

Versjon	Rolle	Funksjon	Meldingsinnhold
1.0	Helsepersonell	HelsekontaktDefinisjon	FHIR
1.0	Innbygger	Apprec	Applikasjonskvittering

Sekvensdiagram er vist i figuren under.

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Hodemelding

Hodemeldingen fungerer som transport for selve HelsekontaktDefinisjonen og inneholder informasjon om avsender og mottakende system. Selve helsekontaktdefinisjonen er inkludert i Document-delen av hodemeldingen som en 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 HelsekontaktDefinisjon og skal angis med følgende kodeverdi fra kodeverk 8279 Meldingens funksjon (TODO: legge til i kodeverk):

Kodeverdi	Kodetekst
DIALOG_INBYGGER_HELSEKONTAKTDEFINISJON	HelsekontaktDefinisjon

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 meldingen, 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>

Hodemeldingen skal inneholde en FHIR-ressurs av typen CareTeam.

FHIR-innhold

HelsekontaktDefinisjon representeres som en FHIR CareTeam-ressurs. I denne konteksten benyttes CareTeam til å beskrive et pasientuavhengig kontaktpunkt, og ikke et klinisk behandlingsteam.

FHIR-profilen brukes til å beskrive helsekontaktens felles egenskaper, herunder:

identifikator
navn
type helsekontakt
kontaktinformasjon
støtte for digital dialog

Pasienttilknytning håndteres ikke i denne profilen, men via meldingen Helsekontakttilknytning.

FHIR-profil:
TODO: lenke til profilen

Profilen er basert på CareTeam, med et begrenset sett av støttede felter. Felter som ikke er beskrevet nedenfor er ikke tillatt brukt i denne profilen. Denne CareTeam-profilen er begrenset til bruk for HelsekontaktDefinisjon. Felter som indikerer pasienttilknytning, deltakere eller kliniske roller skal ikke benyttes.

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

Foreløpig er det ikke implementert støtte for noen av feltene med metainformasjon på denne meldingen

Anvendte felter i CareTeam

Felter som ikke er med i tabellen her er ikke støttet i denne CareTeam profilen.

Elementnavn	Påkrevd	Beskrivelse

Elementnavn	Påkrevd	Beskrivelse
identifier	Ja	Unik identifikator for helsekontaktdefinisjonen. Denne identifikatoren benyttes som referanse fra Helsekontakttilknytning. Eks: `<identifier> <system value="urn:ietf:rfc:3986"/> <value value="urn:uuid:bb12c1f4-7d9a-4e1b-9e3a-123456789abc"/> </identifier>`
status	Ja	active \| cancelled \| entered-in-error
category	Ja	Angir type helsekontakt. Verdier skal hentes fra kodeverk 7619 https://finnkode.helsedirektoratet.no/adm/collections/7619 14 - Helseforetak - Spesialisthelsetjeneste 7 - Hjemmetjenester - Kommunale hjemmetjenester (ikke støttet enda, men denne utvikles det støtte for) `<category> <coding> <system value="urn:oid:2.16.578.1.12.4.1.1.7619" /> <code value="14" /> <display value="Spesialisthelsetjenesten" /> </coding> </category>`
name	Ja	Visningsnavn for helsekontakten. Dette navnet benyttes i Helsenorge-grensesnittet og i dialogmeldingene. Eks. `<name value="UNN - Alderspsykiatrisk avdeling" />`
managingOrganization.identifier	Betinget	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. Eks: `<managingOrganization> <identifier> <system value="urn:oid:2.16.578.1.12.4.1.2"/> <value value="8137991"/> </identifier> <extension url="http://helsenorge.no/fhir/StructureDefinition/managingOrganization-type"> <valueCodeableConcept> <coding> <system value="urn:oid:2.16.578.1.12.4.1.1.7619"/> <code value="14"/> <display value="Spesialisthelsetjenesten"/> </coding> </valueCodeableConcept> </extension> </managingOrganization>`
extension: allowedDialogCategory	Frivillig (hvis ikke med, ingen kategori-sering)	Angir hvilke dialogkategorier denne helsekontakten (CareTeam) tillater fra innbygger. Dersom extensionen er angitt, vil innbygger kun få presentert e de angitte kategoriene ved opprettelse av dialog på Helsenorge. Dersom extensionen ikke er angitt, tilbys ingen kategorisering av dialog. Extensionen kan forekomme flere ganger (0..). Datatype:* `CodeableConcept` Binding: Eget kodeverk for dialogkategorier (Volven kodeverk 76xx). Verdiene kan utvides over tid. Foreløpig definerte verdier: 1 – Generelle medisinske spørsmål knyttet til pågående behandling 2 – Endring eller forverring av symptomer 3 – Bilder eller annen dokumentasjon på symptomer 4 – Spørsmål knyttet til sykemelding 5 – Fornyelse av resept 6 – Spørsmål om medisiner 7 – Bivirkninger eller oppfølging av medisin 8 – Spørsmål om prøvesvar eller undersøkelser 9 – Manglende eller uklare resultater 10 – Opplysninger jeg vil dele 11 – Egenregistrering eller rapportering 12 – Tilleggsinformasjon etter kontakt eller time 13 – Faktura eller betaling 14 – Kontakt med kontor 15 – Andre praktiske spørsmål Helseaktøren/avdelingen bestemmer selv hvilke kategorier som tilbys. Eksempel: <extension url="http://helsenorge.no/fhir/StructureDefinition/allowed-dialog-category"> <valueCodeableConcept> <coding> <system value="urn:oid:2.16.578.1.12.4.1.1.76xx" /> <code value="1" /> <display value="Generelle medisinske spørsmål knyttet til pågående behandling" /> </coding> </valueCodeableConcept> </extension> <extension url="http://helsenorge.no/fhir/StructureDefinition/allowed-dialog-category"> <valueCodeableConcept> <coding> <system value="urn:oid:2.16.578.1.12.4.1.1.76xx" /> <code value="6" /> <display value="Spørsmål om medisiner" /> </coding> </valueCodeableConcept> </extension> <extension url="http://helsenorge.no/fhir/StructureDefinition/allowed-dialog-category"> <valueCodeableConcept> <coding> <system value="urn:oid:2.16.578.1.12.4.1.1.76xx" /> <code value="8" /> <display value="Spørsmål om prøvesvar eller undersøkelser" /> </coding> </valueCodeableConcept> </extension>
telecom	Betinget	Telefonnummer som vises på helsekontakten. Skal alltid angis dersom helsekontakten ikke tilbyr digital dialog. Eks: `<telecom> <system value="phone"/> <value value="+4798765432" /> </telecom>`

Eksempel melding

<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="DIALOG_INNBYGGER_HELSEKONTAKTDEFINISJON" DN="HelsekontaktDefinisjon" />
        <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>
    </MsgInfo>
    <Document>
        <RefDoc>
            <IssueDate V="2022-08-18T14:32:28" />
            <MsgType V="A" DN="Vedlegg" />
            <MimeType>application/xml</MimeType>
            <Description>HelseKontaktDefinisjon</Description>
            <Content>
                <CareTeam>
                    <identifier>            
                       <system value="urn:ietf:rfc:3986"/>            
                       <value value="urn:uuid:bb12c1f4-7d9a-4e1b-9e3a-123456789abc"/>        
                    </identifier>
                    <status value="active" />
                    <category>
                        <coding>
                          <system value="urn:oid:2.16.578.1.12.4.1.1.7619" />
                          <code value="14" />
                          <display value="Spesialisthelsetjenesten" />
                        </coding>
                    </category>
                    <name value="UNN - Alderspsykiatrisk avdeling" />
                    <managingOrganization>
                      <identifier>
                        <system value="urn:oid:2.16.578.1.12.4.1.2"/>
                        <value value="8137991"/>
                      </identifier>
                    </managingOrganization>
                    <telecom>
                        <system value="phone"/>
                        <value value="+4798765432" />
                    </telecom>
                </CareTeam>
            </Content>
        </RefDoc>
    </Document>
</MsgHead>

Eksempel melding (med forslag til utvidelse for kategorisering av henvendelser)

<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="DIALOG_INNBYGGER_HELSEKONTAKT" DN="Helsekontakt" />
        <MIGversion>v1.2 2006-05-24</MIGversion>
        <GenDate>2025-10-02T14: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>NORSK HELSENETT SF</OrganisationName>
                <Ident>
                    <Id>112374</Id>
                    <TypeId V="HER" DN="HER-id" S="2.16.578.1.12.4.1.1.9051" />
                </Ident>
                <Organisation>
                    <OrganisationName>Digitale innbyggertjenester (TEST02)</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" DN="Fødselsnummer" S="2.16.578.1.12.4.1.1.8116" />
            </Ident>
        </Patient>
    </MsgInfo>

    <Document>
        <RefDoc>
            <MsgType V="A" DN="Vedlegg" />
            <MimeType>application/xml</MimeType>
            <Description>HelseKontaktDefinisjon</Description>
            <Content>
                <CareTeam>
                    <id value="CareTeam-1" />
                    <status value="active" />
                    <category>
                        <coding>
                          <system value="urn:oid:2.16.578.1.12.4.1.1.7619" />
                          <code value="14" />
                          <display value="Spesialisthelsetjenesten" />
                        </coding>
                    </category>
                    <name value="UNN - Alderspsykiatrisk avdeling" />
                    <!-- Tillatte dialogkategorier -->
                    <extension
                        url="http://helsenorge.no/fhir/StructureDefinition/allowed-dialog-category">
                        <valueCodeableConcept>
                            <coding>
                                <system value="urn:oid:2.16.578.1.12.4.1.1.76xx" />
                                <code value="1" />
                                <display
                                    value="Generelle medisinske spørsmål knyttet til pågående behandling" />
                            </coding>
                        </valueCodeableConcept>
                    </extension>
  
                    <extension
                        url="http://helsenorge.no/fhir/StructureDefinition/allowed-dialog-category">
                        <valueCodeableConcept>
                            <coding>
                                <system value="urn:oid:2.16.578.1.12.4.1.1.76xx" />
                                <code value="2" />
                                <display value="Endring eller forverring av symptomer" />
                            </coding>
                        </valueCodeableConcept>
                    </extension>
  
                    <extension
                        url="http://helsenorge.no/fhir/StructureDefinition/allowed-dialog-category">
                        <valueCodeableConcept>
                            <coding>
                                <system value="urn:oid:2.16.578.1.12.4.1.1.76xx" />
                                <code value="5" />
                                <display value="Fornyelse av resept" />
                            </coding>
                        </valueCodeableConcept>
                    </extension>
  
                    <extension
                        url="http://helsenorge.no/fhir/StructureDefinition/allowed-dialog-category">
                        <valueCodeableConcept>
                            <coding>
                                <system value="urn:oid:2.16.578.1.12.4.1.1.76xx" />
                                <code value="13" />
                                <display value="Faktura eller betaling" />
                            </coding>
                        </valueCodeableConcept>
                    </extension>
                    <managingOrganization>
                    <identifier>
                      <system value="urn:oid:2.16.578.1.12.4.1.2"/>
                      <value value="8137991"/>
                    </identifier>
                  </managingOrganization>
                    <telecom>
                        <system value="phone" />
                        <value value="+4798765432" />
                    </telecom>
                </CareTeam>
            </Content>
        </RefDoc>
    </Document>
</MsgHead>