...

Ingång till flödet för ombokning startar i Mina bokade tider hos en mottagning eller i Bokade tider. 

...

Omboka - Villkorssida, välj mottagning

Image Removed

Formatering av villkorstexter

getBookingDetails

...

Namn

...

Typ

...

Kommentar

...

Begäran

...

healthcare_facility

...

HsaIdType

...

HSA-id för mottagning/vårdenhet

...

bookingId

...

BookingIdType

...

Intern bokningsidentitet.

...

Svar

...

TimeSlotDetail

...

TimeslotType

...

Information om den aktuella tiden

• TimeSlotDetail [1..1]
  • startTimeInclusive [0..1]
  • endTimeExclusive[0..1]
  • healthcare_facility [1..1]
  • performer[0..1]
  • bookingId[0..1]
  • subject_of_care[1..1]
  • purpose[0..1]
  • reason[0..1]
  • resourceName[0..1]
  • healthcare_facility_name[0..1]
  • performerName[0..1]
  • resourceID[0..1]
  • timeTypeName[0..1]
  • timeTypeID[0..1]
  • careTypeName[0..1]
  • careTypeID[0..1]
  • cancel_booking_allowed[1..1]
  • rebooking_allowed[1..1]
  • message_allowed[1..1]
  • isInvitation [0..1]

En timeslotDetail hämtas för den aktuella bokningen för att kunna visa upp tillgänglig information i den gula sammanfattningsrutan. Först visas:

• startTimeInclusive
• endTimeInclusice

endTimeInclusive visas beroende av inställningar på mottagningsnivå i 1177 Vårdguidens e-tjänster/Mina vårdkontakter

Efter den bokade tiden i rubriken visas en av följande (om detta finns, enligt priolista):

1. performerName
2. resourceName
3. careTypeName
4. finns ingen av dessa visas det ingen text

Mottagning:

• Namnet på mottagningen hämtas ifrån 1177 Vårdguidens e-tjänster, inte från healthcareFacilityName

Typ av tid:

• timeTypeName

Anledning till besöket:

• reason
• [visa mer], visar hela meddelandet (länken visas bara ifall meddelandet är mer än 90 tecken)
• [dölj text], visar bara 90 tecken

Purpose visas längst ned utan rubrik:

• purpose (kan vara DocBook eller vanlig text)
• [visa mer], visar hela meddelandet (länken visas bara ifall meddelandet är mer än 90 tecken och inte DocBook)
• [dölj text], visar bara 90 tecken

Välj mottagning

När sidan laddas in hämtas alla tillgängliga mottagningar och om möjligt sätts en initialt vald mottagning i dropdown-listan och relevant villkorstext visas. getAllHealthcareFacilities hämtar eventuella tillgängliga mottagningar och getSupportedServicecontracts

GetAllHealthcareFacilities

...

Namn

...

Typ

...

Kommentar

...

Begäran

...

healthcare_facility

...

HsaIdType

...

HSA-id för mottagning/vårdenhet

...

subject_of_care

...

SubjectOfCareIdType

...

Personnummer enl. yyyymmddxxxx.

Kan användas för att filtrera vad en tjänsteproducent ska returnera för en viss patient (även vid nybokning).

...

bookingId

...

BookingIdType

...

Internt bokningsid. Obligatoriskt när förfrågan gäller ombokning. Detta bokningsid behövs för tjänsteproducenten ska kunna filtrera på egenskaper för en grundbokning

...

Svar

...

healthcareFacilityInfos

...

HealthcareFacilityInfoType

...

Lista med tillgängliga mottagningar/vårdenheter

healthcareFacilityInfos [0..*]

• healthcare_facility [1..1]
• healthcare_facility_name [0..1]

...

Villkorstext

Villkorstext tillhörande vald mottagning. Koppling mellan mottagning och specifika villkorstexter ställs in i 1177 Vårdguidens e-tjänster/Mina vårdkontakter.

...

Omboka - Ombokningssida, välj person

Image Removed

getBookingDetails

...

Namn

...

Typ

...

Kommentar

...

Begäran

...

healthcare_facility

...

HsaIdType

...

HSA-id för mottagning/vårdenhet

...

bookingId

...

BookingIdType

...

Intern bokningsidentitet.

...

Svar

...

TimeSlotDetail

...

TimeslotType

...

Information om den aktuella tiden

• TimeSlotDetail [1..1]
  • startTimeInclusive [0..1]
  • endTimeExclusive[0..1]
  • healthcare_facility [1..1]
  • performer[0..1]
  • bookingId[0..1]
  • subject_of_care[1..1]
  • purpose[0..1]
  • reason[0..1]
  • resourceName[0..1]
  • healthcare_facility_name[0..1]
  • performerName[0..1]
  • resourceID[0..1]
  • timeTypeName[0..1]
  • timeTypeID[0..1]
  • careTypeName[0..1]
  • careTypeID[0..1]
  • cancel_booking_allowed[1..1]
  • rebooking_allowed[1..1]
  • message_allowed[1..1]
  • isInvitation [0..1]

