När invånaren startar avbokningsflödet får invånaren först en sammanställning över den bokade tiden för att kontrollera att det är rätt tid som ska avbokas.

GetBookingDetails

Gränssnitt	Tjänstekontrakt GetBookingDetails	Kommentar

Gränssnitt	Tjänstekontrakt GetBookingDetails	Kommentar
	Begäran
	healthcareFacility	HSA-id för mottagningen/vårdenheten.
	bookingId	Intern bokningsidentitet för bokad tid.
	Svar
	Timeslot	Den tidslucka som är bokad.
	startTimeInclusive	Startdatum och klockslag för den bokade tiden.
	endTimeInclusive	Slutdatum och klockslag för den bokade tiden. Om sluttid ska visas i gränssnittet eller inte väljer verksamheterna själva. Att visa sluttid beställs från e-tjänsternas tekniska support vid anslutning. Per default visas inte sluttid.
	healthcareFacility	HSA-id för mottagningen/vårdenheten. Ska matcha begäran. Visas ej
	healthcareFacilityName	Namn på bokad mottagning/vårdenhet. Visas ej. Namnet på mottagningen hämtas ifrån 1177 e-tjänster, inte från healthcareFacilityName.
	performer	Vårdpersonalens HSA-id. Visas ej.
	performerName	Vårdpersonalens namn. Visas bredvid mottagningens namn.
	bookingId	Bokningsid för bokad tid. Ska matcha begäran. Visas ej.
	subjectOfCare	Invånarens person-id.
	purpose	Information från verksamheten. “Information från vården” visas alltid som rubrik i gränssnittet om information skickas i fältet. Om text skickas enligt DocBook-format kan en eller flera underrubriker definieras av verksamheten och visas i detta fält
	reason	Anledning till bokningen. Visas i gränssnittet om det finns en bokningsanledning angiven.
	resourceName	Namn på resurs. Finns performerName så visas det bredvid namnet på mottagningen. Om performerName inte finns så visas resourceName.
	resourceId	Id för resurs. Visas ej.
	timeTypeName	Namn för tidstyp. Visas vid “bokningen avser”.
	timeTypeId	Id för tidstyp. Visas ej.
	careTypeName	används ej
	careTypeId	används ej
	cancelBookingAllowed	Anger om bokningen kan avbokas. Om true, visas knappen Avboka.
	rebookingAllowed	Anger om bokningen kan ombokas. Om true, visas knappen Omboka.
	messageAllowed	Anger om orsak till avbokning kan skickas med i berörda tjänster. Orsak kan inte skickas om värdet saknas eller om värdet är false. Om true, ska fältet reason visas i Steg 2.
	isInvitation	Anger om bokningen är skapad från vården.

Steg 1 - Godkänn villkorstext

För den mottagning som avbokningen avser visas villkorstext upp för användaren som ska läsas igenom och godkännas genom att kryssa i “Jag har tagit del av den fullständiga informationen”. Villkorstexten tillhör e-tjänsten för av/omboka.

Villkorstext hämtas från 1177 e-tjänsters personalsida. Här finns en manual för hur den lokala administratören redigerar villkorstexten:https://inera.atlassian.net/wiki/spaces/OIIP/pages/3587604481 och här finns manualen för hur den regionala administratören skapar och redigerar villkorstext: https://inera.atlassian.net/wiki/spaces/OIIP/pages/3584755192 .

Gränssnitt	Admin	Kommentar

Gränssnitt

Admin

Kommentar

Koppling mellan mottagning och specifika villkorstexter ställs in av den regionala eller lokala administratören i 1177 Vårdguidens e-tjänster.

Villkorstext tillhörande mottagningen som avbokningen avser.

Invånaren måste klicka i “Jag har tagit del av den fullständiga informationen” för att komma vidare.

Fortsätt- knappen är klickbar även om kryssrutan inte är ifylld, men invånaren får hjälp att se vad som måste fyllas

Steg 2 - Ange anledning till avbokning

Gränssnitt	Kommentar

Gränssnitt

Kommentar

Invånaren kan eventuellt ange en anledning till avbokningen i steget “Information till vården”.

Om invånaren ska ange detta eller inte skickas i tjänstekontraktet GetBookingDetails, fält timeslot/messageAllowed = true.

Giltiga tecken:

alfabetet
siffrorna 0-9
följande tecken: ! % # / ( ) = ? + * _ : ; { } [ ] @ . , \ - “

I sammanställningen för den avbokade tiden, visas den angivna avbokningsanledningen.

Steg 3 - Bekräfta avbokning

När invånaren har fyllt i allt för avbokningen ombeds hen granska sammanställningen och därefter bekräfta genom att klicka på Avboka tid.

CancelBooking

Gränssnitt	Tjänstekontrakt CancelBooking	Kommentar

