AMQP Dialog henvendelse

Med dialog henvendelse kan en helseaktør kontakte innbygger og tilby dialog knyttet til en henvendelse som innbygger har gjort.

API-navn	DIALOG_INNBYGGER_EKONTAKT
Funksjonelt område	Dialog
API-versjon og dato publisert	v 0.1 Nov 11, 2024
Status	Utkast
API-dokumentasjon sist endret	Nov 11, 2024
Teknologi	AMQP

Prosesser og flyt

Sekvenddiagram for meldingstypen er vist under

Sekvensdiagram for Dialog henvendelse er vist i fuguren under. Prosessen starter ved at Innbygger sender en henvendelse via annen funksjon først. Så kan Helseaktør åpne opp for dialog med innbygger.

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

Prosess	Funksjonalitet	Versjon
Dialog_Innbygger_Henvendelse	Basisversjon av meldingstypen	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

Svar

Dialogmelding 1.1

Pasientrelasjon

Helseaktør

Foresporsel

Svar

Dialogmelding 1.1

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Forespørsel fra helsekontakt

Med denne funksjonen kan en helsekontakt sende en melding til innbygger. Innbygger kan svare på forespørsel dersom dette angis.

Bruksområde	Brukes når helseaktør ønsker å initiere dialog knyttet til en henvendelse
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: `<Type V="DIALOG_INNBYGGER_HENVENDELSE" DN="Dialog med innbygger - henvendelse"/>` Obligatorisk verdi i MsgHead/MsgInfo/Ack er: `<Ack DN="Ja" V="J"/>` Dersom henvendelsen fra innbygger er sendt fra Helsenorge og dialogen knyttet til denne skal foregå i samme samtaletråd for innbygger, så legges denne referansen inn i ConversationRef i hodemeldingen. `<ConversationRef> <RefToParent>e53d4f2c-8459-42d3-ab31-13974e3521af</RefToParent> <RefToConversation>e53d4f2c-8459-42d3-ab31-13974e3521af</RefToConversation> </ConversationRef>` Et brukstilfelle her er at innbygger har sendt inn et skjema med opplysninger til en helseaktør. Dersom helseaktøren ønsker dialog knyttet til denne henvendelsen kan meldingsID fra skjemaet benyttes som samtalereferanse og Helsenorge vil kople dialogen med den opprinnelige henvendelsen. Dersom det ikke oppgis en samtalereferanse vil meldingene ikke kunne koples for innbygger.
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 «Engangskontakt med innbygger»: betyr at innbygger ikke skal kunne svar på meldingen. Dette kan benyttes når helseaktør kun ønsker å informere innbygger om noe. XML eksempel: RollerRelatertNotat Kan benyttes for å angi hvem som skal vises som avsender til innbygger
Pasientrelasjon	Ikke aktuelt å bruke for denne tjenesten.
Vedlegg	Valgfri informasjon som kan være med dersomhelseaktør ønsker å legge ved dokumenter til meldingen. Støttede innholdstyper og størrelser, samt bruk dokumentert i Vedlegg.

Svar fra innbygger

Dersom henvendelsen er mulig å svare på for innbygger er svaret strukturert som vist under

Bruksområde	Brukes når innbygger svarer på en henvendelse fra helseaktør
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: Obligatorisk verdi i MsgHead/MsgInfo/Ack er: Obligatorisk verdi i MsgHead/MsgInfo/ConversationRef er samtalereferanse og Id til meldingen sendt fra helseaktør
Dialogmelding	Obligatoriske elementer (klasse/element): Dialogmelding/Notat/Temakodet Dialogmelding/Notat/TekstNotatInnhold Elementet Dialogmelding/Notat/Foresporsel benyttes ikke i svarmelding. Lovlige kodeverdier som kan brukes i Dialogmelding/Notat/Temakodet: 22 Svar fra innbygger XML eksempel: RollerRelatertNotat Ikke aktuelt å bruke for denne tjenesten.
Pasientrelasjon	Obligatorisk informasjon når innlogget bruker er en annen person enn pasient og den meldingen gjelder. Se Pasientrelasjon for korrekt bruk.
Vedlegg	Valgfri informasjon som kan være med dersom helseaktør ønsker å legge ved dokumenter til meldingen. Støttede innholdstyper og størrelser, samt bruk dokumentert i Vedlegg.

Svar fra helseaktør

Helseaktør kan svare på meldingen og kan velge å avslutte dialogen ved å markere den som “Dialog Avsluttet”. Etter dette kan innbygger ikke svare i samtalen.

Bruksområde	Svar fra helseaktør i en meldingstråd
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: Obligatorisk verdi i MsgHead/MsgInfo/Ack er: Obligatorisk verdi i MsgHead/MsgInfo/ConversationRef er samtalereferanse og Id til meldingen sendt fra innbygger
Dialogmelding	Obligatoriske elementer (klasse/element): Dialogmelding/Notat/Temakodet Dialogmelding/Notat/TekstNotatInnhold Elementet Dialogmelding/Notat/Foresporsel benyttes ikke i svarmelding. Lovlige kodeverdier som kan brukes i Dialogmelding/Notat/Temakodet: 13 Dialog avsluttet 19 Svar på henvendelse XML eksempel: RollerRelatertNotat Denne kan benyttes til å angi hvem som besvarer, og fornavn og etternavn på den som har besvart legges ved i meldingen. Dette gjør at denne informasjonen kan oversendes på strukturert form og også kan vises til innbygger.
Pasientrelasjon	Ikke aktuelt å bruke for denne tjenesten.
Vedlegg	Valgfri informasjon som kan være med dersom helseaktør ønsker å legge ved dokumenter til meldingen. Støttede innholdstyper og størrelser, samt bruk dokumentert i Vedlegg.

Eksempelmeldinger

Generell info om meldingsutveksling med Helsenorge

For overordnet informasjon om meldingsutveksling med Helsenorge se her: https://helsenorge.atlassian.net/wiki/pages/createpage.action?spaceKey=HELSENORGE&title=Meldingsutveksling%20med%20Helsenorge