Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Prosessen avtaleavbestilling er identisk med funksjonen for innbygger å sende avbestilling i prosessen 3.4 Timereservasjon versjon 1.2

Denne prosessen gjør det mulig for en aktør å åpne opp for avbestillinger av avtaler fra innbygger, uten å åpne opp for hele prosessen timeadministrasjon som også innebærer at innbygger får hente ledige timer og bestille nye timer. Et premiss for å kunne benytte denne prosessen er at innbygger ser avtaler og prosessen Avtaleutsending er aktivert.

API-navn

DIALOG_INNBYGGER_AVTALEAVBESTILLING

Funksjonelt område

Dialog

API-versjon og dato publisert

v1.0

Status

I DRIFT

API-dokumentasjon sist endret

Teknologi

AMQP

Prosesser og roller

Her er info om prosesser og roller

 Prosesser og roller

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_Avtaleavbestilling

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

AvbestillAvtale

 

Dialogmelding 1.1

Pasientrelasjon

iCal

Helsepersonell

SvarAvbestilling

Dialogmelding 1.1

iCal

Forespørsel fra innbygger om avbestilling

Her er strukturen på query

 Struktur på query

Med forespørsel om avbestilling kan innbygger sende en forespørsel om å avbestille en time.

Denne funksjon dekker avbestilling som beskrevet i avsnitt 3.4.3.1 Forespørsel fra innbygger om timereservasjon.

Tjeneste

Forespørsel om timereservasjon, asynkron tjeneste

Bruksområde

Brukes når innbygger ønsker å avbestille en reservert time.

Hodemelding

Obligatorisk, og benyttes i henhold til beskrivelse i kapittel 2.3

Obligatorisk verdi i MsgHead/MsgInfo/Type er:

<Type V="DIALOG_INNBYGGER_AVTALEAVBESTILLING" DN="Dialog med innbygger - avtaleavbestilling "/>

Obligatorisk verdi i MsgHead/MsgInfo/Ack er:

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

Referanse til samtaletråd settes til meldingen som ble sendt for timenotifikasjon, beskrevet i 3.6

<ConversationRef>
  <RefToParent>f5896674-1147-46f0-bc9b-6b6bde5bb844</RefToParent>
  <RefToConversation>f5896674-1147-46f0-bc9b-6b6bde5bb844</RefToConversation>
</ConversationRef>

Dialogmelding

Obligatoriske elementer (klasse/element):

  • Dialogmelding/Foresporsel/TypeForesp

 

Lovlige kodeverdier som kan brukes i TypeForesp:

  • ART  Avbestill reservert time

 

iCalender

Obligatorisk når informasjon om tidspunkt sendes til legekontor.

Elementene under iCal/vevent skal ha følgende innhold

  • 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

  • related-to: id for timeavtalen som tidssloten tilhører

Ved avbestilling av time skal feltet related-to ha samme verdi som i opprinnelig time.

Følgende valgfrie informasjon kan benyttes:

  • Summary: Hva timen gjelder

  • Description: Fritekst informasjon om hvorfor avbestilling sendes

 

XML eksempel:

<vcalendar>
						<properties>
							<version>
								<text>2.0</text>
							</version>
							<prodid>
								<text>PAS EPJ</text>
							</prodid>
						</properties>
						<components>
							<vevent>
								<properties>
									<dtstart>
										<date-time>2019-07-05T11:45:00</date-time>
									</dtstart>
									<dtend>
										<date-time>2019-07-05T12:00:00</date-time>
									</dtend>
									<uid>
										<text>651b1341-26ca-11e4-8c21-0800200c9a66</text>
									</uid>
									<related-to>
										<uri>651b1341-26ca-11e4-8c21-0800200c9a66</uri>
									</related-to>
									<contact>
										<text>91095</text>
									</contact>
									<summary>
										<text>Reisevaksine</text>
									</summary>
									<description>
										<text>Jeg har allerede tatt dose 2</text>
									</description>
								</properties>
								<components/>
							</vevent>
						</components>
	</vcalendar>

Svar på forespørsel om avbestilling

Her er strukturen på en respons

 Struktur på response