En timeslotDetail hämtas för den aktuella bokningen för att kunna visa upp tillgänglig information i den gula sammanfattningsrutan. Först visas:

• startTimeInclusive
• endTimeInclusice

endTimeInclusive visas beroende av inställningar på mottagningsnivå i 1177 Vårdguidens e-tjänster/Mina vårdkontakter

Efter den bokade tiden i rubriken visas en av följande (om detta finns, enligt priolista):

1. performerName
2. resourceName
3. careTypeName
4. finns ingen av dessa visas det ingen text

Mottagning:

• Namnet på mottagningen hämtas ifrån 1177 Vårdguidens e-tjänster, inte från healthcareFacilityName

Typ av tid:

• timeTypeName

Anledning till besöket:

• reason
• [visa mer], visar hela meddelandet (länken visas bara ifall meddelandet är mer än 90 tecken)
• [dölj text], visar bara 90 tecken

Purpose visas längst ned utan rubrik:

• purpose (kan vara DocBook eller vanlig text)
• [visa mer], visar hela meddelandet (länken visas bara ifall meddelandet är mer än 90 tecken och inte DocBook)
• [dölj text], visar bara 90 tecken

Välj person

getAllPerformers

...

Namn

...

Typ

...

Kommentar

...

Begäran

...

healthcare_facility

...

HsaIdType

...

HSA-id för mottagning/vårdenhet

...

timeTypeIDs

...

TimeTypeIDType

...

Tidstypid för att begränsa svarslistan.

...

careTypeIDs

...

CareTypeIDType

...

Vårdtypsid för att begränsa svarslistan. Ska stödjas av producent om GetAllCaretypes stödjs. Konsument får bara skicka värden till producent som stödjer GetAllCaretypes.

...

subject_of_care

...

SubjectOfCareIdType

...

Personnummer enl. yyyymmddxxxx för begränsa/utöka svarslistan.

...

Svar

...

performerinfos

...

PerformerInfoType

• performerInfos [0..*]
  • performer [1..1]
  • firstName [1..1]
  • lastName [1..1]
  • title [0..1] 

...

Omboka - Ombokningssida, välj dag och tid

Image Removed

Vid inladdning av sektionen väljs automatiskt den första dagen med lediga tider och kommer då förutom att göra anropet getAvailableDates samtidigt anropa getAvailableTimeSlots (se nästa sektion) för att kunna visa upp tillgängliga tider den dagen. Den initiala sökningen av dagar med lediga tider görs på innevarande månad samt nästkommande månad, detta innebär exempelvis att om dagens datum är 15 januari så söks det från 15 januari till och med sista februari. Om det inte finns några datum med lediga tider under den perioden görs en ny sökning för de efterföljande två månaderna, dvs 1 mars till och med 31 april. Det innebär att anslutande producentsystem behöver kunna hantera anropet getAvailableDates med datumperioder på maximalt 62 dagar.

getAvailableDates

...

Namn

...

Typ

...

Kommentar

...

Begäran

...

healthcare_facility

...

HsaIdType

...

Hsa-Id för mottagning/vårdenhet

...

bookingId

...

BookingIdType

...

Intern bokningsidentitet. Används för att indikera ombokning, så att tjänsteproducenten kan anpassa svaret till tider som är giltiga för ombokning av angiven bokning.

...

startDateInclusive

...

DT

...

Datum från och med för de lediga tider som skall sökas ut, på formatet ÅÅÅÅMMDD.

...

endDateInclusive

...

DT

...

Datum till och med för de lediga tider som skall sökas ut, på formatet ÅÅÅÅMMDD.

...

timetypeName

...

string

...

Tidstyp. Det finns en begränsning i 1177 Vårdguidens e-tjänster för antal tecken i namnet på tidstyp och den begränsningen är 100 tecken.

...

timeTypeID

...

TimeTypeIDType

...

Identitet för tidstyp

...

careTypeName

...

string

...

Vårdtyp. Ska stödjas av producent om GetAllCaretypes stödjs. Konsument får bara skicka värden till producent som stödjer GetAllCaretypes.

...

careTypeID

...

CareTypeIDType

...

Identitet för vårdtyp. Ska stödjas av producent om GetAllCaretypes stödjs. Konsument får bara skicka värden till producent som stödjer GetAllCaretypes.

...

performer

...

HsaIdType

...

HSA-id för HoS-personal

...

subject_of_care

...

SubjectOfCareIdType

...

Personnummer enl. yyyymmddxxxx.

...

...

Svar

...

performerAvailabilityByDate

...

PerformerAvailabilityByDateType

...

Lista med tillgängliga tider

PerformerAvailabilityByDateType[0..*]

• healthcare_facility[1..1]
• performer[0..1]
• date [1..1]
• resourceName[0..1]
• resourceID[0..1]
• timeTypeName[0..1]
• timeTypeID[0..1]
• careTypeName[0..1]
• careTypeID[0..1]

...

Image Removed

...

Image Removed