Gränssnitt	Tjänstekontrakt CancelBooking	Kommentar
	Begäran
	healthcareFacility	HSA-id för den mottagning/vårdenhet. (Samma HSA-id som skickas i getBookingDetails)
	bookingId	Intern bokningsidentitet för den bokade tiden som ska ska avbokas.
	message	Invånarens beskrivning av orsak till avbokningen. Fältet kan bara skickas om värdet på messageAllowed = true i GetBookingDetails.

	Svar
	resultCode	Status för den gjorda avbokningen. OK, INFO eller ERROR
	resultText	Status för den gjorda avbokningen.

Felmeddelanden

resultCode = ERROR, resultText saknas

Om förfrågan på avbokning nått mottagaren, men ett fel uppstår på mottagarens sida, visas ett felmeddelande upp. Om ingen text returneras i resultText visas följande felmeddelande:

resultCode = ERROR, resultText returneras

Om förfrågan på avbokning nått mottagaren, men ett fel uppstår på mottagarens sida, visas ett felmeddelande upp. Meddelande som visas är från CancelBooking-fältet resultText då resultCode = ERROR.

resultCode returneras ej

Om en förfrågan på avbokning skickas, men ingen resultCode returneras, visas följande felmeddelande:

Bekräftelse på avbokning i gränssnittet

När avbokningen är genomförd skapas en bekräftelser på avbokningen i gränssnittet baserat på den information som finns innan avbokningen är genomförd. Samtidigt skapas en bokningsbekräftelse baserat på samma information som hamnar i 1177 Inkorg.

Information från verksamhetssystemen som visas i bokningsbekräftelsen:

Dag & tid
Mottagning (+ ev. namn på personal + ev. namn på resurs. Visas ej i skärmdumpen)
- namnet på mottagningen hämtas från 1177s egna databas
Bokningen avser (tidstyp)
Anledning till avbokning
Information från vården. Under denna rubrik visas både purpose och ResultText i de fall resultCode=INFO.

Länkar som kan hänvisa invånaren vidare:

Bekräftelsen finns i din inkorg
Se bokade tider (länk till mottagningens bokade tider)
<namn på mottagning>

Bekräftelse i 1177 inkorg

En bekräftelse på avbokningen skickas till invånarens inkorg på 1177 genom att använda tjänstekontraktet AddMessage.

AddMessage

Nedan informationsmappning visar hur 1177 skapar ett inkorgsmeddelande när en avbokning har genomförts.

Gränssnitt	Tjänstekontrakt AddMessage	Kommentar

Gränssnitt	Tjänstekontrakt AddMessage	Kommentar
	Begäran
	subjectOfCareId	Invånarens personnummer
	threadId	Meddelandets tråd-id. Utgörs av hsaId+bookingId.
	threadTitle	Trådtitel sätts alltid till “Tidbokning“.
	threadLabel	Skickas ej
	message	-
	message.title	Meddelandets titel
	message.text	Meddelandets text i DocBook-format. Här visas: Dag och tid: startTimeInclusive (samt eventuellt endTimeInclusive) Mottagning: namnet kommer från e-tjänsterna Bokningen avser: timeTypeName Anledning till avbokning: reason Information: resultText i de fall resultCode=INFO. Information från vården: purpose
	message.organisationUnit	-
	message.organisationUnit.unitId	hsaId
	message. organisationUnit.unitName	Mottagningens namn
	message.serviceLink	Skickas ej
	message.serviceLink.serviceId	Skickas ej
	message.serviceLink.queryString	Skickas ej
	message.serviceLink. hasAttachment	Skickas ej
	message.actions	Skickas ej vid avbokning
	message.actions.queryString	Skickas ej vid avbokning
	message.actions.text	Skickas ej vid avbokning
	message.actions.serviceId	Skickas ej vid avbokning
	message.actions.displayType	Skickas ej vid avbokning
	notify	Skickas som false
	queueForDays	Skickas ej
	approve	Skickas som false
	accountableOrganisation	Tidboken skickar 1177 e-tjänsters hsaId.
	Svar
	threadId	Meddelandets tråd-id.
	resultCode	Status för AddMessage-anropet. OK, INFO, ERROR.
	resultText	Ev. meddelande kopplat till resultatkoden. Vid resultCode INFO visas meddelandet upp i bokningsbekräftelsen.

Välja bort att bekräftelse skickas från 1177 vid avbokning

Det är möjligt att per tidbokningstjänst välja bort att 1177 skickar en bekräftelse på avbokningen till invånarens inkorg. Syftet med funktionen är att regionerna ska ha möjlighet att välja att bekräftelsen i stället skickas direkt från verksamhetssystemen till invånarens inkorg på 1177. Inställningen görs av regional administratör i 1177 personalverktyg.

Öppen info: 1177 tidbokning

Avbokning, avboka tid

Flödet

Tjänstekontrakt som används vid flödet Avbokning

Sammanställning av bokad tid