TA 53 - Hantera registrerat åtkomstsamtycke


Denna tillämpningsanvisning beskriver hur hälso- och sjukvården kan få åtkomst till en patients Nationella läkemedelslista genom registrerat åtkomstsamtycke.







1. Verksamhetsbeskrivning

Syftet med denna tillämpningsanvisning är att beskriva hur Registrerade åtkomstsamtycken i Nationella läkemedelslistan ska hanteras av behörig hälso- och sjukvårdspersonal. Funktionen avser hantering av åtkomstsamtycken, från en patient med personnummer, till en legitimerad hälso- och sjukvårdspersonal som är behörig att ta del av patientens information i Nationella läkemedelslistan.

Funktionen stödjer även patienten när denne vill hantera sina förfrågningar eller åtkomstsamtycken i Nationella läkemedelslistan. Vården registrerar en samtyckesförfrågan som patienten sedan kan godkänna eller avvisa. Samtycket kan inte användas förrän patienten har godkänt förfrågan via Läkemedelskollen. När patienten accepterar en förfrågan sätts giltighetstiden till dagens datum +4år. Patienten kan när som helst återkalla ett registrerat åtkomstsamtycke via Läkemedelskollen.

1.1. Behörighetsroller

Följande behörighetsroller berörs av denna tillämpningsanvisning: 

  •  Privatperson
    • Patient
  • Hälso- och sjukvårdspersonal
    • Förskrivare
      • Förskrivare med vårdgivare
      • Förskrivare utan vårdgivare
    • Legitimerad vårdpersonal Sjuksköterska
    • Legitimerad vårdpersonal Farmaceut
    • Legitimerad vårdpersonal Dietist

En definition av behörighetsrollerna finns på sidan Roller.

1.2. Termer och definitioner

En beskrivning av samtliga termer som används i denna tillämpningsanvisning går att hitta på sidan Termer och begrepp i Handboken.

1.3. Resurser som används

I tabell 1 listas de informationsresurser, FHIR-resurser och FHIR-profiler som ska användas i denna tillämpningsanvisning.

Se Generell beskrivning av FHIR för en mer generell beskrivning av FHIR-resurser och FHIR-profiler i Nationella läkemedelslistan.

Tabell 1 - Informationsresurser 

Informationsresurs

FHIR-Resurs

FHIR-Profil
PersonalPractitioner

NLLPractitioner

PatientPatientNLLPatient
ÅtkomstsamtyckeshändelseProvenance

NLLProvenance

Specialiserad profil

NLLProvenanceConsentAccess

Registrerat åtkomstsamtyckeConsentNLLAccessConsent

 

2. Delfunktioner och varianter av tillämpningsanvisningen

2.1. Förkrav

Innan en delfunktion kan tillämpas måste följande krav vara uppfyllda:

2.2. Delfunktion 1 - Registrera förfrågan om åtkomstsamtycke 

2.2.1. Variant 1.1 Registrera förfrågan om åtkomstsamtycke

Krav-ID: 53:1:1.1

Beskrivning av tillämpning

Användaren behöver åtkomst till patientens uppgifter i Nationella Läkemedelslistan och ber patienten om åtkomstsamtycke genom att skapa en digital förfrågan. 

Roller som kan registrera förfrågan till sig själva är: 

Hälso- och sjukvårdspersonal:

  • Förskrivare 
    • Förskrivare med vårdgivare
    • Förskrivare utan vårdgivare
  • Sjuksköterska utan förskrivningsrätt
  • Farmaceut inom hälso- och sjukvård
  • Dietist

Information som krävs för att registrera förfrågan om åtkomstsamtycke och kontroller som görs av informationen finns under avsnitt 2.4 Efterfrågad information samt 3. Regler och kontroller.

2.3. Delfunktion 2 - Uppdatera åtkomstsamtycke

2.3.1. Variant 2.1 - Avvisa förfrågan om åtkomstsamtycke

Krav-ID: 53:2:2.1

2.3.1.1. Beskrivning av tillämpning

En registrerad förfrågan om åtkomstsamtycke har avvisats av patienten, eller av vårdpersonal eller administratör på E-hälsomyndigheten. Patienten kan bara avvisa en förfrågan som är registrerat på patienten själv enligt regel R005. Vårdpersonal kan bara avregistrera egna åtkomstsamtycken där vårdpersonal är samtyckestagare.

