Flera av 1177 Vårdguidens e-tjänster kräver att e-tjänsten kan kommunicera med system eller applikationer i vården. För att ta webbtidbokning som exempel så hämtar 1177 Vårdguidens e-tjänster lediga och bokade tider från den aktuella vårdenhetens tidbokningssystem och visar upp dem för användaren. När användaren valt en ledig tid och bokat den måste informationen i tidbokningssystemet uppdateras. Den tid som tidigare var ledig i tidbokningssystemet är nu bokad och ska därför inte visas för andra användare. Denna typ av informationsutbyte kräver att 1177 Vårdguidens e-tjänster och vårdsystemen är integrerade (sammankopplade) med varandra.
Med tanke på den uppsjö av vårdsystem som används av landstingens och regionernas olika verksamheter vore det nästintill omöjligt att sätta upp och upprätthålla en koppling mellan 1177 Vårdguidens e-tjänster och varje enskilt vårdsystem. Vårdsystemen är dessutom ofta programmerade i olika språk och använder olika semantik för samma saker. För att klara av dessa utmaningar har 1177 Vårdguidens e-tjänster anslutit till den gemensamma tekniska arkitektur som utvecklas och förvaltas av Inera Arkitektur och Regelverk. Det innebär att 1177 Vårdguidens e-tjänster och vårdsystemen kommunicerar med varandra via tjänstekontrakt installerade i Ineras nationella tjänsteplattform. Dessa begrepp förklaras bland annat i dokumentet T-boken i kortform på rivta.se, samlingssidan för all teknisk information som gäller den gemensamma tekniska arkitekturen.
När ett system försöker kontakta ett annat är det i själva verket plattformen det får kontakt med.
Tjänsteplattformen dirigerar sedan meddelandet vidare till rätt tjänst hos respektive vård- eller omsorgsgivare.
Den Nationella tjänsteplattformen underlättar integrationer genom att vara navet mellan system och tjänster.
Utveckla stöd för tjänstekontrakt
Tjänstekontrakt är grupperade utifrån de processer eller informationsbehov det stödjer. En sådan gruppering benämns tjänstedomän. Tabellen nedan visar vilka tjänstedomäner vars tjänstekontrakt e-tjänster och stödfunktioner i 1177 Vårdguidens e-tjänster använder.
...
| Info |
|---|
* System som skickar anrop till tjänstekontrakten är konsument. System som svarar på anrop till tjänstekontrakten är producent. ** Releasepaketen innehåller underlag för att utveckla webbtjänster utifrån tjänstekontrakten i domänen. Detta underlag består bland annat av:
|
Ansluta till tjänstekontrakt i Nationella tjänsteplattformen
Processen för att ansluta system till tjänstekontrakt i Nationella tjänsteplattformen finns beskriven på Ineras webbplats. Kortfattat ser processen ut så här
1. Förstudie avseende anslutning till de nationella testmiljöerna skickas till Inera
Anslutningsprojekt skickar in förstudie avseende anslutning till de nationella testmiljöerna.
Vid mottagen förstudie kallas anslutningsprojektet till ett telefonmöte med Inera och förvaltningen av 1177 Vårdguidens e-tjänster på vilket förutsättningar och krav för integrationen gås igenom tillsammans.
Beställningen granskas och godkänns av Inera tillsammans med förvaltningen av 1177 Vårdguidens e-tjänster.
2. Systemet ansluts till i testmiljön av Nationella tjänsteplattformen
Anslutningsprojektet beställer anslutning till aktuella tjänstekontrakt i testmiljön av Nationella tjänsteplattformen.
3. Systemet integreras med testmiljön av 1177 Vårdguidens e-tjänster
Anslutningsprojektet beställer integrering mellan det nu anslutna systemet och testmiljön av 1177 Vårdguidens e-tjänster via Nationella tjänsteplattformen. Detta kallas även för att etablera samverkan.
4. Integrationen testas
Anslutningsprojektet genomför tester i testmiljön av 1177 Vårdguidens e-tjänster.
5. Förstudie avseende anslutning till de nationella produktionsmiljöerna skickas till Inera
Anslutningsprojektet skickar in en ny version av den ursprungliga förstudien och kompletterar den med resultatet av utförda tester.
6. Systemet ansluts till produktionsmiljön av Nationella tjänsteplattformen
Anslutningsprojektet beställer anslutning till aktuella tjänstekontrakt i produktionsmiljön av Nationella tjänsteplattformen.
...
| Observera |
|---|
Denna sida uppdateras inte längre och kommer att tas bort den 15 maj 2024. Om du har blivit länkad hit, rapportera gärna till e-tjänsternas support var länken finns så att nationella förvaltningen kan kontakta sidans ägare. Här kan du kontakta supporten: https://etjanster.inera.se/oversikt/flow/4221 . |
Många av e-tjänsterna inom 1177 använder tjänstekontrakt för att kommunicera med verksamhetssystem inom vård och omsorg. Kommunikationen sker via Nationella tjänsteplattformen.
Information om Nationella tjänsteplattformen finns att läsa på sidan https://www.inera.se/tjanster/infrastrukturtjanster/nationella-tjansteplattformen/.
På denna sidan finns diverse information som kan vara till hjälp vid anslutning till de e-tjänster inom 1177 som kräver anslutning till Nationella tjänsteplattformen.
| Innehållsförteckning | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|
|
1177 inkorg
Tjänstedomän
infrastructure:eservicesupply:patientportal (Patientportal)
Uppgifter om 1177 e-tjänster som producent av tjänstekontrakten
Tjänstekontrakten i domänen tillämpar systemadressering. HSA-id för 1177 e-tjänster används som logisk adress.
Miljö av Nationella tjänsteplattformen | HSA-id för 1177 e-tjänster som producent |
|---|---|
QA-miljö | SE2321000016-A29F |
Produktionsmiljö | SE2321000016-92V4 |
Nödvändiga tjänstekontrakt
En konsument av tjänstekontrakten måste ansluta till tjänstekontraktet AddMessage. Det är frivilligt att ansluta till tjänstekontrakten IsActiveUser och GetMessageThreadStatus.
Anslutningsguide
Anslutningsguide för 1177 inkorg
E2E-underlag
| View file | ||
|---|---|---|
|
...
1177 listning
Tjänstedomän
supportprocess:logistics:carelisting (Listning)
Uppgifter om 1177 e-tjänster som konsument av tjänstekontrakten
Tjänstekontrakten i domänen tillämpar verksamhetsadressering. Länskod används som logisk adress.
Miljö av Nationella tjänsteplattformen | HSA-id för 1177 e-tjänster som konsument |
|---|---|
QA-miljö | SE2321000016-A29F |
Produktionsmiljö | SE2321000016-92V4 |
Nödvändiga tjänstekontrakt
En producent av tjänstekontrakten måste ansluta till samtliga tjänstekontrakt i tjänstedomänen utom GetAvailableHealthcarePersonnel, som är frivilligt.
Anslutningsguide
Anslutningsguide för 1177 listning
E2E-underlag
| View file | ||
|---|---|---|
|
...
1177 tidbokning (version 1)
Tjänstedomän
crm:scheduling (Tidbokning)
Uppgifter om 1177 e-tjänster som konsument av tjänstekontrakten
Tjänstekontrakten i domänen tillämpar verksamhetsadressering. Vårdenhetens HSA-id används som logisk adress.
Miljö av den nationella tjänsteplattformen | HSA-id för 1177 e-tjänster som konsument |
|---|---|
QA-miljö | SE2321000016-A29F |
Produktionsmiljö | SE2321000016-92V4 |
Nödvändiga tjänstekontrakt
Tabellen nedan visar vilka tjänstekontrakt ett tidbokningssystem måste anslutas till för att kunna erbjuda respektive funktion inom 1177 tidbokning.
Tjänstekontrakt | Beskrivning | Boka tid | Omboka tid | Avboka tid | Visa bokade tider | ||||||||||||||||||||||||
GetSubjectOfCareSchedule | Listar en invånares bokningar. |
|
|
|
| ||||||||||||||||||||||||
GetAvailableDates | Listar datum med bokningsbara tider utifrån sökparametrar. |
|
| ||||||||||||||||||||||||||
GetAvailableTimeslots | Listar bokningsbara tider utifrån sökparametrar. |
|
| ||||||||||||||||||||||||||
GetBookingDetails | Visa komplett information om en bokning. |
|
|
| |||||||||||||||||||||||||
CancelBooking | Avboka invånare från bokning, orsak kan anges. |
| |||||||||||||||||||||||||||
UpdateBooking | Ändra tid för en bokning. |
| |||||||||||||||||||||||||||
MakeBooking | Ny bokning. |
| |||||||||||||||||||||||||||
GetAllTimeTypes | Listar tillgängliga tidtyper för nybokning. |
| |||||||||||||||||||||||||||
GetAllHealthcareFacilities | Listar enheter som invånare kan boka om till. |
|
| ||||||||||||||||||||||||||
GetAllPerformers | Listar utförare (medarbetare). |
|
| ||||||||||||||||||||||||||
GetAllCareTypes | Listar vårdtyper för nybokning. |
|
|
* Används inte inom flödet för att boka tid men är obligatoriskt enligt tjänstedomänens tjänstekontraktsbeskrivning.
** Tjänstekontraktet GetAllCareTypes stödjs ej av konsumenten 1177 e-tjänster.
Anslutningsguide
Anslutningsguide för 1177 tidbokning
E2E-underlag
| View file | ||
|---|---|---|
|
Anslutning till Engagemangsindex
Tjänstedomänen Tidbokning kräver att anslutna system uppdaterar nationella Engagemangsindex för att hålla intressenter uppdaterade med information om bokningar och kallelser i systemet. Mer information om detta finns tjänstedomänens tjänstekontraktsbeskrivning. För att uppdatera nationella Engagemangsindex måste systemet därför anslutas som konsument av tjänstekontraktet Update i tjänstedomänen Engagemangsindex.
Information om tjänstedomänen Engagemangsindex finns här: https://rivta.se/tkview/#/domain/itintegration:engagementindex.
Uppgifter om nationella Engagemangsindex som producent av tjänstekontraktet Update
Tjänstekontraktet Update tillämpar verksamhetsadressering. Inera AB:s organisationsnummer används som logisk adressat för nationella Engagemangsindex.
Miljö av den nationella tjänsteplattformen | HSA-id för nationella Engagemangsindex som producent | Logisk adressat |
|---|---|---|
QA-miljö | T-SERVICES-SE165565594230-1023 | 5565594230 |
Produktionsmiljö | HSASERVICES-106J | 5565594230 |
...
1177 tidbokning (version 2)
Tjänstedomän
supportprocess:logistics:scheduling (Tidbokning)
Uppgifter om 1177 e-tjänster som konsument av tjänstekontrakten
Tjänstekontrakten i domänen tillämpar verksamhetsadressering. Vårdenhetens HSA-id används som logisk adress.
Miljö av den nationella tjänsteplattformen | HSA-id för 1177 e-tjänster som konsument |
|---|---|
QA-miljö | SE2321000016-A29F |
Produktionsmiljö | SE2321000016-92V4 |
Nödvändiga tjänstekontrakt
Tabellen nedan visar vilka tjänstekontrakt ett tidbokningssystem måste anslutas till för att kunna erbjuda respektive funktion inom 1177 tidbokning.
Tjänstekontrakt | Beskrivning | Boka tid | Omboka tid | Avboka tid | Visa bokade tider | ||||||||||||||||||
CancelAppointment | Avbokar en befintlig bokning. |
| |||||||||||||||||||||
ConfirmAppointment | Bekräfta en tidbokning som verksamheten bokat åt patienten. |
| |||||||||||||||||||||
GetAppointment | Hämtar detaljinformation om en befintlig tidbokning vid en vårdenhet. |
|
|
| |||||||||||||||||||
GetAppointments | Hämtar lista med invånarens samtliga tidbokningar. |
|
| ||||||||||||||||||||
GetTimeTypes | Hämtar alla tidstyper som kan användas vid nybokning hos angiven vårdenhet. |
| |||||||||||||||||||||
GetAvailableDates | Hämtar datum med lediga tider för angivet datumintervall. |
|
| ||||||||||||||||||||
GetAvailableTimeslots | Hämtar lediga tider för angivet datumintervall. |
|
| ||||||||||||||||||||
GetHealthcareFacilities | Hämtar alla vårdenheter som erbjuds för nybokning eller ombokning för aktuell invånare. |
| |||||||||||||||||||||
GetHealthcareFacility | Hämtar detaljerad information om en vårdenhet. |
|
|
| |||||||||||||||||||
GetPractitioners | Hämtar en lista över medarbetare i vårdprofessionen som är bokningsbara online hos angiven vårdenhet för aktuell invånare. |
|
| ||||||||||||||||||||
MakeAppointment | Tjänstekontrakt för nybokning vid en vårdenhet. |
| |||||||||||||||||||||
UpdateAppointment | Uppdaterar en befintlig bokning med nytt datum och tid, alltså en ombokning. |
|
Anslutningsguide
Anslutningsguide för 1177 tidbokning
E2E-underlag
| View file | ||
|---|---|---|
|
Anslutning till Engagemangsindex
Tjänstedomänen Tidbokning kräver att anslutna system uppdaterar nationella Engagemangsindex för att hålla intressenter uppdaterade med information om bokningar och kallelser i systemet. Mer information om detta finns tjänstedomänens tjänstekontraktsbeskrivning. För att uppdatera nationella Engagemangsindex måste systemet därför anslutas som konsument av tjänstekontraktet Update i tjänstedomänen Engagemangsindex.
Information om tjänstedomänen Engagemangsindex finns här: https://rivta.se/tkview/#/domain/itintegration:engagementindex.
Uppgifter om nationella Engagemangsindex som producent av tjänstekontraktet Update
Tjänstekontraktet Update tillämpar verksamhetsadressering. Inera AB:s organisationsnummer används som logisk adress för nationella Engagemangsindex.
Miljö av den nationella tjänsteplattformen | HSA-id för nationella Engagemangsindex som producent | Logisk adressat |
|---|---|---|
QA-miljö | T-SERVICES-SE165565594230-1023 | 5565594230 |
Produktionsmiljö | HSASERVICES-106J | 5565594230 |
...
Synpunkter och klagomål
Tjänstedomän
supportprocess:logistics:complaintsandfeedback (Synpunkter och klagomål)
Uppgifter om 1177 e-tjänster som producent och konsument av tjänstekontrakten
Tjänstekontrakten i domänen tillämpar verksamhetsadressering. HSA-id för 1177 e-tjänster används som logisk adress.
Miljö av Nationella tjänsteplattformen | HSA-id för 1177 e-tjänster som producent och konsument |
|---|---|
QA-miljö | SE2321000016-A29F |
Produktionsmiljö | SE2321000016-92V4 |
Nödvändiga tjänstekontrakt
Domänen innehåller följande tjänstekontrakt:
Funktion | Tjänstedomän | Tjänstekontrakt | Användningsfall |
|---|---|---|---|
Synpunkter och klagomål Registrera ett ärende | supportprocess:logistics:complaintsandfeedback | RegisterComplaintAndFeedback |
|
Synpunkter och klagomål Dialog avseende ärende | supportprocess:logistics:complaintsandfeedback | RegisterMessage |
|
Synpunkter och klagomål Skicka handläggningsresultat | supportprocess:logistics:complaintsandfeedback | RegisterComplaintAndFeedbackResult |
|
Synpunkter och klagomål Läs in förteckning över anslutna verksamheter | infrastructure:itintegration:registry | GetLogicalAddresseesByServiceContract |
|
Anslutningsguide
Anslutning till tjänsten Synpunkter och klagomål.
E2E-underlag
Saknas.
...
Erbjuden e-tjänst
Tjänstedomän
eservicesupply:eoffering (Erbjuden e-tjänst)
Uppgifter om 1177 e-tjänster som producent av tjänstekontrakten
Tjänstekontrakten i domänen tillämpar systemadressering. HSA-id för 1177 e-tjänster används som logisk adress.
Miljö av Nationella tjänsteplattformen | HSA-id för 1177 e-tjänster som producent |
|---|---|
QA-miljö | SE2321000016-A29F |
Produktionsmiljö | SE2321000016-92V4 |
Nödvändiga tjänstekontrakt
Domänen innehåller bara ett tjänstekontrakt: GetAvailableEServices.
Anslutningsguide
Saknas.
E2E-underlag
Används ej.