...

En kallelse kan vara öppen eller tidsatt. En öppen kallelse är ett erbjudande till invånaren att själv boka en tid för t.ex. en behandling eller undersökning. En tidsatt kallelse har en start- och sluttidpunkt men kan ställas in för att vara ombokningsbar och/eller avbokningsbar. Den elektroniska kallelsen innehåller då knappar för att omboka och/eller avboka.

Elektroniska kallelser har möjliggjorts genom följande ändringar i tjänstekontraktet GetBookingDetails i version 1.1:

• Elementet isInvitation ingår i svaret. Anger om bokningen har skapats på vårdgivarens (isInvitation = ”true”) eller patientens (isInvitation = ”false”, eller fältet saknas) initiativ. D.v.s. om bokningen är en kallelse eller inte.
  
• Elementen startTimeInclusive och endTimeExclusive har gjorts frivilliga i svaret för att stödja öppna kallelser (vilka saknar start- och sluttidpunkt).
• Elementet purpose har gjorts obligatoriskt och ska innehålla en kallelsetext om bokningen är en kallelse (isInvitation = ”true”).

Invånarens personnummer ingår i fler tjänstekontrakt

I version 1.1 har följande tjänstekontrakt försett med invånarens personnummer i frågan:

• GetAllTimeTypes (hämta tidstyper)
• GetAvailableDates (hämta bokningsbara datum)
• GetAvailableTimeslots (hämta lediga tider)

Tidbokningssystemet kan därmed anpassa sina svar utifrån den aktuella invånaren. Tidbokningssystemet kan t.ex. utesluta tidstyper som invånaren på grund av verksamhetsregler inte får boka tid inom.

I version 1.0 kan invånaren välja en tidstyp som hen egentligen inte får boka inom. Tidbokningssystemet får då reda på vem invånaren är först när bokningen ska genomföras och returnerar då ett felmeddelande.
Invånaren har i det läget gått igenom hela bokningsflödet. Det vill säga valt tidstyp, datum, tidpunkt, angett besöksorsak och klickat på ”Boka”.

Krav på uppdatering av Engagemangsindex

...

Tidbokningssystem som ansluter till version 1.1 av tjänstekontrakten för Tidbokning måste uppdatera Engagemangsindex.

Tidbokningssystem som ansluter till version 1.0 av tjänstekontrakten för Tidbokning får uppdatera Engagemangsindex. Elektroniska kallelser kan dock inte skickas denna väg.

Teknisk beskrivning av ändringar

GetAllTimeTypes

• Elementet careTypeIDs ingår i begäran. Konsumenten kan alltså begränsa frågan till en eller flera vårdtyper. Konsument får bara skicka värden till producent som stödjer GetAllCaretypes.
• Elementet subject_of_care ingår i begäran och är obligatoriskt. Kan användas för att filtrera vad tjänsteproducenten ska returnera för en viss invånare. (T.ex. invånare som på grund av sjukdom måste erbjudas enstaka speciella tidstyper, som inte erbjuds alla invånare).

GetAvailableDates

• Elementet subject_of_care ingår i begäran och är obligatoriskt.
  

GetAvailableTimeslots

• Elementet subject_of_care ingår i begäran och är obligatoriskt.
  

GetBookingDetails

• Elementet isInvitation ingår i svaret. Anger om bokningen har skapats på vårdgivarens (isInvitation = ”true”) eller patientens (isInvitation = ”false”, eller fältet saknas) initiativ. D.v.s. om bokningen är en kallelse eller inte.
  
• Elementen startTimeInclusive och endTimeExclusive har gjorts frivilliga i svaret för att stödja öppna kallelser (vilka saknar start- och sluttidpunkt).
• Elementet purpose har gjorts obligatoriskt och ska innehålla en kallelsetext om bokningen är en kallelse (isInvitation = ”true”).

GetSubjectOfCareSchedule

• Elementet isInvitation ingår i svaret. Anger om bokningen har skapats på vårdgivarens (isInvitation = ”true”) eller patientens (isInvitation = ”false”, eller fältet saknas) initiativ. Öppna kallelser ska dock inte ingå inte i svaret.

...

• Elementet subject_of_care_info har utökats med tre nya underelement:
  • firstName (obligatoriskt)
  • middleName (frivilligt)
  • lastName(obligatoriskt)
• Nya regler:
  • Efter genomförd begäran ska en kallelse ha omvandlats till en bokning - d.v.s. ett bookingId som vid anrop till GetBookingDetail har isInvitation = ”true” ska vid anrop efter UpdateBooking ha isInvitation = ”false”.
  • Begäran får endast skickas om healthcare_facility är samma healthcare_facility som ursprunglig bokning eller är en healthcare_facility som hämtats från GetAllHealthcareFacilities med bookingId för ursprunglig bokning som sökparameter.
  • BookingId måste avse en tidssatt bokning (oavsett värde på IsInvitation). D.v.s. UpdateBooking får inte användas för öppna kallelser (IsInvitation = ”true” och start- och endTimeInclusive saknas). För öppna kallelser ska istället MakeBooking användas (även om bookingId finns för kallelsen).

Ny RIV TA-profil

Version 1.1 av tjänstekontrakten för Tidbokning använder version 2.1 av RIV TA Basic Profile.

Version 1.0 av tjänstekontrakten för Tidbokning använder version 2.0 av RIV TA Basic Profile.