...

Image Removed

...

Image Removed

Alternativet "Sök längre fram i tiden efter ...." har samma funktion som att klicka på "nästa månad"-knappen i kalendern, det görs då en sökning på nästkommande månad efter dagar med lediga tider.

Image Removed

Om inga tillgängliga datum returneras visas istället en informationstext som på bilden ovan.

Välj tid

Image Removed

Vid val av dag i kalender eller lista visas tillgängliga tider under "VÄLJ TID" med start- och sluttid. Om performerName, resourceName eller careTypeName finns visas en av dem efter tiden (enligt den prioriteten).

getAvailableTimeslots

...

Namn

...

Typ

...

Kommentar

...

Begäran

...

healthcare_facility

...

HsaIdType

...

Hsa-ID för mottagning/vårdenhet

...

bookingId

...

BookingIdType

...

Intern bokningsidentitet. Används för att indikera ombokning, så att tjänsteproducenten kan anpassa svaret till tider som är giltiga för ombokning av angiven bokning.

...

startDateInclusive

...

DT

...

Datum från och med för de lediga tider som skall sökas ut, på formatet ÅÅÅÅMMDD.

...

endDateInclusive

...

DT

...

Datum till och med för de lediga tider som skall sökas ut, på formatet ÅÅÅÅMMDD.

...

performer

...

HsaIdType

...

HSA-id för HoS-personal

...

timetypeName

...

string

...

Tidstyp. Det finns en begränsning i 1177 Vårdguidens e-tjänster för antal tecken i namnet på tidstyp och den begränsningen är 100 tecken.

...

timeTypeID

...

TimeTypeIDType

...

Identitet för tidstyp

...

careTypeName

...

string

...

Vårdtyp. Ska stödjas av producent om GetAllCaretypes stödjs. Konsument får bara skicka värden till producent som stödjer GetAllCaretypes.

...

careTypeID

CareTypeIDType

...

Identitet för vårdtyp. Ska stödjas av producent om GetAllCaretypes stödjs. Konsument får bara skicka värden till producent som stödjer GetAllCaretypes.

...

subject_of_care

...

SubjectOfCareIdType

...

Personnummer enl. yyyymmddxxxx.

...

Svar

...

TimeSlotDetail

...

TimeslotType

...

Lista med tillgängliga tider

• TimeSlotDetail [0..*]
  • startTimeInclusive [1..1]
  • endTimeExclusive[1..1]
  • healthcare_facility [1..1]
  • performer[0..1]
  • bookingId[0..1]
  • purpose[0..1]
  • reason[0..1]
  • resourceName[0..1]
  • healthcare_facility_name[0..1]
  • performerName[0..1]
  • resourceID[0..1]
  • timeTypeName[0..1]
  • timeTypeID[0..1]
  • careTypeName[0..1]
  • careTypeID[0..1]
  • cancel_booking_allowed[0..1]
  • rebooking_allowed[0..1]
  • message_allowed[0..1]

...

Omboka - Ombokningssida, anledning till besök/telefonnummer

Image Removed

Det görs inget nytt anrop med getAvailableTimeslots när denna sektion laddas, anropet sker när vi laddar in de tillgängliga tiderna i förgående sektion "Välj tid" och när en tid sedan väljs följer alla parametrar med. message_allowed-parametern styr om kommentarsfältet visas eller ej. Om message_allowed är "true" är det obligatoriskt att skriva in en kommentar.  Finns inget ifyllt i fältet är knappen "Fortsätt till nästa steg i ombokningen" utgråad. En grå text ("Jag ombokar tiden med anledning av ...") visas i kommentarsfältet innan fältet markeras eller skrivs i.

...

Texten i fältet för kommentar kontrolleras så att inga skadliga tecken kan skickas till tidbokningssystemen. Följande tecken är giltiga:

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

Image Removed

Om message_allowed är "false" visas ej rubriken "Vad är anledningen till bokningen?" samt kommentarsfältet, enbart fält för telefonnummer och "Fortsätt till nästa steg i ombokningen"-knappen visas då. Knappen är aktiv från början. Telefonnumret hämtas och fylls i automatiskt om invånaren skrivit in det i motsvarande fält i sina egna "Inställningar" för 1177 Vårdguidens e-tjänster. Fältet för telefonnummer har begränsningar på vilka tecken som får skrivas in. Idag får endast siffror (0, 1, 2, 3, 4, 5, 6, 7, 8, 9), mellanslag, bindestreck och plustecken skrivas, försöker man skriva in något annat så skrivs inget in i fältet.

...

Omboka - Sammanfattning av tiden

Image Removed

Det görs inget nytt anrop med getAvailableTimeslots när denna sektion laddas, anropet sker när vi laddar in de tillgängliga tiderna i sektionen "Välj tid" och när en tid sedan väljs följer alla parametrar med.

I den gula sammanfattningsrutan visas följande:

• startTimeInclusive
• endTimeInclusice

endTimeInclusive visas beroende av inställningar på mottagningsnivå i 1177 Vårdguidens e-tjänster

