Jämförda versioner

Nyckel

  • Dessa rader lades till.
  • Denna rad togs bort.
  • Formateringen ändrades.

Innehållsförteckning

Nybokning - Villkorssida, välj mottagning

Utdrag
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.

GetSupportedServicecontractsRequesthsaIdResponseList<String> innehållande kontrakt som stöds

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

Image Removed

Om mottagningen returnerar sig själv i GetAllHealthcareFacilities-svaret väljs den automatiskt och relevant villkorstext visas upp.

Info

Image Removed

Image Removed

Om mottagningen inte returnerar sig själv i GetAllHealthcareFacilities väljs inget i listan automatiskt och valet "Välj mottagning" visas.

Info

Image Removed

Om mottagningen inte returnerar några andra mottagningar visas ingen rullgardinsmeny utan bara villkorstexten för aktuell mottagning.

Formatering av villkorstexter

Image Removed

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 

Sektion

Nybokning - Bokningssida, popupfönster

Image Removed

"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.

Image Removed

Poppuppfönster med villkorstext tillhörande vald mottagning. Koppling mellan mottagning och specifika villkorstexter ställs in i 1177 Vårdguidens e-tjänster.

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

Image Removed

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]

Image Removed

Info
Om antalet tidstyper är sju eller fler visas resultaten upp som en lista istället för radioknappar.

Image Removed

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

Image Removed

Om antal personer är sex eller färre visas alternativen upp som radioknappar.

Image Removed

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] 
Sektion

Nybokning - Bokningssida, 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. 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]
Datummärkning i kalenderBetydelse
Image Removed
Lediga tider finns detta datum
Image Removed
Inga lediga tider tillgängliga detta datum
Image Removed
Vald dag med tillgängliga tider

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

Observera

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.

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

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.

 

Image 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.

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

Image Added

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.

 

Image Added

 

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)

 

Image Added

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.

Info

Max tecken: 100 st

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

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

Image AddedImage AddedImage Added

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

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

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. 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):

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

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 AddedImage Added

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

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

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.

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.

  • “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. Här finns en sida som visar på skillnader i e-tjänsternas stöd för DocBook i inkorgen och i tidboken: DocBook - skillnad i stödet för 1177 Inkorg och Tidbokning

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

Info

Max tecken: 255 st

Info

Giltiga tecken:

  • alfabetet

  • siffrorna 0-9

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

Observera

Observera att message_allowed står beskrivet i tjänstekontraktsbeskrivningen att det ska användas för fälten om- och avbokningsanledning men för GetAvailableTimeslots använder 1177 detta fält till att visa eller dölja bokningsanledning.

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)

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.

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).

Observera

Observera att message_allowed står beskrivet i tjänstekontraktsbeskrivningen att det ska användas för fälten om- och avbokningsanledning men för GetAvailableTimeslots använder 1177 detta fält till att visa eller dölja bokningsanledning.

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

Image AddedImage Added

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.

  • “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. Här finns en sida som visar på skillnader i e-tjänsternas stöd för DocBook i inkorgen och i tidboken: DocBook - skillnad i stödet för 1177 Inkorg och Tidbokning

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

 

Image Added

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”

Image Added

resultText för resultCode = ERROR:

Se bilder nedan, under Felmeddelande

resultText

Ev. meddelande kopplat till resultatkoden.

Sektion

Nybokning - Fel vid bokning

Om 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:

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.

Image Removed

...

Nybokning - Sida för bekräftelse, nybokning

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

...

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

Image Added

(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.