...
...
...
...
...
...
...
...
Att tillhandahålla den funktion där vårdgivaren 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:
- IsActiveUser
- AddMessageToPatientPortalInbox
...
Prismodell
...
Principer för prismodellen
Prismodellen innebär att anslutande part betalar per skickat meddelande. Detta utifrån att ett skickat meddelande initierar eventuell sms-avisering samt inloggning.
I pris per meddelande ingår följande:
- Kostnad för sms-avisering
- Kostnad för SAML-biljett vid inloggning
- 1:a linjens support
- 2:a linjens support
- Förvaltningsresurs/er i 1177 Vårdguidens förvaltning
Observera att en anslutningsavgift på 25 000 kronor tillkommer i samband med den tekniska anslutningen (engångsavgift). Läs mer om vad som ingår i anslutningsavgiften här.
Pris per skickat meddelande och anslutet system:
Meddelande nr 1 – 49 999 kostar 3.1 kr/meddelande, därefter:
Meddelande nr 50 000- 499 999 kostar 2.4 kr/meddelande, därefter:
Meddelande nr 500 000 och uppåt kostar 1,4 kr/meddelande
Exempel: 75 000 skickade meddelanden från ett anslutet system per år kostar totalt 214 999kr (49 999* 3,1+ 25001*2.4)
...
Litet system
...
Mellansystem
...
Stort system
...
Allmänt om prismodellen
Förvaltningen drivs utan vinstsyfte, men har en marginal för oförutsedda utgifter som behöver göras för att vidmakthålla förvaltningen. De gemensamma kostnaderna revideras löpande för att motsvara de faktiska kostnaderna.
Modellen tar INTE höjd för Ineras overhead (exempelvis Nationella tjänsteplattformen och generell overhead)
Modellen tar inte höjd för eventuella framtida investeringar som kan behöva göras i programvaror och infrastruktur för att hantera en ökad last och framtidens krav.
Riktlinjer
Följande riktlinjer är ett underlag vid bedömning av vilka typer av tjänster som tillåts ansluta till Inkorgsfunktionen.
För landsting och regioner:
- Tjänsten ska rymmas inom tjänstebeskrivningen för 1177 Vårdguidens e-tjänster och bidra till det värde som e-tjänsterna ska skapa för användaren, se https://service.projectplace.com/pp/pp.cgi/r1283006507 (sidan kräver inloggning men dokumentet kan skickas ut efter begäran).
- Den aktör som står bakom tjänsten ska ha ett avtal med ett landsting/en region och ansökan ska också komma från ett landsting eller region.
- Anslutande aktör ska ha en organisation för utvecklings- och anslutningsprocessen med kontaktperson och tidplan.
- Det ska finnas en tilltänkt support- och förvaltningsorganisation i landstinget/regionen för tjänsten.
- Tjänsten ska leva upp till och följa tjänstespecifikationen.
- Information i meddelandet ska vara specifikt riktad till enskild patient/invånare med tydlig anknytning till personens egen hälsa. Det kan till exempel vara inför ett besök eller efter nyligen genomgången behandling. Ett annat exempel är meddelanden från en tjänst inom 1177 Vårdguiden som invånaren själv har initierat.
- Inkorgsfunktionen är inte avsedd att användas som en allmän informationskanal.
För kvalitetsregister:
- Tjänsten ska rymmas inom tjänstebeskrivningen för 1177 Vårdguidens e-tjänster och bidra till det värde som e-tjänsterna ska skapa för användaren, se https://service.projectplace.com/pp/pp.cgi/r1283006507 (sidan kräver inloggning men dokumentet kan skickas ut efter begäran).
- Anslutande aktör ska ha en organisation för utvecklings- och anslutningsprocessen med kontaktperson och tidplan.
- Det ska finnas en tilltänkt support- och förvaltningsorganisation för tjänsten.
- Tjänsten ska leva upp till och följa tjänstespecifikationen.
- Information i meddelandet ska vara specifikt riktad till enskild patient/invånare med tydlig anknytning till personens egen hälsa. Det kan till exempel vara hälsoenkäter eller PROM/PREM.
- Inkorgsfunktionen är inte avsedd att användas som en allmän informationskanal.
Process för anslutning
1. Skicka in intresseanmälan till förvaltningen för 1177 Vårdguidens e-tjänster
Aktuellt landsting eller regionen skickar intresseanmälan till e-tjanster@1177.se. Intresseanmälningar granskas veckoligen, vanligtvis på måndagar. Vid godkänd intresseanmälan kan anslutande part gå vidare i anslutningsprocessen.
| View file | ||||
|---|---|---|---|---|
|
...
| Info |
|---|
...
Krav, förutsättningar och pris
...
- Konfigurering av 1177 Vårdguidens e-tjänsters testmiljö
- Tillgång till testmiljön av 1177 Vårdguidens e-tjänster med personliga konton för möjlighet att testa
- Hjälp och support under testperioden
- Konfigurering av 1177 Vårdguidens e-tjänsters produktionsmiljö
- Hjälp och support i produktionsmiljön av 1177 Vårdguidens e-tjänster
- Hantering av supportärenden från första linjens support
- Koordinering av anslutningar och problem
- Konfigurering av Nationella tjänsteplattformen
...
- Framtida drift
- Drift av Nationella tjänsteplattformen
- Behöver en anslutande part extra hjälp och support för att få det egna systemet att fungera får detta köpas separat
Förutsättningar och krav
...
| ||
Informationen på denna sida avser anslutning till inkorgsfunktionen som ska ersättas av den fristående tjänsten 1177 Inkorg. Denna sida finns kvar tills ny sida för 1177 Inkorg är komplett. |
| Infoga utdrag | ||||||
|---|---|---|---|---|---|---|
|
Inkorgsfunktionen i 1177 Vårdguidens e-tjänster gör det möjligt för externa system som t.ex. kvalitetsregister, journalsystem och andra verksamhetssystem att skicka meddelanden till invånare med konto i 1177 Vårdguidens e-tjänster. Inkorgsfunktionen är baserad på tjänstekontrakten IsActiveUser och AddMessageToPatientPortalInbox i tjänstedomänen Patientportal. Det finns uppställda /wiki/spaces/OVET/pages/63307879 som måste uppfyllas för att ett system ska få skicka meddelanden till invånare. Innan ni påbörjar processen är det viktigt att ni läser igenom och uppfyller de krav som ställs. |
1. Intresseanmälan och planering av anslutningenVid intresse av att ansluta till Inkorgsfunktionen ska den regionala förvaltningen för 1177 Vårdguidens e-tjänster i den aktuella regionen inkomma med en intresseanmälan (se nedan) till den nationella förvaltningen för 1177 Vårdguidens e-tjänster på e-tjanster@1177.se. Intresseanmälan kommer att bedömas utifrån bland annat /wiki/spaces/OVET/pages/63307879 nedan. Anslutande part kan räkna med ett initialt besked från den nationella förvaltningen för 1177 Vårdguidens e-tjänster inom en vecka.
Syftet med intresseanmälan är att förvaltningen ska kunna bedöma att de fastställda riktlinjerna kommer att följas.
1.1. Erhåll system-id från förvaltningen för 1177 Vårdguidens e-tjänsterVarje meddelande som skapas i 1177 Vårdguidens e-tjänster genom Inkorgsfunktionen måste innehålla ett system-id som identifierar avsändaren. Anslutande part erhåller ett eller |
...
...
...
...
...
...
...
...
...
...
...
7. Skicka in testprotokoll
...
...
...
...
...
Teknisk dokumentation
Anslutning via Nationella tjänsteplattformens (NTjP) tjänstedomän "PatientPortal"
- Anslut till tjänstedomänen i NTjP genom att kontakta Ineras kundtjänst.
- Det finns två tjänsteinteraktioner som används i anslutning till inkorgstjänsten:
- AddMessageToPatientPortalInbox
- IsActiveUser
- Läs mer om tjänstekontrakten på sidan Inkorgstjänsten - teknisk dokumentation
För att komma igång är två konfigurationsparametrar aktuella initialt, varav den ena är obligatorisk.
...
Systemid används för att identifiera konsumentssystemet hos producenten. Systemid är obligatoriskt att skicka med i elementet som heter sourceSystem, som är en del av tjänstekontraktet. Systemid används också som ett id-begrepp för att hitta igen den konfigurerade basUrl:en, om konsumenten valt att använda sig av en sådan (läs mer i tjänstekontraktsbeskrivningen samt anslutningsguiden).
Ett vanligt användningsområde för denna tjänsteinteraktion är att låta användaren hitta tillbaka till konsumentsystemet via inkorgsmeddelandet i 1177 Vårdguidens e-tjänster mha av en uthoppslänk. Uthoppslänken kan endera konfigureras på två sätt:
- Med ovan nämnda basUrl samt att eventuella övriga url-parameter skickas med anropet,
- Att man konfigurerar länken direkt i DocBook-meddelandet med ulink-elementet.
Om docbook-formatet
DocBook är ett ganska rikligt format (http://www.docbook.org/tdg5/en/html/docbook.html). Därför finns en avgränsning i tjänsten AddMessageToPatientPortalInbox till ett antal utvalda element och ett antal utvalda kombinationer av dessa. Tabellen nedan redovisar möjliga kombinationer av element i DocBook-formatet som stöds av tjänsten:
...
Element
...
Parent
...
Child
...
article
...
NA
...
info, para, section, bibliography, variablelist
...
info
...
article, section
...
title
...
section
...
article
...
info, title, para, bibliography, variablelist
...
para
...
article, section
...
ulink
...
bibliography
...
article, section
...
NA
...
variablelist
...
article, section
...
title, varlistentry
...
title
...
info, section, variablelist
...
NA
...
ulink
...
para
...
NA
...
varlistentry
...
variablelist
...
term, listitem
...
term
...
varlistentry
...
NA
...
listitem
...
varlistentry
...
NA
Exempel på DocBook-konfigurationer och hur det återspeglas i inkorgen finns i anslutningsguiden under kapitel "Regler för tolkning av meddelandeinnehåll och DocBook".
| Bilagor | ||||
|---|---|---|---|---|
|
OBSERVERA! Bifogade kodexempel ovan kan kopieras, användas och återanvändas fritt. Kodexemplen underhålls dock inte av MVK tekniska förvaltning. SLL invånartjänster och 1177 Vårdguidens e-tjänsters tekniska förvaltning tar heller inte ansvar för att kodexemplen fungerar i konsumerande systems miljö.
Fördjupad teknisk dokumentation
Inledning
Inkorgstjänsten för 1177 Vårdguidens e-tjänster möjliggör att anslutande system via Nationella tjänsteplattformen kan skicka ett meddelande till individer som är registrerade användare 1177 Vårdguidens e-tjänster.
Inkorgstjänsten består av två interaktioner som används för att kontrollera att en invånare är användare (är registrerad) samt att i förekommande fall skicka själva meddelandet.
- IsActiveUser
- AddMessageToPatientPortalInbox
Beskrivning
Det skickade meddelandet kan formateras inom vissa givna ramar och kan länka sömlöst till externa system om dessa är anslutna. Avsändaren kan avgöra om denne vill att meddelandet ska aviseras invånaren om möjligt. Om avisering sker och med vilken metod (SMS, e-post) kan ske eller ej beror av invånarens inställningar.
Tjänsten IsActiveUser returnerar aktiva användares inställningar för avisering så att anslutande system kan avgöra om avisering kan ske.
Anslutande system kan också konfigureras för att stödja uthopp/länkning med med sömlös övergång (SSO) för att låta invånaren kunna agera vidare utifrån meddelandet i inkorgen
Se också bifogad anslutningsguide:
| View file | ||||
|---|---|---|---|---|
|
Övergipande information om tjänstekontrakten:
Tjänstedomän:
infrastructure:eservicesupply:patientportal
http://www.rivta.se/domains/infrastructure_eservicesupply_patientportal.html
Supportväg
Supporten för 1177 Vårdguidens e-tjänster (1:a linjens support) har i uppdrag att ta emot och registrera ärenden samt svara på generella frågor om en tjänst, göra en initial felbedömning och samla in information för vidare felsökning. Det ska finnas information i det anslutande systemet om var användaren vänder sig med sina frågor om tjänsten.
Anslutande system förväntas upprätta en 2:a linje support som kan ta emot ärenden av följande karaktär:
- Felanmälan som kräver teknisk felsökning i tjänsten
- Synpunkter och förbättringsförslag på tjänsten
- Landstings- och regionsspecifika frågor om tillämpning och användning (exempelvis frågor om urval och ”Hur gör jag”-frågor).
Här ser vi helst att det upprättas en kontaktväg in för alla ärenden, en så kallad Single Point of Contact (SPOC). Det kommer att vara den kontaktväg som e-tjänsternas 1:a linje support skickar ärenden till.
Skicka kontaktuppgifter till 2:a linjens support och en presentation om tjänsten (se mall för exempel på hur en sådan mall kan se ut) till förvaltningen för 1177 Vårdguiden, e-tjanster@1177.se. Detta ska skickas 4 veckor innan tjänsten blir tillgänglig för användare.
...
Information som 1:a linjens support ska samla in vid en felanmälan för att felsökning ska kunna utföras:
Nedanstående punkter är standardinformation som 1:a linjens support samlar in vid felanmälningar. Ni ska ange om ytterligare information ska samlas in för felsökning hos er.
1. Personnummer
2. Beskrivning: Vilket felmeddelande uppstår?
3. Vilken webbläsare och version används?
4. Vilket operativsystem och version används?
5. Skärmdump som visar felet
6. Datum och tidpunkt för felet:
7. Eventuellt den mottagning det gäller
Beskrivning av supportkedjan
...
Vid ärenden som 1:a linjen ej kan/ska besvara sänder de vidare till 2:a linjens support (hos anslutande system) med av er i förväg efterfrågade uppgifter från anmälaren. 1:a linjens support stänger ärendet i sitt ärendehanteringssystem.
...
2:a linjens support ansvarar för att svara anmälaren. Vidare kontakt sker mellan 2:a linjen och anmälaren. 2:a linjens support informerar om att de har tagit över ärendet. Vid misstanke att det kan dröja med åtgärd/återkoppling i ärendet ansvarar 2:a linjens support om att informera anmälaren om det.
...
De gånger en anmälare hör av sig om statusuppdatering/följdfråga till 1:a linjens support skickar 1:a linjen en statusförfrågan till 2:a linjens support.
...