Sektion |
---|
Info |
---|
- Listan med mottagningar visas endast om det stöds enligt tjänsteadresseringskatalogen (GetSupportedServiceContracts).
- Mottagningen måste finnas i 1177 Vårdguidens e-tjänster med motsvarande tjänstekonfiguration för nybokning.
- Det får inte finnas fler än ett tidbokningssystem ansluten till mottagningen.
|
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. GetSupportedServicecontracts |
|
---|
Request | hsaId | Response | List<String> innehållande kontrakt som stöds |
Välj mottagningOm 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. |
Info |
---|
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 för av villkorstexterImage RemovedImage Added 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 punktlisa 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). GetAllHealthcareFacilitiesNamn | 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]
VillkorstextVillkorstext tillhörande vald mottagning. Koppling mellan mottagning och specifika villkorstexter ställs in i 1177 Vårdguidens e-tjänster/Mina vårdkontakter. |
Sektion |
---|
"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/Mina vårdkontakter.
Poppuppfönster med villkorstext tillhörande vald mottagning. Koppling mellan mottagning och specifika villkorstexter ställs in i 1177 Vårdguidens e-tjänster/Mina vårdkontakter. |
Sektion |
---|
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). getAllTimeTypesNamn | 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. |
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]
|
Sektion |
---|
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. getAvailableDatesNamn | 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 | 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]
Datummärkning i kalender | Betydelse |
---|
| Lediga tider finns detta datum | | Inga lediga tider tillgängliga detta datum | | Vald dag med tillgängliga tider |
Alternativet "Sök längre fram i tiden" 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). getAvailableDatesNamn | 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 | 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]
Sektion |
---|
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ö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 visas ej "Fortsätt"-knappen, den visas först när text finns inskrivet, en grå text ("Jag bokar besöket med anledning av ...") visas i kommentarsfältet innan fältet markeras eller skrivs i.
Om message_allowed är "false" visas ej rubriken "Anledning till besök" samt kommentarsfältet, enbart fält för telefonnummer och "Fortsätt"-knappen visas då. 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 tillåtelse att skrivas, försöker man skriva in något annat så skrivs inget in i fältet. getAvailableTimeslotsNamn | 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 | 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]
|
Sektion |
---|
Nybokning - Bokningssida, bekräftelse
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. getAvailableTimeslotsNamn | 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 | 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: Typ av tid: 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)
- [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 | notification | string |
| Svar |
| | bookingId | BookingIdType | Id för skapad bokning. Ska anges vid genomförd bokning (resultCode OK eller INFO), annars inte (ERROR). | resultCode | ResultCodeEnum | Status för den gjorda avbokningen. ResultCode | resultText | string | 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, ny bokning
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 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: Typ av tid: 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: (Detta heter "Meddelande" i inkorgsmeddelandet) - Om resultCode är "INFO" visas resultText
- Om resultCode är "OK" visas ingen text
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)
- [dölj text], visar bara 90 tecken
|
Sektion |
---|
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: Typ av tid: 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)
- [dölj text], visar bara 90 tecken
|
|