Om Engagemangsindex i förhållande till Tidbokning
Engagemangsindex är en stödtjänst som används av en tjänsteplattform. Informationen i indexet syftar till att minimera antalet anrop som en tjänstekonsument behöver göra för att få information om en specifik patient. Från indexet får tjänstekonsumenten information om vilka tjänsteproducenter som har information om den specifika patienten och det räcker därmed att tjänstekonsumenten anropar dessa istället för att anropa alla tjänsteproducenter och fråga vilka av dem som har information om den specifika patienten. Indexet i sig innehåller inte någon patientinformation.
När en tidbokningsproducent (t.ex ett journalsystem eller en regional tjänsteplattform) är ansluten till Engagemangsindex kan en tidbokningskonsument (t.ex. Mina vårdkontakter) hämta information om kallelser och ändringar av bokade tider.
Mina vårdkontakter hämtar i dagsläget följande tidbokningsinformation från Engagemangsindex:
| Innehållsförteckning | ||
|---|---|---|
|
Att ansluta till Engagemangsindex
Tidbokning och Engagemangsindex är två olika tjänstedomäner i Nationella tjänsteplattformen och innehåller olika tjänstekontrakt. Man ansluter till Engagemangsindex separat genom att skicka in två beställningar:
Beställning B - Anslutning av konsument
Beställning D - Etablera samverkan
Kallelser (öppna)
- Görs på initiativ från vården
- Kallelsen innehåller ingen tid
- Kallelsetexten visas direkt i kallelsen i invånarens inkorg
- Invånaren startar bokning direkt från inkorgen
- Mottagningen läggs automatiskt till i invånarens lista
Kallelser (tidsatta)
- Görs på initiativ från vården
- Kallelsen innehåller en bokad tid
- Kallelsetexten visas direkt i kallelsen i invånarens inkorg
- Invånaren startar om- eller avbokning direkt från inkorgen
- Mottagningen läggs automatiskt till i invånarens lista
Bokningsinformation
Om personal på mottagningen bokar, om- eller avbokar en tid, så får invånaren ett meddelande om detta i sin inkorg i Mina vårdkontakter.
System som ansluts till tjänstekontrakten för Tidbokning måste uppdatera Engagemangsindex. Engagemangsindex är en nationell stödtjänst som genom att det uppdateras av vårdens verksamhetssystem, vet hos vilka informationsägare patienter har olika typer av engagemang. Ett engagemang kan t.ex. vara en bokad tid, en kallelse, en remiss eller ett formulär för patienten att fylla i.
Integrationen mellan verksamhetssystemen och Engagemangsindex görs genom tjänstekontrakt. Tjänstekontrakten för Engagemangsindex finns här http://rivta.se/domains/itintegration_engagementindex.html.
Tjänstedomänen Tidboknings anvisningar för uppdatering av Engagemangsindex finns i domänens tjänstekontraktsbeskrivning, som går att ladda ned här: http://rivta.se/domains/crm_scheduling.html.
Elektroniska kallelser och bokningsbekräftelser
Varje gång ett tidbokningssystem uppdaterar Engagemangsindex med information om en bokad tid eller kallelse får 1177 Vårdguidens e-tjänster en notifiering från Engagemangsindex. Notifieringen berättar om den bokade tiden eller kallelsen har skapats, ändrats eller tagits bort av tidbokningssystemet. Av notifieringen framgår också vilket tidbokningssystem som gjorde uppdateringen. Utifrån dessa uppgifter kan 1177 Vårdguidens e-tjänster hämta nödvändiga uppgifter för att skapa ett meddelande i den aktuella patientens inkorg. Meddelandet informerar patienten om händelsen (t.ex. att hen fått en kallelse eller att en bokad tid har bokats om). Läs mer på sidan Tidsatt och öppen kallelse.
Om patienten gjort den inställningen, får patienten ett sms och/eller ett mejl från 1177 Vårdguidens e-tjänster som talar om att ett nytt meddelande finns att läsa i inkorgen.
| Varning | ||||||
|---|---|---|---|---|---|---|
| ||||||
Enligt tjänstedomänen Tidboknings regelverk ska anslutna tjänsteproducenter (tidbokningssystem) uppdatera Engagemangsindex. Vid behov finns det möjlighet att aktivera en funktion i 1177 Vårdguidens e-tjänster som skapar ett inkorgsmeddelanden till den berörda invånaren när Engagemangsindex uppdateras med en kallelse eller bokad tid. Funktionen aktiveras per tidbokningssystem genom beställning till den nationella förvaltningen för 1177 Vårdguidens e-tjänster. Beställningen måste läggas av den aktuella regionen i ett mail till
Det är av högsta vikt att det aktuella landstinget eller regionen säkerställt att tidbokningssystemet följer tjänstedomänen Tidboknings anvisningar för uppdatering av Engagemangsindex, innan beställning på aktivering av elektroniska kallelser och bokningsbekräftelser i produktionsmiljö. Felaktig uppdatering av Engagemangsindex kan resultera i felaktig information i de meddelanden som skapas i invånarnas inkorgar i 1177 Vårdguidens e-tjänster. Anvisningarna finns i tjänstedomänen Tidboknings tjänstekontraktsbeskrivning som finns att ladda ned på http://rivta.se/domains/crm_scheduling.html. |
Så fungerar det:
1. Vårdenheten gör en ändring i tidbokningssystemet.
Det kan till exempel handla om att en kallelse skapas eller att en bokad tid bokas om.
2. Tidbokningssystemet uppdaterar Engagemangsindex med information om ändringen.
Detta görs genom ett anrop till tjänsten Update i Nationella tjänsteplattformen.
3. Engagemangsindex notifierar 1177 Vårdguidens e-tjänster om ändringen.
Engagemangsindex gör detta genom ett anrop till tjänsten ProcessNotifications hos 1177 Vårdguidens e-tjänster. Anropet innehåller en kopia av tidbokningssystemets anrop till tjänsten Update.
4. 1177 Vårdguidens e-tjänster kontrollerar om elektroniska kallelser och bokningsbekräftelser är aktiverade för tidbokningssystemet.
1177 Vårdguidens e-tjänster tar värdet som tidbokningssystemet uppgett i XML-elementet sourceSystem i sitt anrop till tjänsten Update och matchar det mot en databas med tidbokningssystem som använder elektroniska kallelser och bokningsbekräftelser. Om värdet (tidbokningssystemets HSA-id) inte finns i databasen, ignoreras notifieringen.
5. 1177 Vårdguidens e-tjänster hämtar detaljer om den bokade tiden eller kallelsen.
1177 Vårdguidens e-tjänster anropar tjänsten GetBookingDetails i Nationella tjänsteplattformen. 1177 Vårdguidens e-tjänster adresserar anropet till den logiska adressat som tidbokningssystemet uppgett i XML-elementet logicalAddress i sitt anrop till tjänsten Update. Som Id för den bokade tiden eller kallelsen uppger 1177 Vårdguidens e-tjänster det värde som tidbokningssystemet uppgett i XML-elementet businessObjectInstanceIdentifier i sitt anrop till tjänsten Update.
6. 1177 Vårdguidens e-tjänster skapar ett meddelande i patientens inkorg.
Innehållet i meddelandet skapas utifrån de uppgifter som 1177 Vårdguidens e-tjänster erhållit i notifieringen från Engagemagsindex och i bokningsdetaljerna från tidbokningssystemet.