Efter den bokade tiden i rubriken visas en av följande (om detta finns, enligt priolista):

1. performerName
2. resourceName
3. careTypeName
4. finns ingen av dessa visas det ingen text

Mottagning:

• Namnet på mottagningen hämtas ifrån 1177 Vårdguidens e-tjänster, inte från healthcareFacilityName

Typ av tid:

• timeTypeName

Anledning till besöket:

• reason
• [visa mer], visar hela meddelandet (länken visas bara ifall meddelandet är mer än 90 tecken)
• [dölj text], visar bara 90 tecken

Purpose visas längst ned utan rubrik:

• purpose (kan vara DocBook eller vanlig text)
• [visa mer], visar hela meddelandet (länken visas bara ifall meddelandet är mer än 90 tecken och inte DocBook)
• [dölj text], visar bara 90 tecken

Ja, genomför ombokningen (updateBooking)

...

Namn

...

Typ

...

Kommentar

...

Begäran

...

requestedTimeSlot

...

TimeslotType

...

subject_of_care_info

...

SubjectOfCareType

...

notification

...

string

...

Avisering

...

Svar

...

resultCode

...

ResultCodeEnum

...

Status för den gjorda avbokningen.

Returkoder enligt beskrivning

...

resultText

...

string

...

Ev. meddelande kopplat till resultatkoden

...

updateBooking

...

Request

...

• hsaId
• activeSubjectOfCare
• subjectOfCareId
• actor
• timeslotDetail (med följande parametrar)
  • startTimeInclusive
  • endTimeExclusive
  • healthcareFacility
  • performer
  • bookingId
  • subjectOfCare
  • purpose
  • reason
  • resourceName
  • healthcareFacilityName
  • performerName
  • resourceId
  • careTypeName
  • careTypeId
  • timeType
  • cancelBookingAllowed
  • rebookingAllowed
  • messageAllowed
  • isInvitation
  • endTimeSuppressionConfigured

...

Response

...

UpdateBookingServiceResponse innehållande UpdateBookingServiceResponse

• resultCode

...

Ombokning - Fel vid ombokning

Om ombokningen misslyckades efter att man klickat på knappen "Ja, genomför ombokningen" visas en felsida när resultCode är "ERROR". Texten "Tiden är inte ombokad. Var vänlig försök igen!" visas alltid på sidan.

resultCode = "ERROR" och ingen resultText returneras:

Image Removed

resultCode = "ERROR" och resultText returneras:

resultText visas i sidan, i exemplet nedan som "ResultText är detta, bokningssystemet uppdateras och ligger nere under blabla ...". Observera att "Tiden är inte bokad. Var vänlig försök igen!" visas oavsett om resultText returneras eller ej.

...

Omboka - Sida för bekräftelse, ombokning

Image Removed

Information om den bokade tiden skickas från förgående sida (bokningssidan) till bekräftelsesidan

• startTimeInclusive
• endTimeInclusice

endTimeInclusive visas beroende av inställningar på mottagningsnivå i 1177 Vårdguidens e-tjänster/Mina vårdkontakter

Efter den bokade tiden i rubriken visas en av följande (om detta finns, enligt priolista):

1. performerName
2. resourceName
3. careTypeName
4. finns ingen av dessa visas det ingen text

Mottagning:

• Namnet på mottagningen hämtas ifrån 1177 Vårdguidens e-tjänster, inte från healthcareFacilityName

Typ av tid:

• timeTypeName

Anledning till besöket:

• reason
• [visa mer], visar hela meddelandet (länken visas bara ifall meddelandet är mer än 90 tecken)
• [dölj text], visar bara 90 tecken

Information: 

• Om resultCode är "INFO" visas resultText
• Om resultCode är "OK" visas ingen text

Purpose visas längst ned utan rubrik:

...

Observera

Den här sidan har flyttats till Ombokning, omboka tid. Denna sida uppdateras inte längre och kommer att tas bort den 15 maj 2024. Om du har lagt till sidan som en favorit i webbläsaren eller i Confluence, se till att byta ut den till den rätta länken Ombokning, omboka tid. Om du har blivit länkad hit, rapportera gärna till e-tjänsternas support var länken finns så att nationella förvaltningen kan kontakta sidans ägare. Här kan du kontakta supporten: https://etjanster.inera.se/oversikt/flow/4221

Flödet

Denna sida går igenom flödet när invånaren ska boka om en tid och hur de olika delarna mappar till vilka tjänstekontrakt och vilka fält.

- Sammanställning av bokad tid	Steg 1 Mottagning	Steg 2 Välj datum och tid (inkl. personal)	Steg 3 Information till vården	Steg 4 Bekräfta ombokning	- Bekräftelse på ombokning i gränssnittet	- Bekräftelse i 1177 inkorg
Image Added Image Added	Image Added	Image Added	Image Added	Image Added	Image Added	Image Added

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