Information som krävs för att avvisa ett åtkomstsamtycke och kontroller som görs av informationen finns under avsnitt  2.4 Efterfrågad information samt 3. Regler och kontroller.

2.3.2. Variant 2.2 - Avregistrera åtkomstsamtycke

Krav-ID: 53:2:2.2

Beskrivning av tillämpning

Ett registrerat åtkomstsamtycke i Nationella läkemedelslistan kan avregistreras av patienten själv, administratör på E-hälsomyndigheten eller vårdpersonal. Patienten kan bara avregistrera ett åtkomstsamtycke som är registrerat på patienten själv enligt regel R005. Vårdpersonal kan bara avregistrera egna åtkomstsamtycken där vårdpersonal är samtyckestagare.

Information som krävs för att avregistrera ett åtkomstsamtycke och kontroller som görs av informationen finns under avsnitt  2.4 Efterfrågad information samt 3. Regler och kontroller.

2.4. Efterfrågad information

2.4.1. Meddelandehuvud

Information i meddelandehuvudet ska för denna tillämpningsanvisning anges enligt regler tillämpningsmönster 2.3 Skapa eller uppdatera resurser som beskrivs i  Informationsspecifikation – meddelandehuvud.

2.4.2. Informationsresurs Registrerat åtkomstsamtycke 

Tabell 2 - Informationsresurs Registrerat åtkomstsamtycke

Term

Villkor för händelsetyp Registrera förfråganVillkor för händelsetyp Acceptera förfråganVillkor för händelsetyp Avvisa förfråganVillkor för händelsetyp  Avregistrera åtkomstsamtycke

Kommentar

Samtyckes-idSätts automatiskt enligt Auto54Får inte ändrasFår inte ändrasObligatorisk
SamtyckesversionSätts automatiskt enligt Auto55Sätts automatiskt enligt Auto55Sätts automatiskt enligt Auto55Sätts automatiskt enligt Auto55
PatientreferensObligatoriskFår inte ändrasFår inte ändrasObligatorisk
Informationsklass

Obligatoriskt

Sätts automatiskt till "IDSCL" 

Får inte ändrasFår inte ändrasFår inte ändras

IDSCL - Samtycket medger att information kan lämnas ut med direktåtkomst med undantag för spärrad information som filtreras bort.

IDSCL innebär att samtycket inte medger åtkomst till eventuellt spärrade uppgifter.

IDSCL är en ActConsentType.

Samtyckestatus

Obligatorisk

Enda tillåtna värde: "Förfrågan"

Obligatorisk

Enda tillåtna värde: "Aktiv"

Obligatorisk

Enda tillåtna värde: "Förfrågan"

Obligatorisk

Enda tillåtna värde: "Inaktiv"

Om felaktig status anges genereras felmeddelande "Felaktig status {status} för angiven händelsetyp {typ}"
Tillämpningsområde

Får inte ändras.

Enda tillåtna värde: "patient-privacy"

Får inte ändras.

Enda tillåtna värde: "patient-privacy"

Får inte ändras.

Enda tillåtna värde: "patient-privacy"

Får inte ändras.

Enda tillåtna värde: "patient-privacy"

Avser hantering av känsliga personuppgifter.
Samtyckestyp ObligatoriskFår inte ändrasFår inte ändrasFår inte ändrasEnda tillåtna värde: "INFA"

Samtyckestagartyp

Obligatorisk

Obligatorisk


ObligatoriskObligatorisk

Enda tillåtna värde: "GRANTEE"

Samtyckestagare

ObligatoriskObligatoriskObligatoriskObligatorisk

Typ av inbäddad resurs för samtyckestagare. 

(info)  Fler samtyckstagare kan tillkomma.

Vårdpersonal

Obligatorisk.


ObligatoriskObligatoriskObligatorisk

Referens till inbäddad resurs som är NLLPractitioner.

Förskrivarkod eller Legitimationskod för samtyckestagare. Validering görs att motsvarande förskrivarkod/legitimationskod finns i intyget.

Giltigt från och medFår inte angesSätts automatiskt enligt Auto49 Får inte angesFår inte ändrasTidpunkt då åtkomstsamtycket börjar gälla
Giltigt till och medFår inte angesSätts automatiskt enligt Auto52Får inte angesSätts automatiskt enligt Auto52Tidpunkt då åtkomstsamtycket slutar gälla
Förfrågan giltigt från och medSätts automatiskt enligt Auto46 Får inte ändras Får inte ändras Får inte ändras Tidpunkt då förfrågan skapades
Förfrågan giltigt till och medSätts automatiskt enligt Auto47 Får inte ändras Får inte ändras Får inte ändras Tidpunkt då förfrågan avslutas

