Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Notifikasjon Helsekontakt kan benyttes for å sende en helsekontakt til innbygger.

Forutsetninger for å bruke denne prosessen er:

  • Avsender må kunne markere enkelte tjenester som digitale innbyggertjenester

  • Avsender må være i stand til å ha en elektronisk meldingsutveksling med Helsenorge.no

Page Properties

API-navn

NOTIFIKASJON_INNBYGGER_HELSEKONTAKT

Funksjonelt område

Helsekontakter

API-versjon og dato publisert

v0.9

Status

Status
colourYellow
titleI test

API-dokumentasjon sist endret

Teknologi

Status
colourPurple
titleAMQP

Prosesser og flyt

Her er info om prosesser og flyt

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

Innbygger

Apprec

Applikasjonskvittering

Helsepersonell

Helsekontakt

FHIR

Sekvensdiagram for prosessen tjenesteoversikt er vist i figuren under.

Info

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Hodemelding

Hodemelding vil inneholde informasjon om avsender, mottaker og pasient. Hodemelding vil også inneholde teknisk informasjon som unik id og tidspunkt for generering. Nedenfor beskrives de viktigste delene av standarden som slik den skal brukes for orientering om tjenestetilbud

Expand
titleKrav 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
titleKrav til elementet «MsgHead/MsgInfo/Type»

Elementet «MsgHead/MsgInfo/Type» skal angi at meldingen er Tjenesteoversikt. Innholdet skal angis med følgende kodeverdi fra kodeverk 8279 Meldingens funksjon:

Kodeverdi

Kodetekst

NOTIFIKASJON_INNBYGGER_HELSEKONTAKT

Notifikasjon til innbygger – Helsekontakt

Expand
titleKrav til informasjonsinnhold for avsender og mottaker

Informasjon om avsender og mottaker skal være i henhold til beskrivelsen i standarden for tjenestebasert adressering tilgjengelig her: https://www.ehelse.no/standarder/om-standardisering-i-e-helse/tjenestebasert-adressering

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.

XML eksempel med Oslo kommune som avsender:

Code Block
<Sender>
	<Organisation>
		<OrganisationName>UNIVERSITETSSYKEHUSET NORD-NORGE HF</OrganisationName>
		<Ident>
			<Id>9</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>152000</Id>
				<TypeId DN="HER-id" V="HER" 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
titleKrav til informasjonsinnhold for MsgHead/MsgInfo/Ack

Elementet <MsgHead/MsgInfo/Ack> skal benyttes til å angi at det skal svares med applikasjonskvittering. Tjenesteoversikt skal alltid ha en applikasjonskvittering.

XML eksempel:

Code Block
<Ack DN="Ja" V="J"/>
Expand
titleKrav 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
titleKrav 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 er det utarbeidet et sett med FHIR-profiler.

EpisodeOfCare

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

Expand
titleAnvendte felter

Elementnavn

Påkrevd

Beskrivelse

Identifier

  • system: “Idenfitier no-citizenportal-uniquebusinessidentifier”

  • value: unik identifikator av type GUID

Ja

Unik identifikator for helsekontakt. Eksempel: "3da5258e-2517-48cb-9519-953f1493e297"

Det skal benyttes en GUID som er globalt unik slik at Helsenorge kan benyttes denne for identifisering og alle operasjoner.

status

Ja

Default: "active"

Påkrevd felt i FHIR, men ikke i bruk i helsenorge.

type

Nei

Default: “spesialisthelsetjenesten”
Ny verdi / nytt kodeverkinnslag som definerer aktørtype
(e.g. primærhelsetjenesten, spesialisthelsetjenesten, kommunal helse og omsorg)

patient.identifier

Ja

Innbyggers fødselsnummer eller d-nummer.

managingOrganization.identifier

Ja

Referanse til HerId nivå 2.

Definere hvilken tjenesten dialogen på helsekontakten skal sendes til og anvendes også for å vite om dialog er støttet.

Status
colourYellow
titleNB:
tjenesten/kommunikasjonsparten man setter i dette feltet vil være mekanismen for å slå av/på dialogstøtte på helsekontakten ved at tjenesten støtter eller ikke støtter helsekontaktdialog i CPP-kontrakten.

managingOrganization.display

Nei

Anvendes for å endre visningsnavnet til noe annet enn organisasjonsnavnet fra HerId 1 (utledet av HerId2 over)

period.start

Ja

Helsekontaktens starttidspunkt

period.end

Nei

Helsekontaktens sluttidspunkt

CareTeam

Ja

Referanse til contained FHIR-ressurs CareTeam (under)

CareTeam

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

Expand
titleAnvendte felter

Elementnavn

Påkrevd

Beskrivelse

Name

Ja

Helsekontaktens navn

telecom

  • system: phone

  • value: telefonnummeret

Nei

Telefonnummeret som vises på helsekontakten