Page Comparison

Notifikasjon Helsekontakt kan benyttes for å sende en ny helsekontakt til innbygger, eller oppdatere en eksisterende helsekontakt

Forutsetninger for å bruke denne prosessen er:

Avsender må være registrert i Adresseregisteret med en Nivå 2 HerId som representerer Helsekontakten

Avsender må være i stand

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

Page Properties

API-navn

NOTIFIKASJON_INNBYGGER_HELSEKONTAKT

Funksjonelt område

Helsekontakter

API-versjon og dato publisert

v1.0 28 Apr 2023

Status

Status

colour	Green
title	I DRIFT

API-dokumentasjon sist endret

18 Oct 2023 (Lagt til referanse til henvisning)15 Nov 2023

Teknologi

Status

colour	Purple
title	AMQP

+

Status

colour	Red
title	FHIR

Prosesser og flyt

Her er info om prosesser og flyt

Expand

title	Overordnet flyt og sekvensdiagram

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.

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

Sekvensdiagram for prosessen tjenesteoversikt er vist i figuren under.

Info
Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Hodemelding

Hodemelding er å betrakte som transport for selve Helsekontakten og inneholder informasjon om avsender, mottakende systrem samt pasient for notifikasjonen om en ny- eller endret helsekontakt. Selve Helsekontyakten er i sin helhet bekrevet i Document-delen av hodemelingen i form av FHIR-ressurs.

Expand

title	Krav til elementet «MsgHead/MsgInfo/MsgId»

Den unike id (MsgId) i Hodemeldingen skal være en UUID (Universally Unique Identifier).

XML eksempel:

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

Expand

title	Krav til elementet «MsgHead/MsgInfo/Type»

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

Expand

title	Krav til elementet «MsgHead/MsgInfo/Ack»

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

Verdi og kode

Expand

title	Krav til informasjonsinnhold for avsender og mottaker

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:

Code Block

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

Code Block

<Receiver>
<Organisation>
		<OrganisationName>Direktoratet for e-helse</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>

Expand

title	Krav til informasjonsinnhold for MsgHead/MsgInfo/Patient

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:

Code Block
<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>

Expand

title	Krav til bruk av MsgHead/Document

Hodemeldingen har struktur for å ha null til mange forekomster av MsgHead/Document. Under «Document» vil faginnholdet i en melding være plassert, og faginnholdet er definert i egne xml skjema med FHIR-innhold.

FHIR-innhold

For overføring av helsekontakter benyttes to FHIR ressurser:

EpisodeOfCare
CareTeam (contained ressurs)

EpisodeOfCare

NB! Formell profil ikke oppdatert. Implementasjonsguiden angitt her på Confluence gjelder

MsgHead/MsgInfo/Patient

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:

Code Block
<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>

Expand

title	Krav til bruk av MsgHead/Document

Hodemeldingen skal inneholde en FHIR-ressurs av typen EpisodeOfCare.

FHIR-innhold

For overføring av helsekontakter benyttes to FHIR ressurser:

EpisodeOfCare
CareTeam (contained ressurs)

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)

Denne 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 bevist valg/vurdering om hvem som skal ha tilgang til informasjonen. (Selv om konklusjonen er at både foreldre og ungdom kan få tilgang).

Kodesystem: "http://helsenorge.no/fhir/tilgangsbegrensning

Gyldige verdier:

1 - Ingen begrensning

2 - Kan kun ses av foreldre (ungdom vil ikke kunne se dette informasjonselemnentet selv).

3 - Kan kun ses av ungdommen selv (foreldre vil ikke kunne se dette informasjon selementet),

Code Block
<meta> <security> <Tilgangsbegrensning> <system value="http://helsenorge.no/fhir/tilgangsbegrensning"/> <code value="2" /> <display>Kun foreldre</display> </Tilgangsbegrensning> </security> </meta)

EpisodeOfCare

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

Expand

title	Anvendte felter

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.

Code Block
<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. HJelsenorge tar enda ikke hensyn til verdien her, men forutsetter "active". Mer foretningslogikk kan bli definert senere. Se under "period.end" for hvordan en helskontakt "avsluttes".

type

Ja

Obligatorisk del av kontrakten.

Kodeverk: http://helsenorge.no/fhir/BehandlingsperiodeType