2.4.3. Informationsresurs Åtkomstsamtyckeshändelse 

En Händelse måste alltid innehålla information om den som utför händelsen. I de fall en Händelse utförs på uppdrag av någon annan ska information om uppdragsgivare anges.

Informationen hanteras i profilen Händelse och ska refereras i meddelandehuvud X-Provenance,  se Informationsspecifikation – meddelandehuvud.

Vid registrera åtkomstsamtycke ska endast utförare anges, uppdragsgivare är inte tillåten.

Tabell 3 - Informationsresurs Händelse 

Term

Villkor

Kommentar

Händelse-id

Genereras automatiskt


Utförare

Obligatorisk. "Utförare måste anges"

Om utförare är patient anges en patientreferens.

Se informationsresurs "Personal" 


Händelsetidpunkt

Sätts automatiskt enligt Auto07.


Resursreferens

Referenser till samtliga resurser som påverkats vid händelsen


Händelsetyp

Obligatorisk.

Typ av händelse kopplat till åtkomstsamtycke.

Kan vara

  • Registrera förfrågan
  • Avvisa förfrågan
  • Avregistrera samtycke
UppdragsgivareIngen uppdragsgivare får anges när vården är utförare

2.4.4. Informationsresurs Personal

Informationsresurs Personal förekommer både på Registrerat åtkomstsamtycke (samtyckestagare) och på Åtkomstsamtyckeshändelsen och är samma person (ingen uppdragsgivare är tillåten). Information om samtyckestagare och utförare av Åtkomstsamtyckeshändelsen är den aktör som är inloggad.

När det är Patient som är utförare eller samtyckesgivare gäller inte det i tabellen nedan utan då är det endast Patient.Ref som anges. 

Tabell 4 - Informationsresurs Personal

TermVillkor Registrerat åtkomstsamtycke
Villkor ÅtkomstsamtyckeshändelseKommentar
Hälso- och sjukvårdspersonal - samtyckestagareUtförare
Hälso- och sjukvårdspersonal med vårdgivareFörskrivare utan vårdgivareHälso- och sjukvårdspersonal
Legitimationskod

Obligatoriskt att ange legitimationskod eller förskrivarkod. Om varken legitimationskod eller individuell förskrivarkod angivits så kompletteras legitimationskoden enligt VR041. Angivet värde valideras mot FORS enligt VR033 och mot intyget VR034.

Obligatoriskt att ange legitimationskod eller förskrivarkod. Om varken legitimationskod eller individuell förskrivarkod angivits så kompletteras legitimationskoden enligt VR041. Angivet värde valideras mot FORS enligt VR033 och mot intyget VR034

Obligatoriskt att ange legitimationskod eller förskrivarkod. Om varken legitimationskod eller individuell förskrivarkod angivits så kompletteras legitimationskoden enligt VR041. Angivet värde valideras mot FORS enligt VR033 och mot intyget VR034


Individuell förskrivarkod

Obligatoriskt att ange individuell förskrivarkod eller legitimationskod. Angivet värde valideras mot FORS enligt VR033 och mot intyget enligt VR034 

Obligatoriskt att ange individuell förskrivarkod eller legitimationskod. Angivet värde valideras mot FORS enligt VR033 och mot intyget enligt VR034 

Obligatoriskt att ange individuell förskrivarkod eller legitimationskod. Angivet värde valideras mot FORS enligt VR033 och mot intyget enligt VR034 


Gruppförskrivarkod

Får inte anges

 

Får inte angesFår inte anges
Yrkeskod

Obligatoriskt att ange Yrkeskod. Valideras mot FORS enligt VR033 och mot intyget VR034

Obligatoriskt att ange Yrkeskod. Valideras mot FORS enligt VR033 och mot intyget VR034Obligatoriskt att ange Yrkeskod. Valideras mot FORS enligt VR033 och mot intyget VR034
Utökad yrkeskodFår inte angesFår inte anges

Förnamn

Obligatorisk

Tillåtna tecken valideras enligt FK003

Obligatorisk

Tillåtna tecken valideras enligt FK003

Obligatorisk

Tillåtna tecken valideras enligt FK003