• 1177 e-tjänster gör ett anrop med GetSupportedContracts 1 gång per dygn och resultatet sparas ned i en cache. 1177 tidbokning kontrollerar cachen när en invånare startar flödet, för att kunna anpassa flödet till de frivilliga kontrakten GetAllPerformers och GetAllHealthcareFacilities.

Sammanställning av bokad tid (Din bokning)

• GetBookingDetails - obligatoriskt tjänstekontrakt. Hämtar information om en bokad tid.

Steg 1

• GetAllHealthCareFacilitites - valfritt tjänstekontrakt. Hämtar eventuell lista med mottagningar.

Steg 2

• GetAllPerformers - valfritt tjänstekontrakt. Hämtar vilken personal som kan erbjudas för efterfrågad tidstyp.

• GetAvailableDates - obligatoriskt tjänstekontrakt. Hämtar datum där det finns minst en ledig tid för avsedd tidstyp.

• GetAvailableTimeslots - obligatoriskt tjänstekontrakt. Hämtar lediga tider för avsedd tidstyp.

Steg 4

• UpdateBooking - obligatoriskt tjänstekontrakt. Uppdaterar en bokning till en ny bokad tid.

Bekräftelse i 1177 inkorg

• AddMessage - 1177 skapar bekräftelse på ombokning som hamnar i invånarens inkorg på 1177.

Sammanställning av bokad tid (Din bokning)

Gränssnitt	Tjänstekontrakt GetBookingDetails	Kommentar
	Begäran
	healthcareFacility	HSA-id för mottagningen/vårdenheten.
	bookingId	Intern bokningsidentitet för bokad tid.
Image Added	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. Info 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. Info 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. Visas bredvid namnet på mottagningen om det skickas.
	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 ombokning 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- Mottagning

Mottagning

Om tjänstekontraktet GetAllHealthcareFacilities inte stödjs, visas endast den mottagning som bokningen avsåg.

Välj annan mottagning

GetAllHealthcareFacilities

Info

Listan med mottagningar visas endast om GetAllHealthcareFacilities stödjs enligt tjänsteadresseringskatalogen (GetSupportedServiceContracts).  Mottagningarna som returneras via GetAllHealthcareFacilities måste finnas i 1177 e-tjänster med motsvarande tjänstekonfiguration för nybokning. Finns inte mottagningarna eller om de saknar tjänst för nybokning så filtreras de bort i rullgardinslistan. Det får inte finnas fler än ett tidbokningssystem ansluten till mottagningen. Regionerna ansvarar för att säkerställa att mottagningarna stödjer samma tidstyper (i annat fall kan det blir fel om invånaren kommer in i tidbokningsflödet från t.ex. triagering och väljer en annan mottagning) GetAllHealthcareFacilities stöds inte i de fall mottagningen använder child-HSA-id (läs mer om child här). I dessa fall visas ingen lista med mottagningar.

Om tjänstekontraktet GetAllHealthcareFacilities används så hämtas en lista på tillgängliga mottagningar och dessa presenteras.

När sidan laddas in hämtas alla tillgängliga mottagningar. Om den mottagning invånaren kom in i tjänsten via returneras så är den förvald och relevant villkorstext visas, annars är ingen mottagning förvald.

Gränssnitt	Tjänstekontrakt GetAllHealthcareFacilitites	Kommentar
	Begäran
	healthcare_facility	HSA-id för mottagning/vårdenhet
	subject_of_care	Invånarens personnummer enl. yyyymmddxxxx. Kan användas för att filtrera vad en tjänsteproducent ska returnera för en viss patient (även vid nybokning).
	bookingId	Internt bokningsid. Obligatoriskt när förfrågan gäller ombokning. Detta bokningsid behövs för tjänsteproducenten ska kunna filtrera på egenskaper för en grundbokning.
Image AddedImage Added	Svar
	healthcareFacilityInfos 0..*	Lista med tillgängliga mottagningar/vårdenheter Om mottagningen returnerar sig själv i GetAllHealthcareFacilities väljs den automatiskt. Om mottagningen inte returnerar sig själv i GetAllHealthcareFacilities väljs inget i listan utan valet “Välj vårdenhet” visas.
	healthcareFacility 1..1	Mottagningens hsa-id. Visas ej i gränssnittet.
	healthcareFacility name 0..1	Mottagningens namn

Steg 1 - Godkänn villkorstext

För vald mottagning 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”. Om mottagning ändras av invånaren (som erbjuds via GetAllHealthcareFacilites), ändras villkorstexten till den valda mottagningens.

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/OIN1VEFP/pages/2164556469/rendetyper#id-%C3%84rendetyper-Sparaochaktiveraencentraladministrerad%C3%A4rendetyp(webbtidbokstj%C3%A4nstelleruthoppstj%C3%A4nst) och är finns manualen för hur den regionala administratören skapar och redigerar villkorstext: https://inera.atlassian.net/wiki/spaces/OIN1VEFP/pages/3050485/Tj+nsteutdelning+webbtidbok#Tj%C3%A4nsteutdelningwebbtidbok-%C3%84ndranamnellervillkorstextf%C3%B6renwebbtidbokstj%C3%A4nst .

