AMQP Timedialog

Owned by kjetill.vassmo.lund, created
Last updated: Oct 08, 2021 by Alette N. L. Olrik (Unlicensed)
7 min read

Ved bruk av prosessen timedialog kan innbygger ha dialog på timer i fra spesialisthelsetjenesten. Følgende funksjonaliteter støttes: bekreft time, spørsmål om time (generell dialog), be om endring av time og be om avslutning av behandlingsforløp.

API-navn

DIALOG_INNBYGGER_TIMER

Funksjonelt område

Dialog

API-versjon og dato publisert

v1.2 Aug 16, 2018

Status

I Drift

API-dokumentasjon sist endret

Feb 11, 2021

Teknologi

AMQP

Prosesser og flyt

Her er info om prosesser og flyt

En av følgende prosesser skal aktiveres i adresseregisteret for å støtte funksjonaliteten.

Prosess

Funksjonalitet

Versjon

Dialog_Innbygger_Timer

Basisversjon for kommunikasjonsprosess

1.1

Dialog_Innbygger_Timer

Anvender dialogmelding 1.1 i stedet for 1.0

1.2

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

Innbygger

Foresporsel

Svar

·         Dialogmelding 1.0

·         iCalendar 2.0

Helsepersonell

Foresporsel

Svar

·         Dialogmelding 1.0

·         iCalendar 2.0

1.2

Innbygger

Foresporsel

Svar

·         Dialogmelding 1.1

·         iCalendar 2.0

Helsepersonell

Foresporsel

Svar

·         Dialogmelding 1.1

·         iCalendar 2.0

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Forespørsel fra innbygger om timedialog

Her er strukturen på query

Tjeneste

Forespørsel om timedialog, asynkron tjeneste

Bruksområde

Brukes når innbygger har spørsmål om timen, ber om endring av time og ber om avslutning av behandlingsforløpet.

Hodemelding

Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding

Obligatorisk verdi i MsgHead/MsgInfo/Type er:

<Type V="DIALOG_INNBYGGER_TIMER" DN="Dialog med innbygger om timer"/>

Obligatorisk verdi i MsgHead/MsgInfo/Ack er:

<Ack DN="Ja" V="J"/>

Dialogmelding

Merk at Dialog_Innbygger_Timer 1.1 anvender dialogmelding 1.0.

 

Obligatoriske elementer (klasse/element):

  • Dialogmelding/Foresporsel/TypeForesp

 

Lovlige kodeverdier som kan brukes i TypeFores (Volven-kodeverk 7601):

  • HE                Henvendelse

  • OET              Ønske om endring av time

  • OAB            Ønske om avslutning av behandlingsforløp

 

Lovlige kodeverdier som kan brukes i TypeFores (Volven-kodeverk 7602):

  • 05                            Bekreft time

 

Obligatoriske elementer (klasse/element):

  • Dialogmelding/Foresporsel/Sporsmal


XML eksempel HE:

<Foresporsel> <TypeForesp V="HE" DN="Henvendelse" S="2.16.578.1.12.4.1.1.7601"/> <Sporsmal>Hei. Må jeg virkelig faste i en uke før jeg møter til timen?</Sporsmal> </Foresporsel>


XML eksempel OET:


XML eksempel OAB:

iCalender

Obligatorisk ved spørsmål om timen, endring eller avbestilling av time. Ved ønske om ny time skal ikke iCal benyttes (dette vil kun ligge som fritekst i Dialogmeldingen).

 

Elementer under iCal/vevent skal ha følgende innhold for de ulike bruksområdene:

  • dtstart: tidsslot for gjeldende time, start

  • dtend: tidsslot for gjeldende time, slutt

  • uid: id for tidsslot

  • contact: HER-id for behandler som tidsslot tilhører

 

Valgfrie elementer (klasse/element):

  • related-to: id for timeavtalen en ønsker å avbestille/endre

Benyttes når man anvender uid til avtale-id (eller tilsvarende) og behøver tilhørende id for selve timeinstansen (se 2.8).

 

XML eksempel:

Helsepersonell

Ikke aktuelt å bruke for denne tjenesten.

Pasientrelasjon

Obligatorisk informasjon når en annen person enn utfører timereservasjon på vegne av pasient.

Se Pasientrelasjon for korrekt bruk.

Vedlegg

Ikke aktuelt å bruke for denne tjenesten.

 

Svar fra behandler på forespørsel om timedialog

Her er strukturen på en respons

Tjeneste

Svar på timedialog, asynkron tjeneste

Bruksområde

Svar fra Spesialisthelsetjenesten på meldinger 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

Merk at Dialog_Innbygger_Timer 1.1 anvender dialogmelding 1.0.

 

Obligatoriske elementer (klasse/element):

  • Dialogmelding/Notat/Temakodet

 

Lovlige kodeverdier som kan brukes i TypeFores (Volven-kodeverk 7602):

For svar på HE fra 3.9.1

  • 19         Svar på henvendelse

For svar på OET fra 3.9.1

  • 07       Endring av time bekreftet

  • 34       Timen kunne ikke endres

For svar på OAB fra 3.9.1

  • 35       Avslutning av behandlingsforløp bekreftet

  • 36       Behandlingsforløp kunne ikke avsluttes

 

Obligatoriske elementer (klasse/element):

  • Dialogmelding/Notat/TekstNotatInnhold

  • Dialogmelding/Notat/Foresporsel (for Dialog_Innbygger_Timer 1.1)

  • Dialogmelding/Notat/RollerRelatertNotat

 

XML eksempel svar på HE:

XML eksempel svar på OET:

XML eksempel svar på OAB:

iCalender

Obligatorisk ved spørsmål om timen, endring eller avbestilling av time. Ved ønske om ny time skal ikke iCal benyttes (dette vil kun ligge som fritekst i Dialogmeldingen).

 

Elementer under iCal/vevent skal ha følgende innhold for de ulike bruksområdene:

  • dtstart: tidsslot for gjeldende time, start

  • dtend: tidsslot for gjeldende time, slutt

  • uid: id for tidsslot

  • contact: HER-id for behandler som tidsslot tilhører

 

Valgfrie elementer (klasse/element):

  • related-to: id for timeavtalen en ønsker å avbestille/endre

Benyttes når man anvender uid til avtale-id (eller tilsvarende) og behøver tilhørende id for selve timeinstansen (se Kalenderelement iCalendar for korrekt bruk).

 

XML eksempel:

Helsepersonell

Ikke aktuelt å bruke for denne tjenesten.

Pasientrelasjon

Obligatorisk informasjon når en annen person enn utfører timereservasjon på vegne av pasient.

Se Pasientrelasjon for korrekt bruk.

Vedlegg

Ikke aktuelt å bruke for denne tjenesten.

Ytterligere informasjon

Under er forskjellige typer supplerende informasjon

Eksempelmeldinger

v1.1

v1.2

Generell info om meldingsutveksling med Helsenorge

For overordnet informasjon om meldingsutveksling med Helsenorge se her: Meldingsutveksling med Helsenorge