Efternamn

Obligatorisk

Tillåtna tecken valideras enligt FK003

Obligatorisk

Tillåtna tecken valideras enligt FK003

Obligatorisk

Tillåtna tecken valideras enligt FK003


Telefon


Max två telefonnummer kan anges se VR160, struktur upprepas då för varje telefonnummer.

Telefonnummer

Telefonnummer för förskrivare är frivilligt att ange. Om kontaktuppgift telefon anges så är samtliga fält obligatoriska.

Telefonnummer för förskrivare är frivilligt att ange. Om kontaktuppgift telefon anges så är samtliga fält obligatoriska.

Telefonnummer för förskrivare är frivilligt att ange. Om kontaktuppgift telefon anges så är samtliga fält obligatoriska.


Tillgänglig för patient

Valfri att ange

Valfri att angeValfri att ange

Rangordning

Valfri att ange

Valfri att angeValfri att ange
Arbetsplats



Arbetsplatstyp

Obligatorisk. Giltigt värde är ”Vårdenhet”

Kontrolleras i VR110

Obligatorisk

Giltigt värde är "Enskild förskrivare".

Kontrolleras i VR110

Obligatorisk. Giltigt värde är ”Vårdenhet”

Kontrolleras i VR110


Arbetsplats namn

Obligatorisk


Obligatorisk


Obligatorisk



Arbetsplats id typ

Villkor

Ska anges om ett arbetsplats id anges. Om angiven ska det vara HSA eller ORGNR 

N/A

Villkor

Ska anges om ett arbetsplats id anges. Om angiven ska det vara HSA, ARBETSPLATSKOD eller ORGNR 


Arbetsplats id

Valfri att angeN/AValfri att ange
Adressuppgift



Adresstyp

Adresstyp=BesöksadressAdresstyp=BesöksadressAdresstyp=Besöksadress

Adress

 Valfri att angeValfri att angeValfri att ange

Postnummer

Valfri att angeValfri att angeValfri att ange

Postort

ObligatoriskObligatoriskObligatorisk


3. Regler och kontroller

3.1. Generella verksamhetsregler

Verksamhetsregler beskriver validering och verksamhetslogik som E-hälsomyndigheten ansvarar för. Generella verksamhetsregler är de som används i flera tillämpningsanvisningar. Alla dessa finns beskrivna i Generella verksamhetsregler.

I tabell 5 nedan listas de generella verksamhetsregler som används i den här tillämpningsanvisningen.

Tabell 5 - Generella verksamhetsregler

Regel-id

Regel namn

VR033Validering av legitimation mot FORS

VR034

Validering av händelsehanterade personal mot intyget

VR041

Komplettering av legitimationskod vid anrop med personnummer

VR110Är rätt arbetsplatstyp angiven på kontaktuppgift
VR160Antalet telefonnummer till en förskrivare begränsas
 

3.2. Automatiska kompletteringar 

Automatisk komplettering innebär att E-hälsomyndigheten tillför information för vissa attribut vid vissa tillfällen. I tabell 6 nedan listas de automatiska kompletteringar som görs i den här tillämpningsanvisningen. En detaljerad beskrivning av alla automatiska kompletteringar finns i Automatiska kompletteringar.

Tabell 6 - Automatiska kompletteringar

IdRegel namn

Auto07

Komplettering av tidpunkt för händelse
Auto33Händelse kompletteras med unikt id
Auto46Förfrågan giltig från och med vid skapande av förfrågan om åtkomstsamtycke
Auto47Förfrågan giltig till och med vid skapande av förfrågan om åtkomstsamtycke

Auto48

Förfrågan giltig till och med vid avvisande av förfrågan om åtkomstsamtycke
Auto49Samtycke giltigt från och med vid accepterande av förfrågan om åtkomstsamtycke
Auto51Samtycke giltigt till och med vid avregistrering av åtkomstsamtycke
Auto52Samtycke giltigt till och med vid accepterande av förfrågan om åtkomstsamtycke
Auto53Spärrade uppgifter flagga vid registrera förfrågan om åtkomstsamtycke

Auto54

Generera unikt samtyckes-id för ny förfrågan om åtkomstsamtycke

Auto55

Generera unikt versionsnummer för samtyckesversion

 

3.3. Specifika verksamhetsregler 

Verksamhetsregler beskriver validering och verksamhetslogik som E-hälsomyndigheten ansvarar för. 

