Innehållsförteckning |
---|
Utdrag | ||
---|---|---|
Sektion |
Info |
---|
|
GetSupportedServiceContracts anropas först för att kontrollera vilka tjänstekontrakt som 1177 Vårdguidens e-tjänster har behörighet att anropa hos mottagningen.
Välj mottagning
Om kontraktet 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 och om möjligt sätts en initialt vald mottagning i rullgardinsmenyn och relevant villkorstext visas.
Info |
---|
Om mottagningen returnerar sig själv i GetAllHealthcareFacilities-svaret väljs den automatiskt och relevant villkorstext visas upp. |
Om mottagningen inte returnerar sig själv i GetAllHealthcareFacilities väljs inget i listan automatiskt och valet "Välj mottagning" visas.
Info |
---|
Om mottagningen inte returnerar några andra mottagningar visas ingen rullgardinsmeny utan bara villkorstexten för aktuell mottagning. |
Formatering av villkorstexter
Villkortexterna som matas in av vårdgivarna på vårdgivarsidan formateras med samma storlek och marginaler men kan ha olika format avseende fetstil och/eller kursiv text. Texterna har font-size 14px och line-height 20px. Det finns enbart punktlista i editorn för vårdgivaren och det är denna lista som presenteras för invånaren i villkorsrutan. Se bilden på hur texten visas, första punkten i listan visas under rubriken "Boka tid" och ovanför den gråa rutan, resterande visas i rutan under rubriken "Viktigt" (som alltid visas, det behöver ej vårdgivarna skriva in). På femte, sjätte och sjunde raden finns exempel på varianter av formatering av texten (fet stil, kursiv stil, fet och kursiv stil).
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 av den lokala administratören i 1177 Vårdguidens e-tjänster
Nybokning - Bokningssida, popupfönster
"Visa fullständig information igen" är en länk till ett popupfönster med villkorstext tillhörande vald mottagning. Koppling mellan mottagning och specifika villkorstexter ställs in i 1177 Vårdguidens e-tjänster.
Poppuppfönster med villkorstext tillhörande vald mottagning. Koppling mellan mottagning och specifika villkorstexter ställs in i 1177 Vårdguidens e-tjänster.
Nybokning - Bokningssida, välj tidstyp och person
Info |
---|
Om man kommer från en öppen kallelse är detta fält inte valbart. |
Välj typ av tid
Ett anrop görs för att hämta alla tillgängliga tidstyper och dessa visas sedan upp som radioknappar eller som en lista (se bild nedan).
getAllTimeTypes
Namn
Typ
Kommentar
Begäran
healthcare_facility
HsaIdType
HSA-id för mottagning/vårdenhet
careTypeIDs
CareTypeIDType
Vårdtypsidentitet för att begränsa sökningen. 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.
Kan användas för att filtrera vad tjänsteproducenten ska returnera för en viss patient. (T.ex. patient som pga. av sjukdom måste erbjudas enstaka speciella tidstyper, som inte erbjuds alla patienter)
Svar
ListOfTimeTypes
TimeTypesType
Lista med tillgängliga tidstyper
- ListOfTimeTypes [0..*]
- timeTypeName[1..1]
- timeTypeId[1..1]
Info |
---|
Om antalet tidstyper är sju eller fler visas resultaten upp som en lista istället för radioknappar. |
Info |
---|
Om inga tidstyper alls returneras så visas istället ett meddelande "Du kan inte boka en tid. Kontakta din mottagning för mer information.". På det här sättet kan man göra så att tjänsten för att boka tid endast blir tillgänglig för vissa patienter, t ex endast de som har en remiss, genom att inte returnera några tidstyper för de som inte ska kunna boka. |
Välj person
Om antal personer är sex eller färre visas alternativen upp som radioknappar.
Om antal personer är sju eller fler visas alternativen upp som en lista.
Info |
---|
Sektionen visas bara om det stöds enligt tjänsteadresseringskatalogen. |
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]
Nybokning - Bokningssida, välj dag och tid
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. Detta innebär att anslutande producentsystem behöver kunna hantera anropet getAvailableDates med datumperioder på upp till 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]
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.
Om inga tillgängliga datum returneras visas istället en informationstext som på bilden ovan.
Välj tid
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 dessa efter tiden (enligt den prioriteten) (Efraim Glas i bilden).
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
Den här sidan har flyttats till Nybokning, boka 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 Nybokning, boka 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 en ny tid och hur de olika delarna mappar till vilka tjänstekontrakt och vilka fält.
Steg 1 | Steg 1 | Steg 2 | Steg 3 | Steg 4 | Steg 5 | - | - |
---|---|---|---|---|---|---|---|
Tjänstekontrakt som används vid flödet Nybokning
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.
Steg 1
GetAllHealthcareFacilitites - valfritt tjänstekontrakt. Hämtar en lista med mottagningar som bokning kan göras på
Steg 2
GetAllTimeTypes - obligatoriskt tjänstekontrakt. Hämtar vad bokningen avser (tidstyper).
Steg 3 och 4
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 5
MakeBooking - obligatoriskt tjänstekontrakt. Bokar den valda tiden.
Bekräftelse i 1177 inkorg
AddMessage - används för att skicka en bokningsbekräftelse till 1177 inkorg.
Observera |
---|
GetAllCareTypes som finns beskrivet i tjänstedomänen crm:scheduling stöds ej i flödet |
Steg 1 - mottagning
Mottagning
Om tjänstekontraktet GetAllHealthcareFacilities inte stödjs, visas endast den mottagning som initialt valdes.
Välj annan mottagning
GetAllHealthcareFacilities
Info |
---|
|
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 | Personnummer för den invånare som bokningen avser. Format enligt 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. Används ej vid nybokning. Vid öppen kallelse används bokningsid för att läsa upp den fiktiva bokningen. Detta bokningsid behövs för att tjänsteproducenten ska kunna filtrera på egenskaper för en grundbokning. | |
| 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. | |
healthcareFacilityName 0..1 | Mottagningens namn. Visas i gränssnittet. Ignoreras och hämtas istället från HSA, baserat på hsa-id. |
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 |
---|---|---|
Koppling mellan mottagning och specifika villkorstexter ställs in av den regionala eller lokala administratören i 1177 e-tjänster. | Villkorstext tillhörande vald mottagning. 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 i. | |
|
| När invånaren har gått vidare i bokningsflödet, hittas villkorstexterna igen genom att klicka på “Visa” vid mottagningens namn. |
Steg 2 - Bokningen avser
GetAllTimeTypes
I steg 2 väljer invånaren vad som ska bokas genom att välja i den lista som presenteras i GetAllTimeTypes.
Info |
---|
Om invånaren kommer från en öppen kallelse är tidstypen låst och ingen lista med valbara tidstyper presenteras för invånaren. Inget anrop till Tidbokningssystemet med tjänstekontraktet GetAllTimeTypes görs då. |
Gränssnitt | Tjänstekontrakt GetAllTimeTypes | Kommentar | |
---|---|---|---|
| Begäran |
| |
healthcare_facility | HSA-id för mottagning/vårdenhet. | ||
careTypeIDs | Används ej. | ||
subject_of_care | Personnummer för den invånare som bokningen avser. Format enligt yyyymmddxxxx. Kan användas för att filtrera vad tjänsteproducenten ska returnera för en viss patient. (T.ex. patient som pga. av sjukdom måste erbjudas enstaka speciella tidstyper, som inte erbjuds alla patienter) | ||
| Svar |
| |
ListOfTimeTypes | Lista med tillgängliga tidstyper visas upp = vilken bokning invånaren vill göra. En drop-down med tidstyper visas, med texten “Ange vad bokningen avser” visas. Om endast en tidstyp returneras är den förvald. | ||
timeTypeName 1..1 | Namn för tidstypen / vad bokningen avser.
| ||
timeTypeId 1..1 | Id för tidstypen. Visas ej.
|
Inga tidstyper returneras
...
Om inga tidstyper returneras i svaret från GetAllTimeTypes visas ett meddelande upp som hänvisar till mottagningen.
Steg 3 - Datum & tid (inkl. personal)
Vyn vid Steg 3 “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
|
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. | |
| Svar |
|
performerinfos 0..* | Visar en lista med personal i vyn med dagar och tider. Default visas ingen personal. Kan innehålla
| |
performer 1..1 | Personalens hsa-id. Visas ej. | |
firstName 1..1 | Personalens förnamn. Ska visas. | |
lastName 1..1 | Personalens efternamn. Ska visas. | |
title 0..1 | Personalens titel. Kan visas.
|
Visningsregler lediga tider
Info |
---|
Den initiala sökningen av dagar med lediga tider görs på innevarande månad. Detta innebär exempelvis att om dagens datum är 15 januari så söks datum med lediga tider från 15 januari till och med sista januari. Sökning för månader längre fram görs när invånaren navigerar i gränssnittet. |
Finns det lediga tider under innevarande månad så markeras den första dagen med lediga tider. Finns inga lediga tider innevarande månad markeras dagens datum och texten “Det finns inga fler lediga tider denna månad. Gå till nästa månad för att se om det finns lediga tider” visas.
Om det finns dagar med lediga tider längre fram samma månad visas en länk till nästa dag med lediga tider. | Om det inte finns dagar med lediga tider längre fram samma månad än den valda dagen visas en länk för att gå till nästa månad. | Finns inga dagar med lediga tider under en hel månad visas meddelande om detta och en länk för att gå till nästa månad. |
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
...
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]
...
Nybokning - Bokningssida, anledning till besök/telefonnummer
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öregå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 bokningen" utgråad. En grå text ("Jag bokar 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: ! % # / ( ) = ? + * _ : ; { } [ ] @ . , \ -
Invånaren kan max skriva in 250 tecken. Om invånaren försöker skriva fler än 250 tecken skrivs inte dessa tecken i fältet och fältet förblir oförändrat.
...
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 bokningen"-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-9), mellanslag, bindestreck och plustecken tillåtelse att skrivas, försöker man skriva in något annat så skrivs inget in i fältet. Försöker man skriva in fler än 20 tecken läggs detta inte till i fältet och således händer ingenting.
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]
...
Nybokning - Sammanfattning av tiden
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. Klickar man på [visa mer] visas hela meddelandet, klickar man på [dölj text] visas endast 90 tecken efterföljande av [visa mer]-länken.
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]
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):
- performerName
- resourceName
- careTypeName
- 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 bokningen (makeBooking)
...
Namn
...
Typ
...
Kommentar
...
Begäran
...
...
...
Healthcare_facility_med
...
HsaidType
...
requestedTimeslot
...
TimeslotType
...
Information för aktuell bokning
...
Patientens förnamn enligt definition och aktuellt värde hos RSV (högst 5 dagar efter senaste ändring hos RSV).
...
Patientens efternamn enligt definition och aktuellt värde hos RSV (högst 5 dagar efter senaste ändring hos RSV).
...
notification
...
string
...
Svar
...
...
bookingId
...
BookingIdType
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.
| ||
subject_of_care | Invånarens personnummer enligt format yyyymmddxxxx. | ||
Dag&tid vyn fortsätter, se nedan | 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
| ||||||
endDateInclusive 1..1 | Datum för de lediga tider som skall sökas ut. Format: ÅÅÅÅMMDD
| ||||||
performer | HSA-id för vårdpersonal.
| ||||||
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. | ||||||
| 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.
| ||||||
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. | ||||||
performerName | Vårdpersonalens namn. Visas bredvid klockslaget. Ska innehålla en blank-tecken-separerad sammanslagning av yrkestitel, förnamn, mellannamn, efternamn. Om performerName eller resourceName finns visas en av dessa efter tiden (enligt den prioriteten). | ||||||
bookingId | Bokningsid för ledig tid/tidslucka. Visas ej, | ||||||
purpose | Information från vården.
Fältet visas i steg 5 - Bekräfta bokningen.
| ||||||
reason | Anledning till bokningen. Kontaktorsak som invånare uppger vid bokning. Kan visas i gränssnittets steg 4 “Anledning till bokningen” om “message_allowed”=true som ett textfält som invånaren ska fylla i. I steg 5 visas vad som har fyllts i. Obligatoriskt för invånaren att fylla i om det visas.
| ||||||
resourceName | Namn på resurs. Ev. resurs visas i listan med lediga tider. Om performerName eller resourceName finns visas en av dessa efter tiden (enligt den prioriteten). | ||||||
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)
| ||||||
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. Visas ej vid nybokning. | ||||||
rebookingAllowed | Anger om bokningen kan ombokas. Visas ej vid nybokning. | ||||||
messageAllowed | Anger om orsak till nybokning 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 4 (se nedan).
|
Steg 4 - information till vården
I nybokningsflödets Steg 4 kan invånaren ange information till verksamheten som består av ett eller två textfält
anledning till bokningen - ä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.
...
Steg 5 - bekräfta bokningen
Steg 5 - Bekräfta bokningen innehåller en summering av tidigare genomförda steg som invånaren ska granska och bekräfta genom att klicka på “Boka tid”. Inget nytt anrop sker förrän invånaren klickar på “Boka tid”.
Gränssnitt | Rubrik + Tjänstekontrakt.fält | Kommentar |
---|---|---|
Dag & tid GetAvailableTimeslots.startTimeInclusive GetAvailableTimeslots.endTimeInclusive | Datum och klockslag för starttid och ev. sluttid som ska bokas | |
Mottagning (hämtas från HSA) | Namn på bokad mottagning/vårdenhet. | |
Bokningen avser GetAllTimeTypes.timeTypeName | Namn för tidstyp som ska bokas (vad bokningen avser). | |
Anledning till bokningen GetAvailableTimeslots.reason | Eventuell anledning till bokningen. Visas endast om verksamheten har bett om att invånaren ska fylla i. | |
Information från vården GetAvailableTimeslots.purpose | Information från vården.
|
Bokningsbekräftelse i gränssnittet
När invånaren klickat på “Boka tid” sker ett anrop till tidbokningssystemet med tjänstekontraktet MakeBooking. En bokningsbekräftelse visas för invånaren i gränssnittet och samtidigt skapas en bokningsbekräftelse baserat på samma information som hamnar i 1177 Inkorg.
Förutom fälten beskrivna i nedan tabell finns även länkar som kan hänvisa invånaren vidare:
Bekräftelsen finns i din inkorg i e-tjänsterna på 1177.
Se bokade tider (länk till mottagningens bokade tider)
<namn på mottagning> (länk till mottagningens startsida)
MakeBooking
Tjänstekontraktet MakeBooking används för att skicka en bokningsbegäran till verksamhetssystemet.
Gränssnitt | Tjänstekontrakt MakeBooking | Kommentar |
---|---|---|
| Begäran |
|
healthcare_facility_med | ||
healthcare_facility | Mottagningens hsa-id. (Det HSA-id som returnerades i GetAvailableTimeslots. Om HSA-id från svaret i GetAvailableTimeslots är null eller blankt så används istället HSA-id som skickades in i begäran till GetAvailableTimeslots) | |
healthcare_facility_name | Mottagningens namn. | |
startTimeInclusive | Startdatum och klockslag för den tid invånaren vill boka. | |
endTimeExclusive | Slutdatum och klockslag för den tid invånaren vill boka. | |
performer | HSA-id för HoS-person som besöket är bokat hos. Har ett värde om tidbokningssystemet har skickat ett värde för den tiden. | |
performerName | Namn på HoS-person som besöket är bokat hos. Har ett värde om tidbokningssystemet har skickat ett värde för den tiden. | |
bookingId | Skickas ej | |
subject_of_care | Personnummer för den invånare som bokningen avser. Format enligt yyyymmddxxxx. | |
purpose | Returnerar den information som tidbokningssystemet skickat för den valda tiden. | |
reason | Returnerar bokningsanledning om tidbokningssystemet har efterfrågat informationen. | |
resourceId | Id för resurs. Har ett värde om tidbokningssystemet skickat värde för vald tid. | |
resourceName | Namn på resurs. Har ett värde om tidbokningssystemet skickat värde för vald tid. | |
timeTypeName | Tidstyp för det bokade besöket. | |
timeTypsId | Id för tidstyp. | |
careTypeName | Skickas ej | |
careTypeId | Skickas ej | |
notification | 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 | |
| Svar |
|
bookingId | Id för skapad bokning. Ska anges vid genomförd bokning (resultCode OK eller INFO), annars inte (ERROR). Visas ej. | |
resultCode |
...
Status för den gjorda |
...
resultText
...
string
...
bokningen. |
ResultCode
OK, INFO, ERROR | ||
resultText för resultCode=INFO är texten där det står “Här får du lite informationstext att visa upp” resultText för resultCode = ERROR: Se bilder nedan, under Felmeddelande | resultText | Ev. meddelande kopplat till resultatkoden. |
Sektion |
---|
Nybokning - Fel vid bokningOm bokningen misslyckades efter att man klickat på knappen "Ja, genomför bokningen" visas en felsida när resultCode är "ERROR". Texten "Tiden är inte bokad. Var vänlig försök igen!" visas alltid på sidan. resultCode = "ERROR" och ingen resultText returneras: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. |
Sektion |
---|
Nybokning - Sida för bekräftelse, nybokningInformation om den bokade tiden skickas från förgående sida (bokningssidan) till bekräftelsesidan
endTimeInclusive visas beroende av inställningar på mottagningsnivå i Mina Vårdkontakter Efter den bokade tiden i rubriken visas en av följande (om detta finns, enligt priolista):
Mottagning:
Typ av tid:
Anledning till besöket:
Information: (Detta heter "Meddelande" i inkorgsmeddelandet)
Purpose visas längst ned utan rubrik:
|
...
Nybokning - Skapa ny påminnelse-sida
Information om den bokade tiden skickas från förgående sida (bekräftelsesidan) till påminnelsesidan.
- startTimeInclusive
- endTimeInclusice
endTimeInclusive visas beroende av inställningar på mottagningsnivå i Mina Vårdkontakter
Efter den bokade tiden i rubriken visas en av följande (om detta finns, enligt priolista):
- performerName
- resourceName
- careTypeName
- 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:
...
Visas om resultCode = ERROR eller INFO |
Felmeddelanden
resultCode = ERROR, resultText saknas
Om bokningsfö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:
...
resultCode = ERROR + resultText returneras
Om bokningsförfrågan nått mottagaren, men ett fel uppstår på mottagarens sida, visas ett felmeddelande upp. Meddelande som visas är från MakeBooking-fältet resultText då resultCode = ERROR.
...
resultCode returneras ej
Om en bokningsförfrågan skickas, men ingen resultCode returneras, visas följande felmeddelande:
...
Bekräftelse i 1177 inkorg
En bekräftelse på bokningen 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 bokning har genomförts i e-tjänsterna.
Gränssnitt | Tjänstekontrakt AddMessage | Kommentar |
---|---|---|
(Sista raden “Om du vill av- eller omboka tiden, gå till Testvårdcentral A“, är en bug och ska tas bort) | 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 bokning: 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 bokning
Det är möjligt att per tidbokningstjänst välja bort att 1177 skickar en bekräftelse på bokningen 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.