TA 54 - Hämta registrerade åtkomstsamtycken


Denna tillämpningsanvisning beskriver kraven för hämtning av en patients registrerade åtkomstsamtycken i Nationella läkemedelslistan.







1. Verksamhetsbeskrivning

Funktionen avser hämtning av registrerade åtkomstsamtycken, där givaren är en patient som har personnummer, och där samtycket avser en hälso- och sjukvårdspersonal som är behörig att ta del av patientens information i Nationella läkemedelslistan. Syftet med funktionen är att vårdpersonal ska kunna kontrollera om det finns ett aktivt registrerat åtkomstsamtycke för att sedan kunna åberopa detta samtycke vid vidare åtkomster till patientens uppgifter i Nationella läkemedelslistan. Hälso- och sjukvårdspersonal kan hämta samtycken med status Aktiv eller Förfrågan. När samtycket har status Förfrågan måste patienten först acceptera förfrågan via Läkemedelskollen innan samtycket kan användas för åtkomst.


1.1. Behörighetsroller

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

  • 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 

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 vid hämtning av registrerade åtkomstsamtycken

Informationsresurs

FHIR-Resurs

FHIR-Profil
Registrerat åtkomstsamtycke Consent

NLLAccessConsent

Händelse/Åtkomstsamtyckeshändelse Provenance

NLLProvenance

Specialiserad profil

NLLProvenanceConsentAccess

 

2. Delfunktion 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 - Hämta registrerade åtkomstsamtycken - Vård

Hälso- och sjukvårdspersonal hämtar åtkomstsamtycke för ändamålen åstadkomma säker ordination, bereda vård och behandling samt komplettera journal.

Åtkomstsamtycket kan sökas med olika sökvillkor eller hämtas med en referens till en resurs.

2.2.1. Variant 1.1 Hämta åtkomstsamtycke med patientreferens

Krav-ID: 54:1:1.1

Beskrivning av tillämpning 

Hälso- och sjukvårdspersonal hämtar en patients åtkomstsamtycke med en patientreferens enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökning och hämtning. Senaste versionen av samtycket returneras. Vid hämtningen är det möjligt att inkludera den händelse som tillhör den returnerade versionen av samtycket.

Berörd resurs: Registrerat åtkomstsamtycke - NLLAccessConsent

Returnerad resurs: Registrerat åtkomstsamtycke - NLLAccessConsent

Möjlig inkluderad resurs: Åtkomstsamtyckeshändelse - NLLProvenanceConsentAccess

Resurser som returneras beskrivs i Hämtade informationsresurser. 

2.2.2. Variant 1.2 Hämta åtkomstsamtycke med logiskt id

Krav-ID: 54:1:1.2

Beskrivning av tillämpning 

Hälso- och sjukvårdspersonal hämtar en patients åtkomstsamtycke med en referens till samtycket enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökning och hämtning. Senaste versionen av samtycket returneras.

Berörd resurs: Registrerat åtkomstsamtycke - NLLAccessConsent

Returnerad resurs: Registrerat åtkomstsamtycke - NLLAccessConsent

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.2.3. Variant 1.3 Hämta händelser via ett åtkomstsamtycke

Krav-ID: 54:1:1.3

Beskrivning av tillämpning 

Hälso- och sjukvårdspersonal hämtar händelser för ett visst åtkomstsamtycke med en referens till samtycket enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökning och hämtning.

Berörd resurs: Registrerat åtkomstsamtycke - NLLAccessConsent

Returnerad resurs: Åtkomstsamtyckeshändelse - NLLProvenanceConsentAccess

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.2.4. Variant 1.4 Hämta enskild åtkomstsamtyckeshändelse

Krav-ID: 54:1:1.4

Beskrivning av tillämpning 

Hälso- och sjukvårdspersonal hämtar en händelse tillhörande ett åtkomstsamtycke med hjälp av händelsens logiska id enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökning och hämtning.

Berörd resurs: Åtkomstsamtyckeshändelse - NLLProvenanceConsentAccess

Returnerad resurs: Åtkomstsamtyckeshändelse - NLLProvenanceConsentAccess

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.2.5. Variant 1.5 Hämta versioner av ett åtkomstsamtycke

