Flödet

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

Sammanställning av bokad tid (Din bokning)

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

Steg 1

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

Steg 2

GetAllPerformers - valfritt tjänstekontrakt. Hämtar vilken personal som kan erbjudas för efterfrågad tidstyp.
GetAvailableDates - obligatoriskt tjänstekontrakt. Hämtar datum där det finns minst en ledig tid för avsedd tidstyp.
GetAvailableTimeslots - obligatoriskt tjänstekontrakt. Hämtar lediga tider för avsedd tidstyp.

Steg 4

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

Bekräftelse i 1177 inkorg

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

Sammanställning av bokad tid (Din bokning)

Gränssnitt	Tjänstekontrakt GetBookingDetails	Kommentar

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

Steg 1- Mottagning

Mottagning

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

Välj annan mottagning

GetAllHealthcareFacilities

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 ombokning. Finns inte mottagningarna eller om de saknar tjänst för ombokning 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

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

Steg 1 - Godkänn villkorstext

För vald mottagning visas villkorstext upp för användaren som ska läsas igenom och godkännas genom att kryssa i “Jag har tagit del av den fullständiga informationen”. Om mottagning ändras av invånaren (som erbjuds via GetAllHealthcareFacilites), ändras villkorstexten till den valda mottagningens.

Villkorstext hämtas från 1177 e-tjänsters personalsida. Här finns en manual för hur den lokala administratören redigerar villkorstexten: Ärendetyper (ADM) och här finns manualen för hur den regionala administratören skapar och redigerar villkorstext: Tidbokningstjänst

Gränssnitt	Admin	Kommentar

Gränssnitt

Admin

Kommentar

Koppling mellan mottagning och specifika informations- och villkorstexter ställs in av den regionala eller lokala administratören i 1177 personalverktyg.

Villkors och - informationstext tillhörande vald mottagning.

När invånaren har gått vidare i bokningsflödet, hittas villkors- och informationstexterna igen genom att klicka på “Visa” vid mottagningens namn.

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

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

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.

Gränssnitt	Tjänstekontrakt GetAllPerformers	Kommentar

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 förnamn + efternamn förnamn + efternamn + titel
	performer	Personalens hsa-id. Visas ej.
	firstName	Personalens förnamn. Ska visas.
	lastName	Personalens efternamn. Ska visas.
	title	Personalens titel. Kan visas.

Visningsregler lediga tider

Se visningsregler under Nybokning, Boka tid: Nybokning, boka tid

GetAvailableDates

Gränssnitt	Tjänstekontrakt GetAvailableDates	Kommentar

Gränssnitt	Tjänstekontrakt GetAvailableDates	Kommentar
	Begäran
	healthcare_facility	Hsa-Id för mottagning/vårdenhet
	bookingId	Internt bokningsid.
	startDateInclusive	Datum från och med för de lediga tider som skall sökas ut, på formatet ÅÅÅÅMMDD.
	endDateInclusive	Datum till och med för de lediga tider som skall sökas ut, på formatet ÅÅÅÅMMDD.
	timeTypeName	Namn för tidstypen / vad bokningen avser.
	timeTypeID	Id för tidstypen. 1177 skickar den kod som tidbokningssystemet returnerat i ett tidigare steg.
	careTypeName	Används ej
	careTypeID	Används ej
	performer	HSA-id för vårdpersonal.
	subject_of_care	Invånarens personnummer enligt format yyyymmddxxxx.
	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

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.
	performer name	Vårdpersonalens namn. Visas bredvid klockslaget. Ska innehålla en blank-tecken-separerad sammanslagning av yrkestitel, förnamn, mellannamn, efternamn.
	bookingId	Bokningsid för ledig tid/tidslucka. Visas ej,
	purpose	Information från verksamheten. “Information från vården” visas alltid som rubrik i gränssnittet om information skickas i fältet. Om text skickas enligt DocBook-format kan en eller flera underrubriker definieras av verksamheten och visas i detta fält Fältet visas i steg 5 - Bekräfta bokningen.
	reason	Anledning till ombokningen. Kan visas i gränssnittets steg 3 “Anledning till ombokningen” om “message_allowed”=true som ett textfält som invånaren ska fylla i. I steg 4 visas vad som har fyllts i. Obligatoriskt för invånaren att fylla i om det visas.
	resourceName	Namn på resurs. Ev. resurs visas i listan med lediga tider. Resurs visas endast om performerName inte finns.
	resourceId	Id för resurs. Visas ej.
	timeTypeName	Namn för vald tidstyp. Ska matcha begäran, men visas inte upp igen (syns i Steg 2 i bokningen)
	timeTypeId	Id för tidstyp. Ska matcha begäran. Visas ej.
	careTypeName	används ej
	careTypeId	används ej
	cancelBookingAllowed	Anger om bokningen kan avbokas. Används ej i GetAvailableTimeslots utan i GetBookingDetails.
	rebookingAllowed	Anger om bokningen kan ombokas. Används ej i GetAvailableTimeslots utan i GetBookingDetails.
	messageAllowed	Anger om orsak till ombokning kan skickas med i berörda tjänster. Orsak kan inte skickas om värdet saknas eller om värdet är false. Om true, ska fältet reason visas i steg 3 (se nedan).

