AMQP Notifikasjon Helsekontakt

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

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	Jan 9, 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.

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

Sekvensdiagram for prosessen tjenesteoversikt er vist i figuren under.

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.

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

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

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) - ikke implemntert håndhevelse på Helsenorge pr. 9.jan 2025

Denne parameteren kan være med på alle meldinger/ressurser og 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.

EpisodeOfCare

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

CareTeam (contained)

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