Gränssnitt	Admin	Kommentar
Image Added	Koppling mellan mottagning och specifika informations- och villkorstexter ställs in av den regionala eller lokala administratören i 1177 personalverktyg.	Villkors och - informationstext tillhörande vald mottagning.
Image Added		När invånaren har gått vidare i bokningsflödet, hittas villkors- och informationstexterna igen genom att klicka på “Visa” vid mottagningens namn.

Steg 2 - Välj datum och tid, inkl. personal

Vyn vid Steg 2 “Dag & Tid” i nybokningsflödet visas efter anrop till getAvailableDates, getAvailableTimeSlots och GetAllPerformers.

Info
Listan med personal visas endast om GetAllPerformers stödjs enligt tjänsteadresseringskatalogen GetSupportedServiceContracts samt om det returneras personal vid anrop (ej om listan är tom).

GetAllPerformers

Tjänstekontraktet GetAllPerformers är ej obligatoriskt, men om det stödjs visas personal samtidigt som “välj dag och tid”. Tjänstekontraktet används för att kunna filtrera vilken personal invånaren kan välja att boka tid hos.

Info
Ingen dropdownlista med “välj personal” visas om mottagningen inte stödjer tjänstekontraktet GetAllPerformers mottagningen stödjer tjänstekontraktet GetAllPerformers, men ingen personal returneras i svaret

Gränssnitt	Tjänstekontrakt GetAllPerformers	Kommentar
	Begäran
	healthcare_facility	HSA-id för mottagning/vårdenhet.
	timeTypeIDs	Tidstypid för att begränsa svarslistan.
	careTypeIDType	Används ej
	subject_of_care	Personnummer för den invånare som bokningen avser. Format enligt yyyymmddxxxx.
Image Added	Svar
	performerinfos 0..*	Visar en lista med personal i vyn med dagar och tider. Default visas ingen personal. Kan innehålla förnamn + efternamn förnamn + efternamn + titel
	performer	Personalens hsa-id. Visas ej.
	firstName	Personalens förnamn. Ska visas.
	lastName	Personalens efternamn. Ska visas.
	title	Personalens titel. Kan visas.

Visningsregler lediga tider

Se visningsregler under Nybokning, Boka tid: https://inera.atlassian.net/wiki/spaces/OVET/pages/2771419342/Nybokning+boka+tid+-+gr+nssnitt+och+tj+nstekontrakt#Visningsregler-lediga-tider

GetAvailableDates

Gränssnitt	Tjänstekontrakt GetAvailableDates	Kommentar
	Begäran
	healthcare_facility	Hsa-Id för mottagning/vårdenhet
	bookingId	Internt bokningsid.
	startDateInclusive	Datum från och med för de lediga tider som skall sökas ut, på formatet ÅÅÅÅMMDD.
	endDateInclusive	Datum till och med för de lediga tider som skall sökas ut, på formatet ÅÅÅÅMMDD.
	timeTypeName	Namn för tidstypen / vad bokningen avser.
	timeTypeID	Id för tidstypen. 1177 skickar den kod som tidbokningssystemet returnerat i ett tidigare steg.
	careTypeName	Används ej
	careTypeID	Används ej
	performer	HSA-id för vårdpersonal. Info Kommer endast ha ett värde om vårdpersonallistan finns och om invånaren har valt en personal.
	subject_of_care	Invånarens personnummer enligt format yyyymmddxxxx.
Image Added   Image Added	Svar
	performerAvailabilityByDate 0..*	Kalendervy visar dagar med lediga tider. Invånaren kan söka vidare, en månad i taget. Första lediga dag med tider visas som förvald i kalendervyn.
	healthcare_facility	Id för mottagningen. Ska matcha begäran. Visas ej i gränssnittet
	performer	Hsa-id för ev. vald personal. Ska matcha begäran. Visas ej.
	performerName	Vårdpersonalens namn. Ska visas.
	date	Ett datum där lediga tider finns. Visas med blå ring runt i kalendern. Utan kalender kan invånaren navigera mellan lediga tider med pilknapparna.
	resourceName	Används ej.
	resourceID	Används ej
	timeTypeName	Namn för vald tidstyp. Ska matcha begäran, men visas inte upp igen (syns i Steg 2 i bokningen.)
	timeTypeID	Id för tidstyp. Ska matcha begäran. Visas ej i gränssnittet
	careTypeName	Används ej
	careTypeID	Används ej

 

GetAvailableTimeSlots

