AMQP eKonsultasjon

Med eKonsultasjon menes her at innbygger kan kontakte valgt behandler, eller at behandler kan kontakte innbygger for en konsultasjon. Begge parter kan svare på en forespørsel og dialogen kan bestå av mange meldinger i en samtaletråd.

API-navn	DIALOG_INNBYGGER_EKONSULTASJON
Funksjonelt område	Dialog
API-versjon og dato publisert	v1.2 Nov 23, 2015
Status	I Drift
API-dokumentasjon sist endret	Jan 10, 2024
Teknologi	AMQP

Prosesser og flyt

Her er info om prosesser og flyt

Sekvensdiagram for en henvendelse fra innbygger er vist under. Figuren viser bare et enkelt svar, men dialogprosessen støtter flere meldinger knyttet til en henvendelse.

Tilsvarende er sekvensdiagram der behandler starter en forespørsel vist i figuren under.

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

Prosess

Funksjonalitet

Versjon

Dialog_Innbygger_Ekonsultasjon

Håndtering av pasientrelasjon. Helsenorge.no kan sende meldinger på vegne av annen person.

1.2

Oppdatert versjon som støtter

Mulighet for Helsepersonell til å markere ekonsultasjon som viktig og Helsenorge å sende oppdatering om ulest ekonsultasjon
Mulighet til innbygger å trekke ekonsultasjon

1.3

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.2	Innbygger	Foresporsel Svar	Dialogmelding 1.1 Pasientrelasjon
1.2	Helsepersonell	Foresporsel Svar	Dialogmelding 1.1
1.3	Innbygger	Foresporsel Svar	Dialogmelding 1.1 Pasientrelasjon
1.3	Helsepersonell	Foresporsel Svar	Dialogmelding 1.1

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Forespørsel fra innbygger

Tjeneste	Forespørsel om e-konsultasjon, asynkron tjeneste
Bruksområde	Brukes når innbygger sender spørsmål til sin fastlege (eller annen behandler).
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: `<Type V="DIALOG_INNBYGGER_EKONSULTASJON " DN="Dialog med innbygger - eKonsultasjon"/>` Obligatorisk verdi i MsgHead/MsgInfo/Ack er: `<Ack DN="Ja" V="J"/>`
Dialogmelding	Obligatoriske elementer (klasse/element): Dialogmelding/Foresporsel/TypeForesp Dialogmelding/Foresporsel/EmneSporsmal Dialogmelding/Foresporsel/Sporsmal Lovlige kodeverdier som kan brukes i TypeForesp: SB Spørsmål til behandler XML eksempel: `<Foresporsel> <TypeForesp V="SB" DN="Spørsmål til behandler" S="2.16.578.1.12.4.1.1.7601"/> <EmneSporsmal>Vorte under fot</EmneSporsmal> <Sporsmal>Hei. Jeg har en vorte under foten som har vært litt hoven og vond de to siste dagene. Hva bør jeg gjøre med dette? Se på vedlagte bilde av vorten</Sporsmal> </Foresporsel>` RollerRelatertNotat Valgfritt, benyttes i henhold til Dialogmelding under RollerRelatertNotat Angir helsepersonellet det ønskes at dialogen rutes til. Bruk av denne forutsetter at prosessen AMQP Behandleroversikt er støttet og Helsenorge.no kan hente behandlere fra EPJ XML-eksempel:
iCalender	Ikke aktuelt å bruke for denne tjenesten.
Helsepersonell	Ikke aktuelt å bruke for denne tjenesten.
Pasientrelasjon	Obligatorisk informasjon når en annen person enn innbygger selv sender melding. For generell beskrivelse av representasjon på Helsenorge, se Representasjon på Helsenorge Se Pasientrelasjon for korrekt bruk av meldingsformat.
Vedlegg	Valgfri informasjon som kan være med dersom f.eks. innbygger legger et bilde ved timebestillingen. Se Vedlegg for korrekt bruk.

Svar fra helsepersonell