I tabell 7 nedan listas de specifika verksamhetsregler som bara används i denna tillämpningsanvisning. 

Tabell 7 - Specifika verksamhetsregler

Id

Namn

Kommentar

Felkod och felmeddelande
R001Avvisa förfrågan

Hälso-och sjukvårdspersonal, administratör på E-hälsomyndigheten och patient ska kunna avvisa en förfrågan inom 7 dagar från det datumet när det sparades.

Om förfrågan redan är accepterad av patient eller om tiden har gått ut är det inte möjligt att avvisa förfrågan.

2-25-186 Förfrågan kan inte avbrytas.
R002Skapa förfrågan inte möjligt

Det ska inte vara möjligt att skapa en ny förfrågan om

  • det redan finns en förfrågan om samtycke med status "Förfrågan" och t.o.m. datum inte passerats
  • det finns ett registrerat samtycke med status "Aktiv" och med samma samtyckesgivare och samtyckestagaret.o.m. datum och tidpunkt inte passerats
2-25-187 Förfrågan redan finns eller har redan accepterats.
R004Patientens ålder

För att kunna skapa en förfrågan om samtycke, avvisa en förfrågan om samtycke eller avregistrera en förfrågan om samtycke måste patienten vara 18 år eller äldre.

2-25-189 Förfrågan kan endast skapas till patient som är 18 år eller äldre.
R005Kontroll av utförare patient

Vid händelsen "Acceptera förfrågan", "Avregistrera samtycke" eller "Avvisa förfrågan" kontrolleras att utföraren är samma som samtyckesgivaren dvs patienten.

2-25-190 Patienten får bara hantera ett samtycke som avser patienten själv.
R007Regler för statusövergångar

När aktör är Vård:

  • en registrerad förfrågan om samtycke med status "Förfrågan" kan bara avvisas. Status förblir "Förfrågan"
  • ett registrerat samtycke med status "Aktiv" kan bara avregistreras och status blir "Inaktiv"
  • ett registrerat samtycke med status "Inaktiv" kan inte hanteras, Status förblir "Inaktiv"

När aktör är Privatperson:

  • en registrerad förfrågan om samtycke med status "Förfrågan" kan avvisas eller accepteras. Om förfrågan avvisas förblir statusen "Förfrågan". Om förfrågan accepteras blir statusen "Aktiv".
  • ett registrerat samtycke med status "Aktiv" kan endast avregistreras. Vid avregistrering får samtycket status "Inaktiv".
  • ett registrerat samtycke med status "Inaktiv" kan inte hanteras och status förblir "Inaktiv"
2-25-704 Förändringen av åtkomstsamtycket är otillåten.

 

3.4. AFF-kontroller och kontrollsamlingar

Vid registrering av en ny förfrågan om åtkomstsamtycke körs inga AFF kontroller

3.5. Formatkontroller

E-hälsomyndigheten gör formatkontroller på vissa attribut i Nationella läkemedelslistan. I tabell 8 nedan listas de formatkontroller som används i den här tillämpningsanvisningen. Formatkontrollerna beskrivs detaljerat på sidan Formatkontroller i Nationella läkemedelslistan.

Tabell 8 - Formatkontroller

Id

Namn

FK003Tillåtna tecken i namnfält
FK004Enkel textvalidator

 

4. Presentationskrav

Inga specifika presentationskrav för denna tillämpningsanvisning. 




Versionshistorik

VersionDatumKommentar
1.02022-05-25

Ny sida

1.12022-06-16Lagt till information om adressuppgift för förskrivare utan vårdgivare, avsnitt 2.4 Efterfrågad information - Informationsresurs Personal
1.22022-08-15Rättat FHIR-profil för Åtkomstsamtyckeshändelse till 'NLLProvenanceConsentAccess'.
1.32022-11-10

Förtydligat samtyckets giltighet i Verksamhetsbeskrivning 

Lagt till avsnitt för meddelandehuvud med hänvisning till tillämpningsmönster i Informationsspecifikation meddelandehuvud.

Förbättringar dokumentation:

  • I kapitel 3.3 Specifika verksamhetsregler
    • Lagt till kolumn för felkod och felmeddelande
1.42023-08-24Ändrat namn på tillämpningsanvisningen till "Hantera registrerat åtkomstsamtycke" 
1.52024-02-22Förtydligat hantering av samtyckestagare och samtyckestagartyp