AMQP Dialog helsepersonell

Med Dialog helsepersonell kan innbygger gjennomføre dialog med helsepersonell. Det er en forutsetning at innbygger har en Helsekontakt for at innbygger kan starte, eller svare på en melding. Helsekontakten må først opprettes ved at den sendes fra Helseaktøren til innbygger.

Meldingstypen kan også benyttes til å sende svar på meldinger sendt ved Formidlingstjenesten - meldinger og brev. Dersom brevet sendes med attributtet “svar tillat” vil svaret fra innbygger komme som meldingstype Dialog Helsepersonell. I dette tilfellet kreves det ikke en helsekontakt for at innbygger skal svare.

API-navn	DIALOG_INNBYGGER_HELSEPERSONELL
Funksjonelt område	Dialog
API-versjon og dato publisert	v1.1 Jul 20, 2023
Status	I DRIFT
API-dokumentasjon sist endret	Jul 6, 2023
Teknologi	AMQP

Prosesser og flyt

Her er info om prosesser og flyt

Sekvensdiagram for samtale startet fra innbygger er vist under. Figuren viser bare et enkelt svar, men prosessen støtter flere meldinger i en samtaletråd. Begge parter kan svare på en forespørsel og dialogen kan bestå av mange meldinger i en samtaletråd.

Sekvensdiagram der behandler starter dialogen er vist i figuren under.

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

Prosess	Funksjonalitet	Versjon
Dialog_Innbygger_Helsepersonell	Bruk av dialogmelding 1.1, støtte for representasjon og begge parter kan initiere dialog	1.1

Tabellen under viser hvilke roller som inngår i prosessen, hvilke funksjoner de ulike rollene kan gjøre og hvilke meldinger som benyttes

Versjon

Rolle

Funksjon

Meldingsinnhold

1.1

Innbygger

Forespørsel

Svar

Dialogmelding 1.1

Pasientrelasjon

Helsepersonell

Forespørsel

Svar

Dialogmelding 1.1

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Dialog startet fra innbygger

Her er strukturen på melding

Tjeneste	Forespørsel fra innbygger, asynkron tjeneste
Bruksområde	Brukes når innbygger sender spørsmål til en behandler
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: `<Type V="DIALOG_INNBYGGER_HELSEPERSONELL " DN="Dialog mellom innbygger og helsepersonell"/>` 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 Dialogmelding/Foresporsel/RollerRelatertNotat Lovlige kodeverdier som kan brukes i TypeForesp: DI - Dialog med innbygger XML eksempel Forespørsel: `<Foresporsel> <TypeForesp V="DI" DN="Dialog med innbygger" S="2.16.578.1.12.4.1.1. 7601"/> <EmneSporsmal>Problem under foten</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 Benyttes i henhold til Dialogmelding under RollerRelatertNotat. Angir hvilken Helsekontakt det ønskes kontakt med, i de tilfeller innbygger svarer knyttet til en spesifikk helsekontakt. 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 pasient sender melding på vegne av pasient Se Pasientrelasjon for korrekt bruk.
Vedlegg	Valgfri informasjon som kan være med dersom innbygger ønsker å sende med vedlegg til behandler. Se Vedlegg for korrekt bruk.

Svar fra Helsepersonell

Her er strukturen på respons

Tjeneste	Svar fra helsepersonell, asynkron tjeneste
Bruksområde	Brukes når helsepersonell 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/RollerRelatertNotat NB! Elementet Dialogmelding/Notat/Foresporsel benyttes ikke i svarmelding. Lovlige kodeverdier som kan brukes i Dialogmelding/Notat/Temakodet: 12 Svar på spørsmål, fra behandler 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 31 Generell feil XML eksempel Notat (svar): RollerRelatertNotat Benyttes i henhold til Dialogmelding under RollerRelatertNotat. RollerRelatertNotat angir Helsekontakten som besvarte meldingen. 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 behandler ønsker å sende med et vedlegg til pasient. Se Vedlegg for korrekt bruk.

Forespørsel fra Helsepersonell

Her er strukturen på melding

Med forespørsel fra helsepersonell er det mulig å sende en melding til innbygger uten at det først er sendt en forespørsel fra innbygger. Innbygger kan svare på henvendelsen fra behandler dersom dette er angitt.

Tjeneste	Forespørsel fra helsepersonell, 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 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/Foresporsel/TypeForesp Dialoghmelding/Foresporsel/EmneSporsmal Dialogmelding/Foresporsel/Sporsmal Dialogmelding/Foresporsel/RollerRelatertNotat Lovlige kodeverdier som kan brukes i TypeForesp: DI Dialog med innbygger XML eksempel Forespørsel: RollerRelatertNotat Benyttes i henhold til Dialogmelding under RollerRelatertNotat. RollerRelatertNotat angir Helsekontakten som kontakter innbygger dersom denne fins. 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 behandler ønsker å sende med et vedlegg til pasienten. Se Vedlegg for korrekt bruk.

Svar fra Innbygger

Her er strukturen på respons

Tjeneste	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 Dialogmedling/Notat/RollerRelatertNotat NB! Elementet Dialogmelding/Notat/Foresporsel benyttes ikke i svarmelding. Lovlige kodeverdier som kan brukes i Dialogmelding/Notat/Temakodet: 22 Svar fra innbygger Avvisning av henvendelse/forespørsel: dersom innbygger 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 31 Generell feil XML eksempel svar: RollerRelatertNotat Benyttes i henhold til Dialogmelding under RollerRelatertNotat. RollerRelatertNotat angir Helsekontakten som kontakter innbygger XML-eksempel:
iCalender	Ikke aktuelt å bruke for denne tjenesten.
Helsepersonell	Ikke aktuelt å bruke for denne tjenesten.
Pasientrelasjon	Obligatorisk informasjon når en innbygger sender melding på vegne av en annen innbygger (ved representasjon). Se Pasientrelasjon for korrekt bruk.
Vedlegg	Valgfri informasjon som kan være med dersom innbygger ønsker å sende med vedlegg til behandler. Se Vedlegg for korrekt bruk.

Ytterligere informasjon

Under er forskjellige typer supplerende informasjon

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