AMQP Dialog helsepersonell

Owned by kjetill.vassmo.lund
Last updated: Mar 21, 2024 by kjetill.vassmo.lund
28 min read

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, i en slik dialog. 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 https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/2075459585. 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 stratet fra innbygger er vist under. Figuren viser bare et enkelt svar, men dialogprosessen støtter flere meldinger knyttet til en henvendelse. 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 https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1348174397

 

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 https://helsenorge.atlassian.net/wiki/spaces/HELSENORGE/pages/1348174412 under RollerRelatertNotat.

Angir hvilken Helsekontakt det ønskes kontakt med

 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 for korrekt bruk.

Vedlegg

Valgfri informasjon som kan være med dersom innbygger ønsker å sende med vedlegg til behandler.

Se 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

 

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

 

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 innbygge

 XML eksempel Forespørsel:

 

RollerRelatertNotat

Benyttes i henhold til 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

Ikke aktuelt å bruke for denne tjenesten.

Vedlegg

Valgfri informasjon som kan være med dersom behandlefr ønsker å sende med et vcedlegg til pasienten.

Se 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

 

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 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 for korrekt bruk.

Vedlegg

Valgfri informasjon som kan være med dersom innbygger ønsker å sende med vedlegg til behandler.

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