/
Anpassa journalsystem för NPÖ konsumentanslutning (TGP)

Anpassa journalsystem för NPÖ konsumentanslutning (TGP)

Denna information vänder sig till systemleverantörer som ska utveckla en TGP-lösning för att vårdgivare ska kunna ansluta till NPÖ som konsument.

TGP

Tillgänglig patient (TGP) är en tjänst som gör det möjligt att begränsa åtkomst till patientinformation inom sammanhållen vårddokumentation, via Nationell patientöversikt (NPÖ). För att kunna söka på en patient i NPÖ måste vårdgivaren ha etablerat en TGP-tjänst som hanterar åtkomstkontroll baserat på om patientrelation föreligger. TGP-tjänsten begränsar urvalet av patienter som vårdpersonalen kan söka information om. Kravet på patientrelation är reglerad i Lagen om sammanhållen vård- och omsorgsdokumentation och kravet på att det ska finnas en teknisk funktion som säkerställer detta kommer från Integritetsskyddsmyndigheten (IMY), f.d. Datainspektionen. Detta gäller utöver krav på patientens samtycke.

TGP-alternativ

NPÖ har stöd för två olika typer av TGP-lösningar:

  • Att registrera information om vårdrelation i Ineras TGP, som finns i två instanser (TGP0 på Sjunet samt TGP1 på Internet), eller

  • Att använda en egen TGP-tjänst, så kallad online-TGP, som hanterar bedömning av om vårdrelation föreligger

Mer information finns på sidan https://inera.atlassian.net/wiki/spaces/OINPN/pages/442336878.

För nyutveckling rekommenderas i första hand online-TGP.

Användning av Ineras TGP

Vid användning av Ineras TGP (TGP0 eller TGP1) sker registrering av vårdrelation i samband med uthopp från journalsystemet till NPÖ. För detta kan programmet Condis användas, alternativt behöver motsvarande funktionalitet implementeras i journalsystemet.

För att få tillgång till Condis-programmet, kontakta Inera.

Condis-programmet har tre huvudsakliga funktioner, vilka behöver implementeras i journalsystemet om inte Condis ska användas. Dessa funktioner är:

  • Anrop mot Ineras TGP (TGP0 eller TGP1) för registrering av vårdrelation

  • Uthopp till NPÖ med vald patient

  • Kontexthantering: om en användare har gjort uthopp till NPÖ med en patient, och sedan vill växla till en annan patient, behöver föregående session stängas ner för att säkerställa att användaren inte har flera patienters information tillgänglig i NPÖ samtidigt. Då användaren byter till en annan patient behöver systemet avsluta den pågående sessionen och göra nytt uthopp till NPÖ med den nya patienten.

För att ett journalsystem ska kunna göra registreringar i Ineras TGP utan att Condis används behöver journalsystemet först vitlistas. Detta hanteras av NPÖ-förvaltningen på Inera.

I anropet mot Ineras TGP kan uppgift om vårdgivare, alternativt både vårdgivare och vårdenhet, skickas. Det är vårdgivaren som ansvarar för regelverket som gäller begränsning av patientval, det vill säga på vilken nivå (vårdgivare eller vårdenhet) som vårdrelationen ska registreras. Mer information finns i TGP funktionsbeskrivning, kapitlet “Regelverk för tillgängliga patienter”.

Kontakta Inera för att få tillgång till instruktioner för hur uthopp till NPÖ och anrop mot Ineras TGP ska konstrueras, mer information om vitlistning, samt adresser till Ineras TGP i test- och produktionsmiljö.

Tester

Test av uthopp till NPÖ kan göras i någon av Ineras testmiljöer (SIT eller QA).

För tester av anrop mot Ineras TGP rekommenderas Ineras SIT-miljö. I QA-miljön är TGP-funktionen (TGP1) konfigurerad att svara att alla testpersoner är tillgängliga för alla användare, vilket innebär att det inte är möjligt att verifiera i NPÖ att anropet mot TGP har gett korrekt resultat.

SITHS-testkort krävs för tester i SIT och/eller QA. Det krävs även att test-användaren (testkortet) har medarbetaruppdrag som är giltigt för inloggning i NPÖ.

