...
| Observera |
|---|
Den här sidan har flyttats till Riktlinjer för nyttjande av tjänsten 1177 inkorg . 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 Riktlinjer för nyttjande av tjänsten 1177 inkorg . 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 |
Följande riktlinjer är ett beskriver hur kanalen 1177 inkorg ska användas. Syftet med riktlinjerna är att bibehålla en god kvalitet till invånare och nyttjare av tjänsten.
Om anslutande part
Anslutande aktör Användare av tjänsten ska vara kund till Inera och ha tecknat ett kundavtal med Inera.
Tjänsten kan tillhandahållas till kund av agent. Agent får enbart tillhandahålla tjänsten till vårdgivare som har kundavtal med Inera.
Det ska finnas en support- och förvaltningsorganisation hos kunden som kan ansvara för framtida ärenden i anslutningen.
Om nyttjande av tjänsten
...
1.7.5
...
Uppföljning av supportärenden
...
Anslutande part ansvarar för att förbättra och/eller åtgärda saker i sina system som leder till många frågor hos 1177 Vårdguidens support.
...
1177 Vårdguiden kommer att göra regelbundna uppföljningar av hur mycket support varje extern tjänst genererar och hur dessa ärenden tas om hand senare i supportkedjan.
...
1.8
...
Införande
...
Presentation
...
Vid behov ska anslutande part göra en presentation (på plats, via telefon eller videokonferens) för 1177 Vårdguiden och eventuella övriga parter.
...
1.8.1
...
Införande planering
...
Anslutande part ska informera 1177 Vårdguiden om sitt införande och rapportera löpande hur det går.
...
1.8.2
...
Stöd vid införande
...
1177 Vårdguiden kommer inte att tillhandahålla något stöd vid införande om det inte avtalas särskilt om det.
...
1.9
...
SLA - 1177 Vårdguiden
...
Målbilden är 99,8 %.
...
1177 Vårdguiden kommer att göra en uppföljning inför kommande faktureringsperiod och därefter justera prisnivåer.
...
1.10
...
Laguppfyllnad
...
Följsamhet mot relevanta lagar
1177 Inkorg inkorg är avsedd för kommunikation mellan enskild patient/invånare och ansvarig mottagning vårdgivare med tydlig koppling till patients/invånares egen hälsa. Läs mer i Beskrivning och tjänstespecifika villkor. Meddelande som skickas kan vara exempelvis:
digital kallelse till besök
hälsoformulär inför ett besök eller efter nyligen genomgången behandling.
meddelanden från en annan tjänst inom 1177 Vårdguiden e-tjänster som invånaren själv har initierat, ex bekräftelse på tidbokning.
inrapportering vårdens insamling av PROM/PREM från ett Kvalitetsregisterpatientrapporterade mått (PROM/PREM)
Formulären får inte innehålla frågor om områden som inte relaterar till individens hälsa eller upplevelse av vården.
För kvalitetsregisters insamling av patientrapporterade mått se: https://skr.se/download/18.76c3e75c17cdabf0c8696a29/1637145341310/Patientrapporterade mått_insamling och ansvar.pdf
Varje meddelande måste innehålla tydlig information om vilken mottagning/vårdenhet (HSA-id krävs) som är avsändare, vad syftet med meddelandet är, vad det innehåller och hur eventuella svar ska användas och var man vänder sig med eventuella frågor.
1177 Inkorg inkorg får endast användas då mottagningen och patienten/invånaren har en etablerad relation och en pågående kontakt
Kallelser till screeningverksamhet och vaccinering är undantaget.
Undantag gäller även när en region av särskilda skäl behöver nå hela eller delar av sin befolkning i syfte att främja hälsa/förebygga sjukdom (t ex. samhällsviktig information eller information vid en krissituation). I detta fall är regionen avsändare och meddelandet går inte att svara på. I dessa fall ska utskick anmälas till Inera på förhand via detta formulär och får endast skickas efter godkännande.
1177 Inkorg inkorg är inte avsedd att användas som en allmän informationskanal eller för enkätutskick riktade brett till olika patientgrupper inom vården.
1177 Inkorg inkorg får inte användas för att söka deltagare till läkemedels- eller forskningsstudier. Däremot får en mottagning, med tydlig koppling till patients/invånares egen hälsa, som är med i ett forskningsprojekt söka deltagare bland sina egna patienter via ett meddelande via 1177 Inkorg.
Tjänsten ska rymmas inom 1177 Vårdguidens övergripande erbjudande och bidra till det värde som e-tjänsterna ska skapa för användaren, läs mer https://www.inera.se/tjanster/1177-vardguidens-e-tjanster/.
Undvik avisering på meddelanden som enbart innehåller information och där invånaren inte behöver agera. Det finns annars en risk för att invånaren blir "immun" mot aviseringar och inte agerar när det behövs.
Tekniska krav
System ansluts till 1177 Inkorg genom att etablera samverkan med 1177 Vårdguidens e-tjänster genom tjänstekontrakten i tjänstedomänen Patientportal mha Nationella tjänsteplattformen. Anslutande part måste uppfylla förutsättningar och krav som redogörs för i denna dokumentation samt följa tjänstedomänens anvisningar och regler. Mer information om tjänstekontrakt, hur man utvecklar stöd för dem och ansluter till dem, finns på sidan Tjänstekontrakt och Nationella tjänsteplattformen.
Nedanstående tekniska krav är specifika för 1177 Vårdguidens e-tjänster som tjänsteproducent av tjänstekontraktet AddMessage.
För meddelanden som innehåller SSO-länkar (Single sign-on) måste innehållet i elementet message.messageText måste vara formaterat i DocBook.
...
Uppdatering 210503 - Tidigare krav är nu borttaget:
“Den avsändande vårdenhetens HSA-id, som konsumenten uppger i elementet message.organisationUnit.unitId, måste vara ansluten som en mottagning i 1177 Vårdguidens e-tjänster.”
Se: Informationshantering i tjänsten 1177 Inkorg för hur tjänsten agerar beroende på om enheten som skickas in finns i 1177 Vårdguidens e-tjänster eller inte. Ska Tidboken i 1177 Vårdguidens e-tjänster användas, så gäller fortsatt detta krav.
Förutsättningar och krav för användning av Inkorgsfunktionen
...
Nr
...
Krav
...
Beskrivning
...
Anslutande parts åtagande
...
1177 Vårdguidens åtagande
...
1
...
Allmänt
...
1.1
...
Information om förändring
...
Förändringar som har påverkan på parternas åtaganden
...
Skall informeras till 1177 Vårdguiden med 2 månaders framförhållning.
...
Skall informeras till anslutande part med 2 månaders framförhållning.
Kommunikation kommer att ske via mejlutskick och även sammanställas på:
https://inera.atlassian.net/wiki/x/c_wm
...
1.2
...
Uppföljning
...
Uppföljning av anslutande parts åtagande som beskrivs på denna sida
...
Anslutande part ska tillhandahålla statistik efter behov.
...
1177 Vårdguiden ska producera data som går att följa upp.
...
1.3
...
Varumärke
...
Varumärket ägs gemensamt av alla Sveriges kommuner och regioner. Mer information finns här:http://www.1177.se/material.
...
1.4
...
Användande av infrastruktur i 1177 Vårdguidens e-tjänster
...
Inloggning och sms- samt e-post-aviseringar
...
Tillgängliggöra funktionerna enligt bestämda SLA:er.
...
1.5
...
Portalen för 1177 Vårdguiden
...
Tillgängliggöra funktionerna enligt bestämda SLA:er.
...
1.6
...
Utbildning
...
Information om hur stödtjänsterna ska användas och fungerar tillhandahålls via Invånartjänsters öppna sidor (Confluence). Implementationsstöd ingår vid behov med 2-3 timmar från våra leverantörer (exempelvis förklaringar av DocBook-format med mera). Ingen verksamhetsutbildning ingår.
...
1.7
...
Support
...
1177 Vårdguidens e-tjänsters support
...
1177 Vårdguidens e-tjänsters support svarar invånaren på frågor som rör inloggningen i e-tjänsterna och fram till att invånaren hittar till inkorgsmeddelandet.
E-tjänsternas supports öppettider: alla dagar mellan klockan 06.00-22.00.
...
1.7.1
...
Anslutande parts support
...
Tjänstens support ska tillhandahållas av anslutande part och vara tillgänglig måndag-fredag mellan klockan 08.00-16.45.
...
1.7.2
...
Kontakt för anslutande parts support
...
Anslutande part ska tillhandahålla kontaktuppgifter till tjänstens support innan produktionssättning, enligt mall nedan. Se rubriken Supportväg.
...
1.7.3
...
PowerPoint-presentation
...
Anslutande part måste tillhandahålla 1177 Vårdguiden en PowerPoint-presentation av tjänsten.
...
1.7.4
...
Supportkedja
...
Anslutande part ska upprätta en supportorganisation med tydliga kontaktvägar in för alla ärenden. Se rubriken Supportväg.
...
Supporten för 1177 Vårdguidens e-tjänster har i uppdrag att ta emot och besvara frågor som uppstår fram till att invånaren kommer till den anslutande partens tjänst. Får e-tjänsternas support in ärenden som egentligen ska besvaras av den anslutande partens support (som alltså inte uppstår fram till att invånaren hittar till inkorgsmeddelandet i e-tjänsterna) kommer supporten för 1177 Vårdguidens e-tjänster att hänvisa till den anslutande partens egen support.
...
2.3.4
...
Avsändande vårdenhet i meddelandet
...
Varje meddelande måste innehålla tydlig information om vilken vårdenhet som är avsändare.
...
Att avsändande vårdenhet finns med i meddelandet kontrolleras inom ramen för 1177 Vårdguidens sluttester via testprotokollet.
...
2.3.5
...
Loggning av skickade meddelanden
...
Anslutande part måste kunna redogöra för vilka meddelanden som skickats: till vem, från vem och när.
...
1177 Vårdguiden loggar vad som har skickats, till vem och på vilket sätt.
...
2.3.7
...
Länkar i meddelandet
...
Länkar till tjänster som kräver inloggning får endast skickas ut om tjänsterna ingår i samma inloggningsfederation som 1177 Vårdguidens e-tjänster.
...
1177 Vårdguiden tillhandahåller möjligheten att presentera SSO-länkar för invånaren.
...
2.4
...
Avisering
...
2.4.1
...
Aviseringsfrekvens
...
Undvik avisering på meddelanden som enbart innehåller information och där invånaren inte behöver agera. Det finns annars en risk för att invånaren blir "immun" mot aviseringar och inte agerar när det behövs.
...
2.4.2
...
Sändning av mejl- och/eller sms
...
Sändande part beslutar om avisering ska ske (om invånaren har det aktiverat) eller ej.
...
1177 Vårdguiden tillhandahåller infrastruktur för att kunna avisera invånare via mejl och sms.
...
2.4.3
...
Mottagande av mejl och/eller sms
...
1177 Vårdguiden tillhandahåller gränssnitt där invånaren själv kan ställa in om och vilka aviseringsalternativ hen vill ha.
...
2.4.4
...
Tidpunkt för aviseringar
...
Sändande part ansvarar för att sända inkorgsmeddelanden till invånare under passande tider på dygnet (undvik nattetid).
...
1177 Vårdguiden aviserar invånare om inkorgsmeddelanden i samma stund som de kommer till invånarens inkorg (oavsett tid på dygnet).
...
2.5
...
Köhantering
...
Köhantering
...
Anslutande part ska kunna hantera att 1177 Vårdguiden har servicefönster eller tekniska problem och då kunna lägga meddelanden på kö för att skicka dem senare.
...
1177 Vårdguiden ska tillhandahålla information om planerade servicefönster samt information vid större driftstörningar via Inera.se. 1177 Vårdguiden bedömer när det är aktuellt att informera om driftstörningar, och på vilket sätt.
...
2.6
...
Tjänstekontrakt i NTjP
...
AddMessage
...
Ansluten part använder sig av tjänstekontraktet på det sätt som är avsett enligt tjänstekontraktsbeskrivningen som finns på Inera.se.
...
1177 Vårdguiden förvaltar tjänstekontraktet och tjänstedomänen AddMessageToPatientPortal och tillhandahåller information om detta via Inera.se.
...
2.7
...
Kvalitetssäkring
...
Godkännande av tester innan produktionssättning
...
Anslutande part ansvarar för att utföra sina egna tester.
...
Att granska anslutande parts testdokumention för att se att den uppfyller DocBook-format och andra givna kriterier enligt det testprotokoll som tillhandahålls av 1177 Vårdguiden. 1177 Vårdguiden granskar och godkänner även ett exempelmeddelande för att se att det uppfyller de krav på meddelandeinnehåll som ställs från 1177 Vårdguiden.
...
3
...
Krav på externt system vid SSO-länkar i meddelanden
...
3.1
...
SSO - Single Sign On - inom 1177 Vårdguidens federation
...
Invånarens inloggning i federationen för 1177 Vårdguiden.
...
Anslutande part ska skapa en egen SP-Connector med IdP.
...
Att se till att 1177 Vårdguidens e-tjänster är ansluten till utvald IdP (Identity Provider).
...
3.2
...
SLO - Single Log Out
...
Invånarens utloggning från federationen för 1177 Vårdguiden.
...
Anslutande part ska ha en knapp som använder Single Log Out-funktionen som tillhandahålls av federationen.
Anslutande part ska vid förfrågan verifiera utloggningen enligt det protokoll som finns nedan (steg 9 i anslutningsprocessen).
...
1177 Vårdguidens e-tjänster kommer att använda sig av samma utloggningsfunktion.
...
3.3
...
Navigering
...
3.3.1
...
Funktion för att återgå till 1177 Vårdguidens e-tjänster
...
Anslutande part ska ha en funktion som tar invånaren från tjänsten till 1177 Vårdguidens e-tjänster. Det ska vara en länk där det står "Till 1177 Vårdguiden".
...
3.3.2
...
Förändring av länk
...
Anslutande part ska ha möjlighet att anpassa "Till 1177 Vårdguiden"-länken två gånger per år vad gäller text, utseende med mera utan kostnad för 1177 Vårdguiden.
...
1177 Vårdguiden aviserar eventuella förändringar av länk minst 2 månader innan.
...
3.3.3
...
Uthopp i samma fönster
...
Tjänsten ska öppnas i samma fönster som 1177 Vårdguidens e-tjänster.
...
3.3.4
...
Vem som är inloggad
...
Det ska tydligt framgå i tjänsten vem som är inloggad (förnamn och efternamn) utifrån information i SAML-biljett.
...
3.4
...
Logotyp
...
Användande av 1177 Vårdguidens logotyp
...
Att inte använda 1177 Vårdguidens logotyp
...
3.5
...
SLA - anslutade part
...
Anslutande part ska ha sin tjänst (drift av tjänst) tillgänglig i en omfattning som minst motsvarar det SLA som gäller för 1177 Vårdguidens e-tjänster.
...
1177 Vårdguiden siktar på 99,8 % tillgänglighet.
...
3.6
...
Säkerhet
...
Uppfylld säkerhetsnivå
...
Starka nyckellängder på certifikat, ciphers, mm. A-rating krävs enligt test som kan utföras på följande sida: https://www.ssllabs.com/ssltest
...
Uppföljning och säkerhetsanalys av anslutna tjänster.
...
3.7
...
Information om avsändare
...
Avsändare och kontaktväg
...
Den anslutande partens tjänst ska ha sin supports kontaktväg/-ar tydligt synliga i tjänstens gränssnitt. Vem som är avsändare och står bakom tjänsten ska också framgå. 1177 Vårdguidens e-tjänsters supports kontaktuppgifter ska inte framgå i tjänstens gränssnitt.
...
1177 Vårdguiden ansvarar för supporten för 1177 Vårdguidens e-tjänster. Supporten ansvarar fram till dess att invånaren har klickat på länken till anslutande system som finns i inkorgsmeddelandet, därefter ansvarar anslutande part. E-tjänsternas support svarar inte på frågor om innehållet i inkorgsmeddelandet utan detta måste framgå i inkorgsmeddelandet.
...
3.8
...
Driftstörningar
...
Driftstörningar
...
Anslutande part måste informera om planerade driftavbrott till supporten för 1177 Vårdguidens e-tjänster. Om det är en oplanerad driftstörning ska anslutande part skicka information om driftstörningen till supporten för 1177 Vårdguidens e-tjänster.
...
1177 Vårdguiden kommer att informera om planerade driftstörningar samt delge anslutande part information om oplanerade avbrott via Inera.se(alla intressenter kan prenumerera på information via Inera.se). 1177 Vårdguiden bedömer när det är aktuellt att informera om driftstörningar, och på vilket sätt.
...
3.9
...
Felsida
...
När anslutande system har servicefönster eller tekniska problem ska en felsida med relevant information visas.
...
När anslutande system har servicefönster eller tekniska problem ska en felsida med relevant information visas. Där ska stå vem som ansvarar för systemet (vårdgivare eller organisation) och var man vänder sig för frågor.
...
1177 Vårdguiden ansvarar för att felsida visas för 1177 Vårdguidens e-tjänster vid driftstörningar.
...
1177 inkorg får inte användas i marknadsföringssyfte.
Insamling av uppgifter via 1177 inkorg får enbart ske med hjälp av formulär som uppfyller lagkrav på hantering av känsliga personuppgifter.
Meddelanden som skickas via 1177 inkorg ska uppfylla lagkrav på tillgänglighet.
Anslutande part ansvarar för att de lagar som är relevanta för det system som de ansvarar för följs.
...
1177 Vårdguiden ansvarar för att de lagar som är relevanta för e-tjänsterna följs.
...
1.11
...
Miljöer
...
1.11.1
...
Testmiljö
...
Anslutande part sätter upp och ansvarar för sina egna miljöer för test. Den bör vara produktionslik och beständig samt innehålla önskvärd testdata.
...
1177 Vårdguiden ansvarar för att anslutande part efter godkända beslut får tillgång till testmiljön.
...
1.11.2
...
Produktionsmiljö
...
Anslutande part sätter upp och ansvarar för sina egna produktionsmiljöer.
...
1177 Vårdguiden ansvarar för att anslutande part efter godkända beslut får tillgång till produktionsmiljön.
...
2
...
1177 Inkorg
...
2.1
...
1177 Inkorg
...
Möjlighet att skicka meddelande till invånarens inkorg om man har en pågående vårdrelation.
...
Att tillhandahålla den funktion där personalen kan skapa meddelanden och skicka till invånare.
Anslutande part behöver ansluta systemet som en konsument av tjänstekontrakten inom domänen infrastructure:eservicesupply:patientportal i nationella tjänsteplattformen.
...
Att tillhandahålla API och bakomliggande teknisk tjänst för att kunna skicka inkorgsmeddelanden och aviseringar.
...
2.2
...
Gränssnitt
...
2.2.1
...
Administrera meddelanden
...
Anslutande part ansvarar för att utveckla stöd för administrering av meddelanden (ta bort, uppdatera, lägga till och skapa innehåll).
...
2.2.2
...
Gränssnitt för invånare
...
Gränssnittet för invånare att ta del av inkorgsmeddelanden sker via 1177 Vårdguidens e-tjänster.
...
2.3
...
Meddelande
...
2.3.1
...
Meddelandets tekniska uppbyggnad
...
Utforma meddelandeinnehåll enligt reglerna för tolkning av DocBook, se Tjänstekontraktsbeskrivning för tjänstedomänen PatientPortal.
...
Meddelandets formatering kontrolleras inom ramen för 1177 Vårdguidens sluttester via testprotokollet.
...
2.3.2
...
Ekonomiskt ansvarig organisation
...
Varje meddelande måste innehålla en identifikation den verksamhet som är ekonomiskt ansvarig för meddelandet. Det anges i fältet accountableOrganisation.
...
2.3.3
...
Kontaktinformation i meddelandet
...
Varje meddelande måste innehålla tydlig information om vart man vänder sig om man har frågor om innehållet.
...
Att kontaktinformation finns med i meddelandet kontrolleras inom ramen för 1177 Vårdguidens sluttester via testprotokollet.
Meddelanden genererar ofta aviseringar för invånaren, meddelanden ska därför inte skickas i onödan. Meddelanden ska även skickas under passande tider (ej nattetid).
Tjänsten ska rymmas inom 1177 e-tjänsters övergripande erbjudande och bidra till det värde som e-tjänsterna ska skapa för användaren, läs mer https://www.inera.se/tjanster/1177-vardguidens-e-tjanster/.