AMQP Tjenesteoversikt

Tjenesteoversikt kan benyttes for å sende en helsekontakt til innbygger. Meldingstypen ble opprinnelig kalt tjenesteoversikt fordi den gir en oversikt over hvilke helsetjenester innbygger mottar og som gir digitale innbyggertjenester.

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

API-navn	DIALOG_INNBYGGER_TJENESTEOVERSIKT
Funksjonelt område	Helsekontakter
API-versjon og dato publisert	v1.0 Feb 3, 2017
Status	I Drift
API-dokumentasjon sist endret	Feb 11, 2021
Teknologi	AMQP

Prosesser og flyt

Her er info om prosesser og flyt

Følgende prosess skal aktiveres i adresseregisteret for å støtte funksjonaliteten.

Prosess	Funksjonalitet	Versjon
Dialog_Innbygger_Tjenesteoversikt	Avsender kan sende en helsekontakt til innbygger på Helsenorge. Alle Helsekontakter for avsender (kommunikasjonspart) skal sendes og Helsenorge vil opprette, oppdatere og inaktivere basert på dette.	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	Innbygger	Apprec	Applikasjonskvittering
1.0	Helsepersonell	Oversikt	Tjenesteoversikt

Sekvensdiagram for prosessen tjenesteoversikt er vist i figuren under.

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

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

XML eksempel:

<MsgId>33160f22-3483-11e2-81c1-0800200c9a66</MsgId>

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

Kodeverdi

Kodetekst

DIALOG_INNBYGGER_TJENESTEOVERSIKT

Dialog med innbygger – tjenesteoversikt

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:

<Sender>
	<Organisation>
		<OrganisationName>OSLO KOMMUNE HELSEETATEN</OrganisationName>
		<Ident>
			<Id>93638</Id>
			<TypeId DN="HER-id" V="HER" S="2.16.578.1.12.4.1.1.9051"/>
		</Ident>
		<Organisation>
			<OrganisationName>Sykepleietjeneste, pleie- og omsorg </OrganisationName>
			<Ident>
				<Id>93971</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.

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

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

XML eksempel:

Tjenesteoversikt

For overføring av helsekontakter er det utarbeidet et eget skjema spesifikt for dette formålet- tjenesteoversikt.

Applikasjonskvittering

Applikasjonskvittering skal benyttes for å bekrefte at melding er mottatt og kan behandles av systemet. Applikasjonskvittering v1.1 skal benyttes, slik beskrevet i https://ehelse.no/his80415-2012.

Generell info om meldingsutveksling med Helsenorge

For overordnet informasjon om meldingsutveksling med Helsenorge se her: https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/690913297