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
- Förskrivare
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-Profil | Anmärkning |
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:
- Patientreferens har hämtats enligt TA 05 – Hämta patientinformation
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. |
Samtyckestyp | Obligatorisk. | Endast registrerade åtkomstsamtycken av angiven typ returneras. "INFA" - Information access representerar registrerade åtkomstsamtycken. |
Samtyckestagare | Obligatorisk. | 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 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 samtycke | Obligatorisk. |
Hämta händelse via logiskt id
Tabell 5 - Sökparametrar, hämtning av händelse med referens till händelse
Term | Villkor | Kommentar |
Referens till händelse | Obligatorisk. |
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. | Basresurs som hämtningen utgår ifrån |
Patientreferens | Obligatorisk. | Basresursens resursid som hämtning utgår ifrån. |
Registrerat åtkomstsamtycke | Obligatorisk. | 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 |
---|---|---|
Samtycke | Obligatorisk. | Basresurs som hämtningen utgår ifrån |
Samtyckes-id | Obligatorisk. | Identitet på den basresurs vars händelser ska returneras |
Händelse | Obligatorisk. | 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å sidan Filtreringsregler. I tabell 8 nedan listas de filtreringsregler som används i den här tillämpningsanvisningen.
Tabell 8 - Filtreringsregler
Filtreringsregel-id | Regelnamn |
---|---|
FIL015 | Filtrering 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 |
---|---|
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 |
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
Fö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. |