Ansluta vårdenheter till 1177 tidbokning

Den här sidan har flyttats till https://inera.atlassian.net/wiki/spaces/OITB/pages/3583803493 . Denna sida uppdateras inte längre och kommer att tas bort den 15 maj 2024. Om du har lagt till sidan som en favorit i webbläsaren eller i Confluence, se till att byta ut den till den rätta länken https://inera.atlassian.net/wiki/spaces/OITB/pages/3583803493 . 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

Nedan följer instruktioner för att ansluta en ny vårdenhet till 1177 tidbokning. Instruktionerna kan följas förutsatt att det aktuella tidbokningssystemet redan är anslutet till 1177 tidbokning.

1. Säkerställ att vårdenhetens HSA-id är aktiverat i 1177 e-tjänster

1177 tidbokning är uppdelad i två tidbokningstjänster (ärendetyper); en där invånaren kan boka en ny tid, en annan där invånaren kan se sina redan bokade tider. I den senare tidbokningstjänsten kan invånaren även av- eller omboka en tid, förutsatt att tidbokningssystemet i fråga tillåter det. För att kunna dela ut en tidbokningstjänst till en vårdenhet/mottagning måste dess HSA-id vara aktiverat i 1177 e-tjänster.

Både i produktionsmiljön och i QA-miljön är det de regionala förvaltningarna för 1177 e-tjänster som aktiverar vårdenheter/mottagningar. Se manual här: Aktivera mottagning. Mottagningens HSA-id måste finnas i test-HSA för testmiljön, och i produktions-HSA för produktionsmiljön. För frågor om HSA, kontakta er HSA-ansvarig. 

2. Säkerställ att lokala system är konfigurerade

Om man i regionen har en regional tjänsteplattform eller motsvarande, måste man säkerställa att den är konfigurerad för att dirigera inkommande anrop till rätt tidbokningssystem. Detta måste göras innan man går vidare till nästa steg eftersom förvaltningen för Nationella tjänsteplattformen utför kommunikationstester när en ny vårdenhet ansluts till tjänstekontrakten för tidbokning. Misslyckas kommunikationstesterna kommer inte beställningen att utföras och ärendet kommer snabbt bli rörigt.

Om det behöver göras inställningar i själva tidbokningssystemet för att tidbokning mot vårdenheten ska fungera, måste även detta göras innan man går vidare till nästa steg.

3. Lägg beställning till Nationella tjänsteplattformen

När 1177 e-tjänster skickar en begäran om att hämta, skapa, ändra eller ta bort information i ett tidbokningssystem genom att anropa ett tjänstekontrakt i Nationella tjänsteplattformen, så adresserar 1177 e-tjänster sitt anrop till en logisk adressat. Tjänstekontrakten för Tidbokning tillämpar verksamhetsbaserad adressering, vilket innebär att den logiska adressaten utgörs av den aktuella vårdenhetens HSA-id. Tack vare verksamhetsbaserad adressering behöver inte 1177 e-tjänster (konsumenten) känna till vilket system (vilken producent) som innehåller den efterfrågade informationen.

När Nationella tjänsteplattformen tar emot ett anrop till ett tjänstekontrakt kollar den först att konsumenten har nödvändiga behörigheter. Därefter slår Nationella tjänsteplattformen upp producent för den logiska adressaten och det aktuella tjänstekontraktet, för att därefter dirigera anropet vidare till den tekniska adressen (url:en) hos producenten. Kopplingarna mellan logiska adressater och producenter känner Nationella tjänsteplattformen till tack vare att regionerna redogör för dem i sina beställningar på att konfigurera Nationella tjänsteplattformen.

Vid beställning på att ansluta en ny vårdenhet (logisk adressat) inom 1177 tidbokning, måste alltså det aktuella regionen uppge vilken producent som vårdenhetens tidbokningsinformation finns hos, till vilka tjänstekontrakt vårdenheten ska anslutas till, samt vilken konsument som ska ha behörighet att anropa dem. Detta görs via Ineras digitala beställningsstöd: https://www.inera.se/tjansteplattformen/anslutning. När beställningen är utförd får beställaren en bekräftelse på detta från Ineras kundservice.

Beställningsstödet

Instruktioner för hur ni använder beställningsstödet finns i följande guide, Inera beställningsstöd. När ni beställer anslutning via beställningsstödet är det viktigt att ni beställer rätt tjänstekontrakt för att det ska kunna fungera som avsett.

Beroende på vilka funktioner som invånaren ska kunna göra i mottagningens tidbok väljer ni följande kontrakt:



Nybokning

Visa bokade tider

Ombokning

(beror av Visa bokade tider)

Avboka

(beror av Visa bokade tider)



Nybokning

Visa bokade tider

Ombokning

(beror av Visa bokade tider)

Avboka

(beror av Visa bokade tider)

Kräver följande kontrakt

GetAllTimetypes

GetAvailableDates

GetAvailableTimeslots

MakeBooking

GetSubjectOfCareSchedule

GetBookingDetails

GetSubjectOfCareSchedule

GetBookingDetails

GetAvailableDates

GetAvailableTimeslots

UpdateBooking

GetSubjectOfCareSchedule

GetBookingDetails

CancelBooking

Valfria kontrakt

GetAllPerformers

GetAllHealthcareFacilitites



GetAllPerformers

GetAllHealthcareFacilitites




4. Dela ut tidbokningstjänster

När Ineras kundservice återkopplat och bekräftat att den aktuella vårdenhetens HSA-id är upplagt som en logisk adressat i Nationella tjänsteplattformen, kan den regionala förvaltningen för 1177 e-tjänster dela ut tidbokningstjänsterna enligt instruktionerna på sidan Användarmanual för tjänsteutdelningen webbtidbok.

5. Ange villkorstexter för tidbokningstjänster

När ovan nämnda beställning är lagd kan 1177 e-tjänster hämta tidbokningsinformation kopplat till vårdenheten. Bara ett par steg återstår innan tidbokningstjänsterna kan börja användas av invånarna. Först måste vårdenheten lägga in villkorstexter för tidbokningstjänsterna. Detta görs inne i 1177 e-tjänster av någon på vårdenheten med behörigheten Lokal administratör. Invånarna kommer att behöva bocka i att de tagit del av villkoren innan de kan använda en tidbokningstjänst.

6. Aktivera tidbokningstjänster

I det sista steget måste någon på vårdenheten med behörigheten Lokal administratör aktivera tidbokningstjänsterna i 1177 e-tjänster. En tidbokningstjänst kan antingen aktiveras för "Alla" eller för ett "Begränsat urval".

När en tidbokningstjänst aktiveras för "Alla" blir den tillgänglig för alla invånare som faller inom vårdenhetens geografiska betjäningsområde. Vårdenhetens geografiska betjäningsområde ställs in i 1177  e-tjänster av någon på vårdenheten med behörigheten Lokal administratör.

När en tidbokningstjänst aktiveras för ett "Begränsat urval" måste personalen på vårdenheten dela ut tidbokningstjänsten manuellt till de invånare (personnummer) som ska kunna använda den.