Tre nya tjänstekontrakt

GetAllHealthcareFacilities

Tjänstekontrakt för att hämta alla vårdenheter som erbjuds för ombokning eller nybokning för aktuell invånare. 1177 Vårdguidens e-tjänster har implementerat tjänstekontraktet i funktionen "Välj mottagning" i nyboknings- och ombokningsflödet.

• Nybokning, boka tid#Nybokning-Villkorssida,väljmottagning
• Ombokning, omboka tid#Omboka-Villkorssida,väljmottagning

GetAllPerformers

Tjänstekontrakt för att hämta en lista över medarbetare i vårdprofessionen som är bokningsbara online hos angiven vårdenhet för aktuell invånare. 1177 Vårdguidens e-tjänster har implementerat tjänstekontraktet i funktionen "Välj person" i nyboknings- och ombokningsflödet.

• Nybokning, boka tid#Nybokning-Bokningssida,väljtidstypochperson
• Ombokning, omboka tid#Omboka-Ombokningssida,väljperson

GetAllCareTypes

Tjänstekontrakt för att för patienten kunna visa en lista över vilka typer av vård som kan bokas hos en viss vårdenhet/mottagning (ex: Provtagning, Sjukgymnastik, Vaccinering, Synundersökning). 1177 Vårdguidens e-tjänster har i skrivande stund (2017-06-16) inte stöd för tjänstekontraktet.

Möjlighet att skicka elektroniska kallelser

Med version 1.1 av tjänstekontrakten för Tidbokning finns det möjlighet för verksamheten att skicka elektroniska kallelser till invånarnas inkorgar i 1177 Vårdguidens e-tjänster.

1. Tidbokningssystemet uppdaterar Engagemangsindex med en ny post när en kallelse skapas i tidbokningssystemet.
2. Engagemangsindex talar om för 1177 Vårdguidens e-tjänster att ett nytt engagemang skapats och var detaljer om engagemanget kan hämtas.
3. 1177 Vårdguidens e-tjänster hämtar detaljer om engagemanget från tidbokningssystemet genom tjänstekontraktet GetBookingDetails. Om bokningen är en kallelse kommer 1177 Vårdguidens e-tjänster att presentera den som en sådan (snarare än en "vanlig bokning") och visa upp tillhörande kallelsetext.  Om kallelsen saknar start- och sluttidpunkt (öppen kallelse) kommer 1177 Vårdguidens e-tjänster visa en knapp för att boka en tid.

Elektroniska kallelser har möjliggjorts genom att följande ändringar införst i version 1.1 av tjänstekontraktet 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”).

Invånarens personnummer framgår även i frågetjänster

Krav på uppdatering av Engagemangsindex

Ändringar i befintliga tjänstekontrakt

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.

GetBookingDetails

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.

MakeBooking

• Ny regler för elementet bookingId:

  • Om bookingId angivits i begäran (nybokning mot öppen kallelse) ska producenten säkerställa att upprepad nybokning mot samma kallelse inte kan göras även om ledig tid anges.
    

  • Om bookingId anges (för öppen kallelse) får nybokning endast ske mot healthcare_facility som hämtats från GetAllHealthcareFacilities med bookingId för kallelsen som sökparameter.
    

• Elementet subject_of_care_info har gjorts obligatoriskt och utökats med tre nya underelement:
  • firstName (obligatoriskt)
    
  • middleName (frivilligt)
    
  • lastName (obligatoriskt)
    

UpdateBooking

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