Tjeneste	Svar på forespørsel om e-konsultasjon, asynkron tjeneste
Bruksområde	Brukes når fastlege eller annen behandler svarer på spørsmål fra innbygger.
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Dialogmelding	Obligatoriske elementer (klasse/element): Dialogmelding/Notat/Temakodet Dialogmelding/Notat/TekstNotatInnhold Dialogmelding/Notat/Foresporsel Elementet Dialogmelding/Notat/Foresporsel benyttes ikke i svarmelding. Lovlige kodeverdier som kan brukes i Dialogmelding/Notat/Temakodet: 12 Svar fra behandler 13 Dialog avsluttet Avvisning av henvendelse/forespørsel: dersom system/behandler ikke kan svare på mottatt henvendelse/forespørsel kan følgende kodeverdier fra kodeverk 7602 benyttes i elementet <Dialogmelding/Notat/Temakodet>: 26 Forespørsel avvist 30 Ikke tilgang XML eksempel: RollerRelatertNotat Valgfritt, benyttes i henhold til Dialogmelding under RollerRelatertNotat RollerRelatertNotat angir helsepersonellet som besvarte meldingen og gir mulighet til å skille hvem meldingen er adressert fra (hodemelding) og hvem som besvarer XML-eksempel:
iCalender	Ikke aktuelt å bruke for denne tjenesten.
Helsepersonell	Ikke aktuelt å bruke for denne tjenesten.
Pasientrelasjon	Ikke aktuelt å bruke for denne tjenesten.
Vedlegg	Valgfri informasjon som kan være med dersom lege ønsker å sende informasjon til pasient. Se Vedlegg for korrekt bruk.

Forespørsel fra helsepersonell

Behandler kan sende en melding til innbygger uten at det er initiert dialog i form av en forespørsel fra innbygger i forkant. Innbygger kan svare på henvendelsen fra behandler dersom dette er angitt.

Tjeneste	eKonsultasjon, asynkron tjeneste
Bruksområde	Brukes når behandler ønsker å initiere dialog og sende en melding til innbygger uten at det foreligger en forespørsel fra innbyggeren.
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Dialogmelding	Obligatoriske elementer (klasse/element): Dialogmelding/Foresporsel/TypeForesp Dialogmelding/Foresporsel/EmneSporsmal Dialogmelding/Foresporsel/Sporsmal Lovlige kodeverdier som kan brukes i TypeForesp: DI Dialog med innbygger EKI Engangskontakt med innbygger Bruk av kodeverdiene: «Dialog med innbygger»: benyttes når innbygger skal gis anledning til å svare på dialogen med behandler. «Engangskontakt med innbygger»: betyr at innbygger ikke skal kunne svar på meldingen fra behandler. Dette kan benyttes når behandler kun ønsker å informere innbygger om et tema. «Dialog avsluttet»: benyttes når legen anser dialogen for avsuttet. Helsenorge.no vil vise denne informasjonen til innbygger, men innbygger kan fortsette dialogen. XML eksempel: RollerRelatertNotat Valgfritt, benyttes i henhold til Dialogmelding under RollerRelatertNotat. RollerRelatertNotat angir helsepersonellet som skrev meldingen og gir mulighet til å skille hvem meldingen er adressert fra (hodemelding) og hvem som besvarer. XML-eksempel:
iCalender	Ikke aktuelt å bruke for denne tjenesten.
Helsepersonell	Ikke aktuelt å bruke for denne tjenesten.
Pasientrelasjon	Ikke aktuelt å bruke for denne tjenesten.
Vedlegg	Valgfri informasjon som kan være med. Se Vedlegg for korrekt bruk.

Svar fra innbygger

Tjeneste	«eKonsultasjon, svar fra innbygger», asynkron tjeneste
Bruksområde	Brukes når innbygger svarer på en henvendelse fra behandler.
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Dialogmelding	Obligatoriske elementer (klasse/element): Dialogmelding/Notat/Temakodet Dialogmelding/Notat/TekstNotatInnhold Dialogmelding/Notat/Foresporsel Elementet Dialogmelding/Notat/Foresporsel benyttes ikke i svarmelding. Lovlige kodeverdier som kan brukes i Dialogmelding/Notat/Temakodet: 22 Svar fra innbygger 41 Varsel om ulest melding (krever versjon 1.3, sendes av Helsenorge som system) 42 Forespørsel trukket (krever versjon 1.3) XML eksempel: RollerRelatertNotat Benyttes ikke når innbygger svarer på en melding.
iCalender	Ikke aktuelt å bruke for denne tjenesten.
Helsepersonell	Ikke aktuelt å bruke for denne tjenesten.
Pasientrelasjon	Obligatorisk informasjon når en annen person enn innbygger sender melding på vegne av pasient. Se Pasientrelasjon for korrekt bruk.
Vedlegg	Valgfri informasjon som kan være med. Se Vedlegg for korrekt bruk.

Eksempelmeldinger

Generell info om meldingsutveksling med Helsenorge

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