Lovlige verdier:

1 - Kommunal helse og omsorg

2 - Primærhelsetjenesten

3 - Spesialisthelsetjeneste

Eks:

Code Block
<type> <coding> <system value="http://helsenorge.no/fhir/BehandlingsperiodeType"/> <code value="3"/> <display value="Spesialisthelsetjenesten"/> </coding> </type>

patient.identifier

Ja

Innbyggers fødselsnummer eller d-nummer.

Eks:

Code Block
<patient> <identifier> <system value="urn:oid:2.16.578.1.12.4.1.4.1" /> <value value="13116900216" /> </identifier> </patient>

managingOrganization.identifier

Ja

Må være med og skal

managingOrganization.identifier

Betinget

(endret fra “Påkrevd” til “Betinget” 2023-11-15)

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

Code Block
<managingOrganization> <identifier> <system value="urn:oid:2.16.578.1.12.4.1.2" /> <value value="8137991" /> </identifier> </managingOrganization>

period.start

Ja

Helsekontaktens starttidspunkt

Eks:

Code Block
<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 (Nytt element i versjon 1.1)

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 identifiserere henvisning.

Eks:

Code Block

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

Eks:

Code Block
<team> <!-- Referanse til contained ressurs. --> <reference value="#CareTeam-1" /> </team>

CareTeam

NB! Formell profil ikke oppdatert. Implementasjonsguiden angitt her på Confluence gjelder

(contained)

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

Expand

title	Anvendte felter

Elementnavn

Påkrevd

Beskrivelse

id

Ja

Samme id som er benyttet i referansen i EpisodeOdCare (se over)

Eks:

Code Block
<id value="CareTeam-1"/>

Eksempel melding

Expand

Code Block

<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">
                    <contained> 
                        <CareTeam>
                            <id value="CareTeam-1"/>
                            <category>
                                <coding>
                                    <system value="http://helsenorge.no/fhir/BehandlingsteamKategori"/>
                                    <code value="3"/>
                                    <display value="Gruppe"/>  
                                </coding>     
                            </category>
                            <name value="UNN - Alderspsykiatrisk avdeling" />
                            <telecom>
                                <system value="phone"/>
                                <value value="+4798765432" />
                            </telecom>
                        </CareTeam>
                    </contained>
                    <identifier>
                        <!-- GUID satt av den som har generert task'et. Benyttes for å referer dette tasket unikt i forretningsprosessen. 
                             Merk! Dette er ikke ressursidentifieren i FHIR-serveren. -->
                        <system value="urn:ietf:rfc:3986"/>
                        <value value="urn:uuid:aa54d29e-4009-49cb-9ec4-847a6469459d"/>
                    </identifier>
                    <status value="active" />
                    <type>
                        <coding>
                            <system value="http://helsenorge.no/fhir/BehandlingsperiodeType"/>
                            <code value="3"/>
                            <display value="Spesialisthelsetjenesten"/>    
                        </coding>     
                    </type>
                    <!-- Skal alltid vøre med, angir hvilken innbygger denn eEpisodeOfCare tilhører -->
                    <patient>
                        <identifier>
                            <system value="urn:oid:2.16.578.1.12.4.1.4.1" />
                            <value value="05073500186" />
                        </identifier>
                    </patient>
                    <managingOrganization>
                        <!-- Skal være HERID på nivå 2 for den organisasjon som er ansvarlig for denne behandlingen
                             Dennme HERID benyttes for digital dialog med Helsekontakten. -->
                        <identifier>
                            <system value="urn:oid:2.16.578.1.12.4.1.2" />
                            <value value="8135429" />
                        </identifier>
                    </managingOrganization>
                    <period>
                        <start value="2022-08-18T02:00:00+02:00" />
                    </period>
                    <team>
                        <!-- Referanse til contained ressurs. -->
                        <reference value="#CareTeam-1" />
                    </team>
                </EpisodeOfCare>
            </Content>
        </RefDoc>
    </Document>
</MsgHead>

Versions Compared

Old Version 21

New Version Current

Key

Prosesser og flyt

Hodemelding

FHIR-innhold

EpisodeOfCare

FHIR-innhold

Metainformasjon om Helsekontakten

EpisodeOfCare

CareTeam

(contained)

Eksempel melding