Krav-ID: 54:1:1.5

Beskrivning av tillämpning 

Hälso- och sjukvårdspersonal hämtar samtliga versioner eller en enskild version av ett åtkomstsamtycke med en referens till samtycket enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökning och hämtning.

Berörd resurs: Registrerat åtkomstsamtycke - NLLAccessConsent

Returnerad resurs: Registrerat åtkomstsamtycke - NLLAccessConsent

Resurser som returneras beskrivs i Hämtade informationsresurser.

3. Hanterad information 

3.1. Meddelandehuvud

Information i meddelandehuvudet ska för denna tillämpningsanvisning anges enligt regler i tillämpningsmönster 2.2.2. Hämta med säkerhetsintyg med åtkomsttyp och ändamål som beskrivs i Informationsspecifikation – meddelandehuvud.

3.2. Sökning och hämtning per resurs

Här anges sökparametrar per resurs och hur de kan kombineras i sökning för att nå önskat resultat, samt hur hämtning av resurs sker via dess logiska identifierare. 

3.2.1. Registrerat åtkomstsamtycke - NLLAccessConsent

Sökning

Tabell 2 - Sökparametrar, sökning på registrerat åtkomstsamtycke med patientreferens

Term

Villkor

Kommentar

Patientreferens

Obligatorisk.

Logiskt id för patient.

Samtyckestyp Obligatorisk.

Endast registrerade åtkomstsamtycken av angiven typ returneras. 

"INFA" - Information access representerar registrerade åtkomstsamtycken.

Samtyckestagare

Valfri

Obligatorisk.

Samtyckestagarens legitimationskod eller individuell förskrivarkod kan anges.

Om angiven sker validering mot säkerhetsintyget.

Om utelämnat används det person-id som finns angivet i säkerhetsintyget som samtyckestagare. Vid personnummer hämtas legitimationskod från Legitimationsregistret och används i sökningen.

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

Samtyckestagartyp Valfri. Anges för att filtrera samtycken baserat på vilken typ av samtyckestagare som samtycket avser. Kan vara hälso- och sjukvårdspersonal eller i framtid Organisation som avser en vårdenhet.
Samtyckesstatus Valfri. Endast registrerade åtkomstsamtycken som har angivna statusar returneras. Giltiga värden är "Aktiv" och "Förfrågan".
Inkludera händelse Valfri.

Anges för att inkludera händelsen som tillhör den returnerade versionen av en resurs. Se "include" och "revinclude" för respektive resurs.

Kan användas i variant 1.1 Hämta åtkomstsamtycke med patientreferens


Hämta samtycke via logiskt id

Tabell 3 - Sökparametrar, hämtning av registrerat åtkomstsamtycke med referens till samtycket

Term

Villkor

Kommentar

Referens till samtycke

Obligatorisk.

Används endast för att hämta ett specifikt samtycke.


3.2.2. Åtkomstsamtyckeshändelse - NLLProvenanceConsentAccess

Sökning

Tabell 4 - Sökparametrar, hämtning av händelser med referens till samtycke

Term

Villkor

Kommentar

Resursreferens

Referens till samtycke

Obligatorisk. De händelser som har angivet samtyckes-id som resursreferens returneras.

Hämta händelse via logiskt id

Tabell 5 - Sökparametrar, hämtning av händelse via referens till händelse

Term

Villkor Kommentar

Händelse-id

Referens till händelse

Obligatorisk. Anges för att hämta en specifik händelse via dess logiska id.

Hämta samtycken via patientresurs

Här beskrivs hur hämtning av samtycken kan ske genom att ange en annan basresurs som hämtningen utgår från. Sökningen returnerar samtycken som är relaterade till angiven resurs.

För mer information - se Compartment searches i Simplifier Guide för Nationella läkemedelslistan.

Tabell 6 - Sökparametrar, hämtning av samtycken via patientresurs

Term

Villkor

Kommentar

Patient Obligatorisk.

Anger typen av basresurs, i detta fall Patient, som hämtningen ska utgå ifrån