Gränssnitt	Tjänstekontrakt GetAvailableTimeslots	Kommentar
	Begäran
	healthcare_facility	HSA-id för mottagningen/vårdenheten.
	bookingId 0..1	Internt bokningsid.
	startDateInclusive 1..1	Datum för de lediga tider som skall sökas ut. Format: ÅÅÅÅMMDD Info Är samma datum som endDateInclusive. Ett datum-spann sätts i tjänstekontraktet GetAvailableDates, medan det här är 1 datum i förfrågan för att få svar på lediga tider för ett specifikt datum.
	endDateInclusive 1..1	Datum för de lediga tider som skall sökas ut. Format: ÅÅÅÅMMDD Info Är samma datum som startDateInclusive. Ett datum-spann sätts i tjänstekontraktet GetAvailableDates, medan det här är 1 datum i förfrågan för att få svar på lediga tider för ett specifikt datum.
	performer	HSA-id för vårdpersonal. Info Kommer endast ha ett värde om vårdpersonallistan finns och om invånaren har valt en personal.
	timeTypeName	Namn för tidstypen / vad bokningen avser.
	timeTypeID	Id för tidstypen.
	careTypeName	Används ej
	careTypeID	Används ej
	subject_of_care	Invånarens personnummer enligt yyyymmddxxxx.
Image Added	Svar
	TimeSlotDetail	Lista med tillgängliga tider.
	startTimeInclusive	Startdatum och klockslag för ledig tid.
	endTimeInclusive	Slutdatum och klockslag för ledig tid. I gränssnittet visas eventuellt slutdatum och -tid. Info 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. Info Sluttid anges eller anges inte för alla tider på mottagningen, kan ej vara olika.
	healthcareFacility	HSA-id för mottagningen/vårdenheten. Ska matcha begäran. Visas ej.
	healthcareFacilityName	Namn på bokad mottagning/vårdenhet. Visas ej igen. Visas i Steg 1.
	performer	Vårdpersonalens HSA-id. Visas ej.
	performer name	Vårdpersonalens namn. Visas bredvid klockslaget. Ska innehålla en blank-tecken-separerad sammanslagning av yrkestitel, förnamn, mellannamn, efternamn.
	bookingId	Bokningsid för ledig tid/tidslucka. Visas ej,
	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 Fältet visas i steg 5 - Bekräfta bokningen. Observera Observera att länkar bör undvikas i GetAvailableTimeslots/timeslot/purpose då invånaren riskerar att tappa bokningen om hen hoppar ut till annat.
	reason	Anledning till ombokningen. Kan visas i gränssnittets steg 3 “Anledning till ombokningen” om “message_allowed”=true som ett textfält som invånaren ska fylla i. I steg 4 visas vad som har fyllts i. Obligatoriskt för invånaren att fylla i om det visas. Info Max tecken: 255 st Info Giltiga tecken: alfabetet siffrorna 0-9 följande tecken: ! % # / ( ) = ? + * _ : ; { } [ ] @ . , \ - “ Observera Observera att reason egentligen är bokningsanledning, men används som ombokningsanledning för UpdateBooking. När en ombokad tid ska visas för invånaren behöver bokningsanledningen skickas, ev ihop med ombokningsanledningen.
	resourceName	Namn på resurs. Ev. resurs visas i listan med lediga tider. Resurs visas endast om performerName inte finns.
	resourceId	Id för resurs. Visas ej.
	timeTypeName	Namn för vald tidstyp. Ska matcha begäran, men visas inte upp igen (syns i Steg 2 i bokningen) Info Max tecken: 100
	timeTypeId	Id för tidstyp. Ska matcha begäran. Visas ej.
	careTypeName	används ej
	careTypeId	används ej
	cancelBookingAllowed	Anger om bokningen kan avbokas. Används ej i GetAvailableTimeslots utan i GetBookingDetails.
	rebookingAllowed	Anger om bokningen kan ombokas. Används ej i GetAvailableTimeslots utan i GetBookingDetails.
	messageAllowed	Anger om orsak till ombokning 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 3 (se nedan).

Steg 3 - Information till vården

I ombokningsflödets Steg 3 kan invånaren ange information till verksamheten som består av ett eller två textfält

• anledning till ombokningen - är obligatoriskt att fylla i om det visas. Om fältet ska visas beror på om verksamheten har angett message_allowed=true i GetAvailableTimeslots

• telefonnummer - hämtas från inställningarna i 1177 om det finns och visas för invånaren. Kan editeras, men eventuell editering sparas inte i invånarens inställningar i 1177.

Info

Observera att 1177 har implementerat fältet UpdateBooking / timeslot / reason att betyda “ombokningsanledning”, ej kontaktorsak/bokningsanledning som det står beskrivet i tjänstekontraktsbeskrivningen. Om tidbokningssystemet har skickat bokningsanledning (“Jag har ont i knät”)i GetBookingDetails / timeslot / reason, kommer 1177 att returnera en ombokningsanledning i UpdateBooking / timeslot / reason (“Tiden passar inte”). Tidbokningssystemet behöver hålla koll på den ursprungliga bokningsanledningen för att visa upp korrekt bokningsanledning vid en ombokad tid i Bokade tider (fält GetSubjectOfCareSchedule / timeslot / reason), dvs “Jag har ont i knät” och inte “Tiden passar inte” alt. att både “Jag har ont i knät” och “Tiden passar inte” skickas.

Image Added

