TA 54 - Hämta registrerade åtkomstsamtycken


Denna tillämpningsanvisning beskriver kraven för att kunna hämta registrerade åtkomstsamtycken till 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 registrerat 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

Informationsresurs

FHIR-Resurs

FHIR-ProfilAnmärkning
Registrerat åtkomstsamtyckeConsent

NLLAccessConsent


Händelse/ÅtkomstsamtyckeshändelseProvenance

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.

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. 

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.

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.

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.

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 Informationsspecifikation – meddelandehuvud.

3.2. Sökning och hämtning per resurs

Här anges sökparametrar per resurs och hur de kan kombineras för sökning för att nå önskat resultat samt hur man kan hämta resurser via deras logiska identifierare. 

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.

SamtyckestypObligatorisk.

Endast registrerade åtkomstsamtycken av angiven typ returneras. 

"INFA" - Information access  representerar registrerade åtkomstsamtycken.

SamtyckestagareObligatorisk.

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

SamtyckestagartypValfri.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.
SamtyckesstatusValfri.Endast registrerade åtkomstsamtycken som har angivna statusar returneras. Giltiga värden är "Aktiv" och "Förfrågan".
Inkludera händelseValfri.

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 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 om man vill hämta ett specifikt samtycke.


Åtkomstsamtyckeshändelse - NLLProvenanceConsentAccess

Sökning

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

Term

Villkor

Kommentar

Referens till samtyckeObligatorisk.

Hämta händelse via logiskt id

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

Term

VillkorKommentar
Referens till händelseObligatorisk.

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

PatientObligatorisk.Basresurs som hämtningen utgår ifrån
PatientreferensObligatorisk.Basresursens resursid som hämtning utgår ifrån.
Registrerat åtkomstsamtyckeObligatorisk.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ämta händelser via samtycke

Term

Villkor

Kommentar

SamtyckeObligatorisk.Basresurs som hämtningen utgår ifrån
Samtyckes-idObligatorisk.Identitet på den basresurs vars händelser ska returneras
HändelseObligatorisk.Anges för att returnera alla relaterade händelser för en förskrivning

3.3. Hämtade informationsresurser

Informationsresurs Registrerat åtkomstsamtycke - NLLAccessConsent

Se informationspecifikation Registrerat åtkomstsamtycke - NLLAccessConsent

Informationsresurs Åtkomstsamtyckeshändelse - NLLProvenanceConsentAccess

Se informationspecifikation Åtkomstsamtyckeshändelse - NLLProvenanceConsentAccess

3.4. 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å sidaFiltreringsregler. I tabell 8 nedan listas de filtreringsregler som används i den här tillämpningsanvisningen.

Tabell 8 - Filtreringsregler

Filtreringsregel-idRegelnamn
FIL015Filtrering av registrerade åtkomstsamtycken

Filtrering görs även enligt verksamhetsregel VR163.

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.

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

Tabell 9 - Generella verksamhetsregler

Regel-id

Regel namn

VR095Validering av patient i  meddelandehuvud mot patient i anrop
VR096Validering av att efterfrågad resurs tillhör patienten i meddelandehuvud
VR163Informationsfilter vid åtkomst för privatpersonanrop

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.

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

VersionDatumKommentar
1.02022-05-25Ny sida
1.12022-08-15Rättat namn på specialiserad profil vid 1.3 till NLLProvenanceConsentAccess.
1.22022-08-30Rättat namn på händelse till Åtkomstsamtyckeshändelse
1.32022-11-10I avsnitt meddelandehuvud ersatt regler med hänvisning till tillämpningsmönster i Informationsspecifikation meddelandehuvud.
1.42023-11-09Lagt till Möjlig inkluderad resurs i variant 1.1 och sökvillkor Inkludera händelse i tabell 2.