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
- 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 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:
- 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.
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
3.2.1.1. 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 |
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. |
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 |
3.2.1.2.
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
3.2.2.1. Sökning
Tabell 4 - Sökparametrar, hämtning av händelser med referens till samtycke
Term |
Villkor |
Kommentar |
Resursreferens |
Obligatorisk. | De händelser som har angivet samtyckes-id som resursreferens returneras. |
3.2.2.2. 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 |
Obligatorisk. | Anges för att hämta en specifik händelse via dess logiska id. |
3.2.2.3. 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. |
Patient-id | Obligatorisk. |
Id för den specifika Patient-resurs som hämtning ska utgå ifrån. |
Registrerat åtkomstsamtycke | Obligatorisk. |
Anger att förekomster av resurstyp Registrerat åtkomstsamtycke relaterade till angiven patientresurs ska hämtas. |
3.2.2.4. 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. |
Samtyckes-id | Obligatorisk. |
Id för den specifika Consent-resurs som hämtning ska utgå ifrån. |
Händelse | Obligatorisk. |
Anger att förekomster av resurstyp Provenance relaterade till angiven patientresurs ska hämtas. |
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:
- Informationsresurs Registrerat åtkomstsamtycke - NLLAccessConsent. Se informationsspecifikation Registrerat åtkomstsamtycke - NLLAccessConsent
- Informationsresurs Åtkomstsamtyckeshändelse - NLLProvenanceConsentAccess. Se informationsspecifikation Åtkomstsamtyckeshändelse - NLLProvenanceConsentAccess
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
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 | Release | Kommentar |
---|---|---|---|
1.0 | 2022-05-25 | 21.2 | 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 | 21.4 | I avsnitt meddelandehuvud ersatt regler med hänvisning till tillämpningsmönster i Informationsspecifikation meddelandehuvud. |
1.4 | 2023-11-09 | 21.7 | Lagt till Möjlig inkluderad resurs i variant 1.1 och sökvillkor Inkludera händelse i tabell 2. |
1.5 | 2024-08-26 | 21.10 |
|