Steg 4 - Bekräftelse på ombokning i gränssnittet

UpdateBooking

När invånaren har fyllt i allt för ombokningen ombeds hen granska sammanställningen av vald mottagning, datum & tid, information till vården, information från verksamhet och därefter bekräfta genom att klicka på Omboka tid. Ett anrop till tidbokningssystemet sker med tjänstekontraktet UpdateBooking.

Gränssnitt	Tjänstekontrakt UpdateBooking	Kommentar
Image Added	Begäran
	requestedTimeSlot	Tidslucka som ska bokas.
	startTimeInclusive	Startdatum och klockslag för tid som ska bokas.
	endTimeInclusive	Slutdatum och klockslag för tid som ska bokas.
	healthcareFacility	HSA-id för mottagningen/vårdenheten. (Samma HSA-id som skickades i begäran till GetAvailableTimeslots)
	healthcareFacilityName	Namn på bokad mottagning/vårdenhet.
	performer	Vårdpersonalens HSA-id.
	performerName	Vårdpersonalens namn. Ska innehålla en blank-tecken-separerad sammanslagning av yrkestitel, förnamn, mellannamn, efternamn.
	bookingId	Bokningsid för tid/tidslucka som ska bokas.
	subjectOfCare	Personnummer för den invånare som bokningen avser. Format enligt yyyymmddxxxx.
	purpose	Information från vården. Returnerar den information som tidbokningssystemet skickat för den valda tiden.
	reason	Returnerar ombokningsanledning om tidbokningssystemet har efterfrågat informationen. Observera Observera att reason egentligen är bokningsanledning, men används som ombokningsanledning för UpdateBooking. När en ombokad tid ska visas för invånaren behöver bokningsanledningen skickas, ev ihop med ombokningsanledningen.
	resourceName	Namn på resurs. Har ett värde om tidbokningssystemet skickat värde för vald tid.
	resourceId	Id för resurs. Har ett värde om tidbokningssystemet skickat värde för vald tid.
	timeTypeName	Tidstyp för det ombokade besöket (vad bokningen avser).
	timeTypeId	Id för tidstyp.
	careTypeName	Skickas ej
	careTypeId	Skickas ej
	subject_of_care_info/phone	Invånarens telefonnummer Hämtas från inställningarna i 1177 och visas om det finns. Kan editeras av invånaren.
	subject_of_care_info/email	Skickas ej
	subject_of_care_info/address	Hämtas från PU-tjänsten
	subject_of_care_info/coaddress	Skickas ej
	subject_of_care_info/firstName	Hämtas från PU-tjänsten
	subject_of_care_info/middleName	Skickas ej
	subject_of_care_info/lastName	Hämtas från PU-tjänsten
	notification	Skickas ej
	Svar
	resultCode	Status för den gjorda ombokningen. OK, INFO eller ERROR
	resultText	Ev. meddelande kopplat till resultCode

Felmeddelanden

resultCode = ERROR, resultText saknas

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

Image Added

resultCode = ERROR, resultText returneras

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

Image Added

resultCode returneras ej

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

Image Added

Bekräftelse på ombokning i gränssnittet

När ombokningen är genomförd skapas en bekräftelse på ombokningen i gränssnittet baserat på den information som finns innan ombokningen är genomförd. Samtidigt skapas en bekräftelse på ombokningen 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 ombokning

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

Image Added

Bekräftelse i 1177 inkorg

En bekräftelse på ombokningen skickas till invånarens inkorg på 1177 genom att använda tjänstekontraktet AddMessage. Verksamheterna har även själva möjlighet att skapa och skicka bekräftelsen med samma tjänstekontrakt.

AddMessage

Gränssnitt	Tjänstekontrakt AddMessage	Kommentar
Image Added (Sista raden “Om du vill av- eller omboka tiden, gå till Testspecialist B“, är en bug och ska tas bort)	Begäran
	subjectOfCareId	Invånarens personnummer enl. yyyymmddxxxx.
	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 ombokning: reason Information: resultText i de fall resultCode=INFO. Information från vården: purpose
	message.organisationUnit
	message.organisationUnit.unitId	hsaId
	message. organisationUnit.unitName	Mottagningsnamn
	message.serviceLink	Skickas ej
	message.serviceLink.serviceId	Skickas ej
	message.serviceLink.queryString	Skickas ej
	message.serviceLink. hasAttachment	Skickas ej
	message.actions	En action skickas bara om mottagningen har tjänsten VISATID utdelad på sig.
	message.actions.queryString	queryString innehåller hsaid+dynamicId. Används för att skapa en knapp till bokade tider på mottagningen.
	message.actions.text	Text som visas på knappen i bokningsbekräftelsen. Tidboken sätter alltid texten till “Till bokningen“.
	message.actions.serviceId	Tidboken skickar serviceTypeCode VISATID.
	message.actions.displayType	Tidboken skickar displayType BUTTON
	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 ombokning

Det är möjligt att per tidbokningstjänst välja bort att 1177 skickar en bekräftelse på ombokningen 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.