Jämförda versioner

Nyckel

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

...

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

...

Villkorstext hämtas från 1177 Vårdguidens 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 RemovedImage Added

Koppling mellan mottagning och specifika villkorstexter ställs in av den regionala eller lokala administratören i 1177 Vårdguidens 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 RemovedImage Added

 

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

...

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

timeTypeName 1..1

Namn för tidstypen / vad bokningen avser.

Info

Max tecken: 100 st

timeTypeId 1..1

Id för tidstypen. Visas ej.

 

...

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

 

...

Gränssnitt

Tjänstekontrakt

GetAvailableDates

Kommentar

 

Begäran

 

healthcare_facility

Hsa-Id för mottagning/vårdenhet

bookingId

Internt bokningsid.

startDateInclusive

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

endDateInclusive

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

timeTypeName

Namn för tidstypen / vad bokningen avser.

timeTypeID

Id för tidstypen.

1177 skickar den kod som tidbokningssystemet returnerat i ett tidigare steg.

careTypeName

Används ej

careTypeID

Används ej

performer

HSA-id för vårdpersonal.

Info

Kommer endast ha ett värde om vårdpersonallistan finns och om invånaren har valt en personal.

subject_of_care

Invånarens personnummer enligt format yyyymmddxxxx.

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

...

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

Image RemovedImage Added

Svar

 

TimeSlotDetail

Lista med tillgängliga tider.

startTimeInclusive

Startdatum och klockslag för ledig tid.

endTimeInclusive

Slutdatum och klockslag för ledig tid.

I gränssnittet visas eventuellt slutdatum och -tid.

Info

Om sluttid ska visas i gränssnittet eller inte väljer verksamheterna själva. Att visa sluttid beställs från e-tjänsternas tekniska support vid anslutning. Per default visas inte sluttid.

Info

Sluttid anges eller anges inte för alla tider på mottagningen, kan ej vara olika.

healthcareFacility

HSA-id för mottagningen/vårdenheten.

Ska matcha begäran.

Visas ej.

healthcareFacilityName

Namn på bokad mottagning/vårdenhet.

Visas ej igen. Visas i Steg 1.

performer

Vårdpersonalens HSA-id.

Visas ej.

performer name

Vårdpersonalens namn. Visas bredvid klockslaget.

Ska innehålla en blank-tecken-separerad sammanslagning av yrkestitel, förnamn, mellannamn, efternamn.

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

...

Gränssnitt

Tjänstekontrakt AddMessage

Kommentar

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

...