Se https://inera.atlassian.net/wiki/spaces/OINPN/pages/edit-v2/3887038505#Tillg%C3%A5ng-till-NP%C3%96-i-olika-milj%C3%B6er.

Anslutning

Inför en vårdgivares/vårdenhets anslutning i produktion behöver vårdgivaren ha:

  1. Beställt tjänsten NPÖ konsument i Ineras kundportal. Erbjudandet som ska beställas heter “Nationell patientöversikt - Konsument direktanslutning”.

  2. Beställt krypteringsnycklar för PROD-miljön. Detta görs genom att lägga ett ärende till Inera. I ärendet behöver vårdgivaren ange journalsystem, krypteringsalgoritm, samt att det gäller nycklar för NPÖ och TGP i produktionsmiljö.

Se checklista för anslutning som konsument för mer detaljerad information om vad som krävs för att ansluta till NPÖ som konsument.

OBS! Teknisk anslutning, så kallad TAKning, krävs inte för att kunna använda NPÖ med Ineras TGP. Det rekommenderas ändå att vårdgivaren beställer detta för de vårdenheter som ska använda NPÖ, eftersom det bland annat underlättar eventuell framtida felsökning. Beställning av teknisk anslutning görs i Beställningsstödet. Se https://inera.atlassian.net/wiki/spaces/OINPN/pages/2354385730.

Online-TGP

För användning av online-TGP behöver systemleverantören bygga en tjänsteproducent (TGP-tjänst) som i realtid kan besvara TGP-frågorna från NPÖ. Tjänsteproducenten ska byggas i enighet med regelverken på RIV-TA. För TGP är det tjänstekontraktet AssertCareEngagement som ska implementeras.

Systemleverantören behöver även implementera ett regelverk för vad som utgör en vårdrelation. Det är vårdgivaren som ansvarar för regelverket som gäller begränsning av patientval. Mer information finns i TGP funktionsbeskrivning, kapitlet “Regelverk för tillgängliga patienter”.

Kommunikationen mellan NPÖ och tjänsteproducenten (TGP-tjänsten) går via Nationella tjänsteplattformen. För kommunikation mellan Nationella tjänsteplattformen och tjänsteproducenten krävs att man skaffar och installerar ett SITHS funktionscertifikat.

En egen TGP-tjänst kan kombineras med ett egenbyggt uthopp från journalsystemet till NPÖ där patientens personnummer kan skickas med. För att få tillgång till instruktioner för hur uthopp till NPÖ ska konstrueras, kontakta Inera.

I många fall kan systemleverantören fungera som så kallad agent när leverantören tillhandahåller en online-TGP:

  • Om en och samma instans av online-TGP används av flera olika vårdgivare så innebär det att systemleverantören kommer att få rollen som agent i anslutningen.

  • Om varje vårdgivare har en egen instans/installation av online-TGP så fungerar systemleverantören vanligen inte som agent.

Här finns mer information om att bli och vara agent: https://www.inera.se/kontakta-oss/avtal-bestallning-anslutning/ineras-agentavtal/teckna-agentavtal-och-vara-agent/

Tester

Releasepaketet för tjänstekontraktet AssertCareEngagement innehåller en testsvit som kan användas för verifiering under utvecklingen. Denna testsvit kan köras utan koppling till någon av Ineras miljöer.

Test av uthopp till NPÖ kan göras i någon av Ineras testmiljöer (SIT eller QA).

För verifiering av TGP-funktionaliteten rekommenderas Ineras SIT-miljö. I QA-miljön är TGP-funktionen konfigurerad att alltid svara att alla testpersoner är tillgängliga för alla användare, vilket innebär att det inte är möjligt att verifiera i NPÖ att TGP:n ger ett korrekt svar. För att test av TGP-funktionaliteten i SIT ska vara möjlig behöver först en teknisk anslutning, så kallad TAKning, göras mot SIT-miljön hos Inera. Detta beställs via Beställningsstödet. Se https://inera.atlassian.net/wiki/spaces/OINPN/pages/2354385730.