Innholdet i Dialogemeldingen for svar på forespørsel er identisk med svar beskrevet i 3.4.3.2 Svar på forespørsel om timereservasjon. Dersom avbestilling kommer via prosessen Avtaleavbestilling skal det også svares med avbestilling slik som i eksempelet under.

Tjeneste

Svar på forespørsel om avbestilling, asynkron tjeneste

Bruksområde

Svar på avbestilling av en reservert time.

Hodemelding

Obligatorisk, og benyttes i henhold til beskrivelse i kapittel 2.3

 

Obligatorisk verdi i MsgHead/MsgInfo/Type er

<Type V="DIALOG_INNBYGGER_AVTALEAVBESTILLING" DN="Dialog med innbygger - avtaleavbestilling "/>

Obligatorisk verdi i MsgHead/MsgInfo/Ack er:

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

Dialogmelding

Obligatoriske elementer (klasse/element):

  • Dialogmelding/Notat/Temakodet

Lovlige kodeverdier som kan brukes i Dialogmelding/Notat/Temakodet:

  • 08     Avbestilling av time bekreftet

  • 09     Time kunne ikke avbestilles

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

iCalender

Obligatorisk når informasjon om tidspunkt sendes til Helsenorge.no.

Elementene under iCal/vevent skal ha følgende innhold

  • 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

  • related-to: id for timeavtalen som tidssloten tilhører

Ved avbestilling av time skal feltet related-to ha samme verdi som i opprinnelig time.

 

Følgende valgfrie informasjon kan benyttes:

  • Summary: Hva timen gjelder

  • Description: Fritekst informasjon knyttet til svaret

  • Status: Status for timen. Settes til CANCELLED dersom timen er avlyst

  • Cancellation-reason: årsak til avlysning

XML eksempel:

<vcalendar>
	<properties>
		<version>
			<text>2.0</text>
		</version>
		<prodid>
			<text>PAS EPJ</text>
		</prodid>
	</properties>
	<components>
		<vevent>
			<properties>
				<dtstart>
					<date-time>2019-07-05T11:45:00</date-time>
				</dtstart>
				<dtend>
					<date-time>2019-07-05T12:00:00</date-time>
				</dtend>
				<uid>
					<text>651b1341-26ca-11e4-8c21-0800200c9a66</text>
				</uid>
				<related-to>
					<uri>651b1341-26ca-11e4-8c21-0800200c9a66</uri>
				</related-to>
				<contact>
					<text>91095</text>
				</contact>
				<status>
					<text>CANCELLED</text>
				</status>
				<x-cancellation-reason>
					<text>Avlyst av innbygger</text>
				</x-cancellation-reason>
				<summary>
					<text>Reisevaksine</text>
				</summary>
				<description>
					<text>Siden du allerede har tatt dose 2, trenger du ikke denne timen</text>
				</description>
			</properties>
			<components/>
		</vevent>
	</components>
</vcalendar>

Generell info om meldingsutveksling med Helsenorge

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

Ytterligere informasjon

Under er forskjellige typer supplerende informasjon

Om brukeren kan avbestille timen

For å finne ut om "Avbestille time" knappen skal vise så gjøres det et kall mot backend; Timeadministrasjonsstotte.

Timeadministrasjon sjekker:

  1. Om timen venter på svar for avbestilling eller endring, eller om avbestilling er avvist, da vil ikke bruker kunne avbestille timen på nytt. 

  2. Om kommunikasjonsprosessen til motpart her DIALOG_INNBYGGER_TIMERESERVASJON eller DIALOG_INNBYGGER_AVTALEAVBESTILLING. Om den har en av disse så vil bruker kunne avbestille timen.

    1. Vi returnerer MessageFunction i kallet som inneholder den kommunikasjonsprossessen motpart har, der timereservasjon blir valgt over avtaleavbestilling. Denne blir sendt til avbestilling av time når man gjør dette kallet når man trykker på knappen og bestemmer hvilket kommunikasjon

  3. Om timen ikke har motpart så sjekker man i databasen om timen har KanAvbestilles og eventuelt om den er innenfor dato når man kan avbestilles (gjerne en gitt tid før timen). Om man kan avbestille timen og datoen er innenfor så vil brukeren kunne avbestille timen. 

 Benytter av følgende komponenter

Navn

Type

Beskrivelse




  • No labels