Basresurs som hämtningen utgår ifrån

Patient-id Obligatorisk.

Id för den specifika Patient-resurs som hämtning ska utgå ifrån.

Basresursens resurs-id som hämtning utgår ifrån.

Registrerat åtkomstsamtycke Obligatorisk.

Anger att förekomster av resurstyp Registrerat åtkomstsamtycke relaterade till angiven patientresurs ska hämtas. 

Returnerar alla samtycken som är relaterade till refererade patientresursen.

Hämta händelser via samtyckesresurs

Här beskrivs hur hämtning av händelser kan ske genom att ange en annan basresurs som hämtningen utgår från. Sökningen returnerar händelser som är relaterade till angiven resurs.

För mer information - se Compartment searches i  Simplifier Guide för Nationella läkemedelslistan.

Tabell 7 - Sökparametrar, hämtning av händelser via samtycke

Term

Villkor

Kommentar

Samtycke Obligatorisk.

Anger typen av basresurs, i detta fall Consent, som hämtningen ska utgå ifrån

Basresurs som hämtningen utgår ifrån

Samtyckes-id Obligatorisk.

Id för den specifika Consent-resurs som hämtning ska utgå ifrån.

Identitet på den basresurs vars händelser ska returneras

Händelse Obligatorisk.

Anger att förekomster av resurstyp Provenance relaterade till angiven patientresurs ska hämtas.

Anges för att returnera alla relaterade händelser för en förskrivning

3.3. Hämtade informationsresurser

Följande informationsresurser kan returneras vid en sökning enligt denna tillämpningsanvisning, beroende på vilken sökning som genomförs:

4. Regler och kontroller

4.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.

Tabell 8 - Generella verksamhetsregler i denna tillämpningsanvisning

Regel-id

Regel namn

VR095 Validering av patient i  meddelandehuvud mot patient i anrop
VR096 Validering av att efterfrågad resurs tillhör patienten i meddelandehuvud
VR163 Informationsfilter vid åtkomst för privatpersonanrop
VR196

Metadata testresurs

4.2. Automatiska kompletteringar 

Inga automatiska kompletteringar finns för denna tillämpningsanvisning.

4.3. Specifika verksamhetsregler 

Inga specifika verksamhetsregler finns för denna tillämpningsanvisning.

4.4. AFF-kontroller och kontrollsamlingar

Vid hämtning av registrerade åtkomstsamtycken körs inga AFF-kontroller.

4.5. Filtreringsregler

Filtreringsreglerna beskriver vilken information E-Hälsomyndigheten filtrerar bort vid hämtning av information från Nationella läkemedelslistan. Alla filtreringsregler finns beskrivna på sidan Filtreringsregler. 

Tabell 9 - Filtreringsregler i denna tillämpningsanvisning

Filtreringsregel-id Regelnamn
FIL015 Filtrering av registrerade åtkomstsamtycken

Filtrering görs även enligt verksamhetsregel VR163.

5. Presentationskrav

r presentationskrav kring registrerade åtkomstsamtycken, se Generella presentationskrav för anslutande aktör och system P3.2, samt informationsspecifikation Registrerat åtkomstsamtycke - NLLAccessConsent.




Versionshistorik

Version Datum Kommentar
1.0 2022-05-25 Ny sida
1.1 2022-08-15 Rättat namn på specialiserad profil vid 1.3 till NLLProvenanceConsentAccess.
1.2 2022-08-30 Rättat namn på händelse till Åtkomstsamtyckeshändelse
1.3 2022-11-10 I avsnitt meddelandehuvud ersatt regler med hänvisning till tillämpningsmönster i Informationsspecifikation meddelandehuvud.
1.4 2023-11-09 Lagt till Möjlig inkluderad resurs i variant 1.1 och sökvillkor Inkludera händelse i tabell 2.
1.5 2024-08-26
  • Ny regel VR196 Metadata testresurs tillagd.
  • Regler för Samtyckestagare i tabell 2 vid sökning med patientreferens har justerats. Gör det möjligt att söka via samtyckestagarens personnummer i säkerhetsintyget.
  • Förtydliganden i tabell 4-7