Test nr 3 på Testsidan, https://testsidan.npo.se/ kan användas för att verifiera att kommunikationen mellan Nationella tjänsteplattformen och TGP-tjänsten fungerar. Test nr 3 på testsidan kan även användas som stöd under eventuell felsökning, för att kontrollera om problemet ligger i kommunikationen mellan Nationella tjänsteplattformen och TGP-tjänsten. För att det ska vara möjligt att använda Testsidan på detta sätt behöver först en teknisk anslutning (TAKning) göras mot QA-miljön hos Inera. Detta beställs via Beställningsstödet. Se https://inera.atlassian.net/wiki/spaces/OINPN/pages/2354385730 där det även finns länk till detaljerade instruktioner med skärmklipp.

Observera att övriga tester på Testsidan inte ska användas.

SITHS-testkort krävs för tester i SIT och/eller QA. Det krävs även att test-användaren (testkortet) har medarbetaruppdrag som är giltigt för inloggning i NPÖ.

Se https://inera.atlassian.net/wiki/spaces/OINPN/pages/edit-v2/3887038505#Tillg%C3%A5ng-till-NP%C3%96-i-olika-milj%C3%B6er.

Anslutning

Inför en vårdgivares/vårdenhets anslutning i produktion behöver:

  • vårdgivaren ha beställt tjänsten NPÖ konsument i Ineras kundportal.

  • vårdgivaren ha beställt krypteringsnyckel för PROD-miljön, om uthopp ska göras till NPÖ. Krypteringsnyckel beställs genom att lägga ett ärende till Inera. I ärendet behöver vårdgivaren ange journalsystem, krypteringsalgoritm, samt att det gäller nyckel för NPÖ i produktionsmiljö.

  • vårdgivaren, alternativt agent/systemleverantör, ha beställt teknisk anslutning för de vårdenheter som ska använda NPÖ, så att anrop från NPÖ kan skickas till rätt online-TGP. Denna beställning görs i Beställningsstödet. Se https://inera.atlassian.net/wiki/spaces/OINPN/pages/2354385730.

Se checklista för anslutning som konsument för mer detaljerad information om vad som krävs för att ansluta till NPÖ som konsument.

 

Bra information inför utvecklingen

Systemroller

När en vårdgivare ska ansluta som NPÖ konsument (kunna ta del av andra vårdgivares information i NPÖ), behöver vårdgivaren ha en TGP-lösning. Vid anslutning av denna TGP-lösning fungerar tjänsten NPÖ samt den interna stödkomponenten TGPX som tjänstekonsumenter och TGP (Ineras TGP eller vårdgivarens online-TGP) agerar tjänsteproducent.

Tjänstekonsument

  • System som initierar ett specifikt informationsutbyte

  • Skickar begäran att hämta, ändra eller ta bort information i ett eller flera andra system

Tjänsteproducent

  • Uppvisar ett tekniskt gränssnitt som möjliggör för tjänstekonsumenter att genom begäran (frågemeddelanden) förändra eller begära information

  • Hanterar frågemeddelanden och producerar svarsmeddelanden enligt fastställt tjänstekontrakt

Mer information om begreppen tjänstekonsument/tjänsteproducent samt introduktion till principerna bakom dagens kommunikation över tjänsteplattformar: Interoperabilitet - med andra ord.

Om vårdgivaren använder Ineras TGP kommer TGP0 eller TGP1 att agera tjänsteproducent. Om vårdgivaren ansluter en online-TGP kommer denna online-TGP att agera tjänsteproducent.

Tillgång till NPÖ i olika miljöer

SITHS-testkort krävs i SIT och QA. Testkort är opersonliga och beställs från SITHS-ombud eller från Inera. Vårdmedarbetaruppdrag krävs för inloggning i NPÖ. Se detaljer på https://inera.atlassian.net/wiki/spaces/OINPN/pages/2354385877.

Brandväggsöppningar: https://inera.atlassian.net/wiki/spaces/OINPN/pages/2354221203

Stöddokumentation inför utveckling

Allmänt om tjänstekontrakt: Vad är tjänstekontrakt?

HSA och SITHS