AMQP Timebestilling

Prosessen timebestilling er identisk med funksjonen for innbygger å hente ledige timer og sende en forespørsel om bestilling i prosessen AMQP Timereservasjon versjon 1.2.

Denne prosessen gjør det mulig for en aktør å eksplisitt angi at timebestilling er støttet, og sammen med prosessene for avtaleutsending og avtaleavbestilling utgjør den funksjonalitet for timeadministrasjon. Et premiss for å kunne benytte denne prosessen er at innbygger ser avtaler og prosessen Avtaleutsending er aktivert.

API-navn	DIALOG_INNBYGGER_TIMEBESTILLING
Funksjonelt område	Dialog
API-versjon og dato publisert	v1.0 Oct 27, 2020
Status	I Drift
API-dokumentasjon sist endret	Feb 11, 2021
Teknologi	AMQP

Kommunikasjonsprosess

Dette er en frittstående prosess og har en egen verdi i meldingens funksjon i hodemeldingen. Følgende prosess skal aktiveres i adresseregisteret for å støtte funksjonaliteten.

Prosess	Funksjonalitet	Versjon
Dialog_Innbygger_Timebestilling	Første versjon av kommunikasjonsprosess.	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

HentLedigeTimer

ReserverAvtale

· Dialogmelding 1.1

· Pasientrelasjon

· iCalendar 2.0

Helsepersonell

SvarLedigeTimer

SvarTimeReservasjon

· Dialogmelding 1.1

· Helsepersonell

· iCalendar 2.0

Se ytterligere detaljer i innholdsstandarder for innhold i meldinger

Hent ledige timer

Funksjonen «Hent ledige timer» gir mulighet til å hente ledige timer synkront fra timebok.

Med «hent ledige timer» menes her at helsenorge.no henter ledige timer hos den behandler som er angitt i meldingen. Timene vil presenteres for innbygger som kan velge og reservere en eller flere av ledige timene.

Tjeneste	Forespørsel om hent ledige timer, synkron tjeneste
Bruksområde	Forespørsel fra helsenorge.no for å hente ledige timer i timeboken til behandleren som er angitt som mottaker i meldingen.
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: `<Type V="DIALOG_INNBYGGER_TIMEBESTILLING" DN="Dialog med innbygger – timebestilling" />` Obligatorisk verdi i MsgHead/MsgInfo/Ack er: `<Ack DN="Nei" V="N"/>`
Dialogmelding	Som beskrevet i AMQP Timereservasjon Forespørsel om hent ledige timer
iCalender	Ikke aktuelt å bruke for denne tjenesten.
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

Tjeneste	Svar på forespørsel om hent ledige timer, synkron tjeneste
Bruksområde	Svar fra kommunikasjonspart med ledige timer for angitt behandler.
Hodemelding	Obligatorisk, og benyttes i henhold til beskrivelse i Hodemelding Obligatorisk verdi i MsgHead/MsgInfo/Type er: `<Type V="DIALOG_INNBYGGER_TIMEBESTILLING" DN="Dialog med innbygger - timebestilling"/>` Obligatorisk verdi i MsgHead/MsgInfo/Ack er:
Dialogmelding	Som beskrevet i AMQP Timereservasjon Svar på hent ledige timer
iCalender	Obligatorisk når informasjon om timer sendes til Helsenorge.no. Dersom koden «ingen ledige timer» returneres skal iCalendar ikke benyttes. For detaljer se beskrivelse i AMQP Timereservasjon Svar på hent ledige timer
Helsepersonell	Ikke aktuelt å bruke for denne tjenesten
Pasientrelasjon	Ikke aktuelt å bruke for denne tjenesten
Vedlegg	Ikke aktuelt å bruke for denne tjenesten

Reservasjon av valgt time

Med reservasjon av valgt time kan innbygger sende en forespørsel om reservasjon. Bruk av denne funksjonen forutsetter at hent ledige timer er benyttet først, for å finne ledige tidspunkt og referanser til avtale som skal reserveres.

Med forespørsel om timereservasjon kan innbygger sende en forespørsel om å bestille en time. Dersom innbygger vil endre en time må dette gjøres som avbestilling av eksisterende og en bestilling av ny time.

Tjeneste	Forespørsel om timereservasjon, asynkron tjeneste
Bruksområde	Brukes når innbygger skal reservere en ny time, endre en reservert time eller avbestille en reservert time.
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	Som beskrevet i AMQP Timereservasjon Forespørsel fra innbygger om timereservasjon
iCalender	Obligatorisk når informasjon om tidspunkt sendes til legekontor. Som beskrevet i AMQP Timereservasjon Forespørsel fra innbygger om timereservasjon
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	Som beskrevet i AMQP Timereservasjon Forespørsel fra innbygger om timereservasjon

Tjeneste	Svar på forespørsel om timereservasjon, asynkron tjeneste
Bruksområde	Svar på reservasjon en ny time.
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	Som beskrevet i AMQP Timereservasjon Svar på forespørsel om timereservasjon
iCalender	Obligatorisk når informasjon om tidspunkt sendes til Helsenorge.no. For detaljer se beskrivelse i AMQP Timereservasjon Svar på forespørsel om timereservasjon
Helsepersonell	Ikke aktuelt å bruke for denne tjenesten
Pasientrelasjon	Ikke aktuelt å bruke for denne tjenesten.
Vedlegg	Som beskrevet i AMQP Timereservasjon Svar på forespørsel om timereservasjon

Generell info om meldingsutveksling med Helsenorge

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