Steg 3 - Information till vården

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

anledning till ombokningen - är obligatoriskt att fylla i om det visas. Om fältet ska visas beror på om verksamheten har angett message_allowed=true i GetAvailableTimeslots
telefonnummer - hämtas från inställningarna i 1177 om det finns och visas för invånaren. Kan editeras, men eventuell editering sparas inte i invånarens inställningar i 1177.

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

UpdateBooking

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

Gränssnitt	Tjänstekontrakt UpdateBooking	Kommentar

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

Felmeddelanden

resultCode = ERROR, resultText saknas

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

resultCode = ERROR, resultText returneras

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

resultCode returneras ej

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

Bekräftelse på ombokning i gränssnittet

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

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

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

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

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

Bekräftelse i 1177 inkorg

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

AddMessage

Gränssnitt	Tjänstekontrakt AddMessage	Kommentar

Gränssnitt	Tjänstekontrakt AddMessage	Kommentar
(Sista raden “Om du vill av- eller omboka tiden, gå till Testspecialist B“, är en bug och ska tas bort)	Begäran
	subjectOfCareId	Invånarens personnummer enl. yyyymmddxxxx.
	threadId	Meddelandets tråd-id. Utgörs av hsaId+bookingId.
	threadTitle	Trådtitel sätts alltid till “Tidbokning“.
	threadLabel	Skickas ej
	message
	message.title	Meddelandets titel
	message.text	Meddelandets text i DocBook-format. Här visas: Dag och tid: startTimeInclusive (samt eventuellt endTimeInclusive) Mottagning: namnet kommer från e-tjänsterna Bokningen avser: timeTypeName Anledning till ombokning: reason Information: resultText i de fall resultCode=INFO. Information från vården: purpose
	message.organisationUnit
	message. organisationUnit.unitId	hsaId
	message. organisationUnit.unitName	Mottagningsnamn
	message.serviceLink	Skickas ej
	message.serviceLink.serviceId	Skickas ej
	message.serviceLink.queryString	Skickas ej
	message.serviceLink. hasAttachment	Skickas ej
	message.actions	En action skickas bara om mottagningen har tjänsten VISATID utdelad på sig.
	message.actions.queryString	queryString innehåller hsaid+dynamicId. Används för att skapa en knapp till bokade tider på mottagningen.
	message.actions.text	Text som visas på knappen i bokningsbekräftelsen. Tidboken sätter alltid texten till “Till bokningen“.
	message.actions.serviceId	Tidboken skickar serviceTypeCode VISATID.
	message.actions.displayType	Tidboken skickar displayType BUTTON
	notify	Skickas som false
	queueForDays	Skickas ej
	approve	Skickas som false
	accountableOrganisation	Tidboken skickar 1177 e-tjänsters hsaId.
	Svar
	threadId	Meddelandets tråd-id.
	resultCode	Status för AddMessage-anropet. OK, INFO, ERROR.
	resultText	Ev. meddelande kopplat till resultatkoden. Vid resultCode INFO visas meddelandet upp i bokningsbekräftelsen.

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

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

Öppen info: 1177 tidbokning

Ombokning, omboka tid