TA 38 – Hämta Spärr

Denna tillämpningsanvisning beskriver hur vård och apotek kan söka och hämta olika typer av spärrar i Nationella läkemedelslistan.







1. Verksamhetsbeskrivning

Denna tillämpningsanvisning beskriver hur vårdpersonal och apotekspersonal kan söka och hämta spärrar i Nationella läkemedelslistan (NLL). Mer information om spärrar i Nationella läkemedelslistan finns på sidan Direktåtkomst, samtycken, spärrar och fullmakter i Nationella läkemedelslistan.

Spärrar används för att dölja viss information i NLL, om spärrad information döljs vid hämtning beror på:

  • Typ av spärr: Sekretess- eller integritetsspärr
  • Behörighetsroll
  • Ändamål
  • Åtkomsttyp

1.1. Sekretesspärr

En sekretesspärr kan skapas av en förskrivare av läkemedel efter att en sekretessprövning har gjorts. Det finns två varianter:

1. Sekretesspärr för vårdnadshavare

  • Gäller antingen en förskrivningskedja och dess uttag, eller samtliga uttag på pappersrecept.
  • Döljer all information i de aktuella förskrivningarna/uttagen för vårdnadshavaren, barnet och eventuella ombud.

2. Sekretesspärr för patient

  • Gäller behandlingsorsak inom en förskrivningskedja.
  • Döljer denna information för patienten själv och eventuella ombud.

Syftet med att hämta sekretesspärrar är att:

  • Visa om en sekretesspärr för vårdnadshavare finns, så att apotek och vårdpersonal vet att information inte får röjas.
  • Visa för behörig personal om en behandlingsorsak är sekretesspärrad så informationen inte röjs för patienten.
  • Visa om och vilka sekretesspärrar som finns på en patients förskrivningar för att ge förskrivare information inför en eventuell hävning av spärr.

När en sekretesspärr hämtats ska information om den visas kopplat till den förskrivningskedja eller de uttag på pappersrecept som spärren gäller. På så sätt kan spärren visas när personal i vården och på apotek tittar på patientens information i Nationella läkemedelslistan. 

1.2. Integritetsspärrar

En integritetsspärr är en integritetshöjande åtgärd som patienten själv kan vidta för att skydda sin information vid direktåtkomst. Det finns två varianter. Den första är en integritetsspärr som döljer information gentemot hälso- och sjukvårdspersonalens ändamål för direktåtkomst samt för apotekspersonalens ändamål underlättande av patients läkemedelsanvändning. Den andra varianten är spärr av behandlingsorsak gentemot apotekspersonalens ändamål expediering.

1. Integritetsspärr för ändamål vård och underlättande av patients läkemedelsanvändning

  • Gäller antingen en förskrivningskedja och dess uttag eller samtliga uttag på pappersrecept.
  • Döljer all information i de aktuella förskrivningarna/uttagen.

Vårdpersonal kan hämta information om patientens integritetsspärrar om en åtkomsttyp som ger tillgång till spärrad information används, dvs vid dossamtycke, nödåtkomst eller om patienten gett ett tillfälligt samtycke att se spärrade uppgifter. Syftet är att vårdpersonal ska kunna se vilka uppgifter patienten anser vara känsliga, så att dessa hanteras varsamt och inte sprids i onödan, t.ex. i journaler eller intern kommunikation.

Apotekspersonal kan inte hämta integritetsspärrar för förskrivningar och uttag.

2. Integritetsspärr för ändamål expediering

  • Gäller information om behandlingsorsak på alla förskrivningar i en förskrivningskedja.

Apotekspersonal kan inte hämta integritetsspärrar för behandlingsorsak.

1.3. Behörighetsroller

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

  • Förskrivare
  • Sjuksköterska
  • Dietist
  • Farmaceut inom hälso- och sjukvård
  • Farmaceut på apotek
  • Icke-legitimerad apotekspersonal

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

1.4. 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.5. Resurser 

I tabell 1 nedan listas de informationsresurser, FHIR-resurser och FHIR-profiler som ska användas för 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. Resurser

Resurs

FHIR-Resurs

FHIR-Profil

Spärr

Basic

NLLDataLock

Spärrhändelse

Provenance

NLLProvenanceDataLock
Patient Patient

NLLPatient

Personal

Practitioner

NLLPractitioner

 

2. Delfunktion och varianter i tillämpningsanvisningen

2.1. Förkrav

Innan delfunktioner i denna tillämpningsanvisnings kan tillämpas måste följande krav vara uppfyllda:

Apotek och vård:

Vård:

Apotek:

2.2. Delfunktion 1 – Hämta spärr 

Hälso- och sjukvårdspersonal eller apotekspersonal använder relevant åtkomsttyp för angivet ändamål för att hämta spärr.

Hälso- och sjukvårdspersonal har även möjlighet att för vissa åtkomsttyper hämta integritetspärrar.

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

Den här delfunktionen beskriver hur man hämtar information om spärr för:

  • expedierande apotekspersonal
  • behörig vårdpersonal som tar del av läkemedelslistan
  • förskrivare som ska häva sekretesspärr.

2.2.1. Variant 1.1 Hämta spärr på förskrivningskedje-id eller patientreferens 

Krav-ID: 38:1:1.1

2.2.1.1. Beskrivning av tillämpning

Hälso- och sjukvårdspersonal eller apotekspersonal hämtar spärrar enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning. Vid hämtningen är det möjligt att inkludera den händelse som tillhör den returnerade versionen av spärren.

Berörd resurs: Patient, spärr

Returnerad resurs: Spärr

Möjlig inkluderad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.2.2. Variant 1.2 Hämta spärr med logiskt id

Krav-ID:  38:1:1.2

2.2.2.1. Beskrivning av tillämpning

Hälso- och sjukvårdspersonal eller apotekspersonal hämtar en spärr med hjälp av spärr-id (logiskt id på spärr) enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning.

Berörd resurs: Spärr

Returnerad resurs: Spärr

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.2.3. Variant 1.4 Hämta versioner av en spärr

Krav-ID: 38:1:1.4

2.2.3.1. Beskrivning av tillämpning

Hälso- och sjukvårdspersonal eller apotekspersonal hämtar en eller alla versioner av en spärr med det logiska id:t för spärren enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Hämta versioner av en spärr.

Berörd resurs: Spärr

Returnerad resurs: Spärr

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.3. Delfunktion 2 – Hämta händelser för spärr

Hälso- och sjukvårdspersonal eller apotekspersonal använder relevant åtkomsttyp för angivet ändamål för att hämta händelser för en spärr. 

Spärrhändelse kan hämtas med spärr-id.

Den här delfunktionen beskriver hur man hämtar information om spärr för:

  • expedierande apotekspersonal
  • behörig vårdpersonal som tar del av läkemedelslistan
  • förskrivare som ska häva sekretesspärr.

2.3.1. Variant 1.1 Hämta spärrhändelser för spärr

Krav-ID:  38:2:1.1

2.3.1.1. Beskrivning av tillämpning

Hälso- och sjukvårdspersonal eller apotekspersonal hämtar händelser för en spärr med hjälp av spärr-id (logiskt id på spärr) enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Hämta händelser tillhörande en resurs.

Berörd resurs: Spärr

Returnerad resurs: Spärrhändelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.3.2. Variant 1.2 Hämta enskild händelse för spärr

Krav-ID: 38:2:1.2

2.3.2.1. Beskrivning av tillämpning

Hälso- och sjukvårdspersonal eller apotekspersonal hämtar en specifik händelse för en spärr enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Hämta händelse med logiskt id.

Berörd resurs: Händelse

Returnerad resurs:  Händelse

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

Ändamål och åtkomst anges enligt kombination för resursen spärr/spärrhändelse för mer information se

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. 

För teknisk information om sökning och hämtning, se avsnittet "Query Operations" för respektive resurs i  Simplifier Guide för Nationella läkemedelslistan

3.2.1. Spärr

3.2.1.1. Sökparametrar 

Tabell 2. Sökparametrar spärr

Term

Villkor

Kommentar

Förskrivningskedje-id

Obligatorisk Förskrivningskedje-id eller Patientreferens måste anges

Patientreferens

Obligatorisk

Valideras enligt VR095 och VR096

Förskrivningskedje-id eller Patientreferens måste anges

Spärrorsak

Valfri

Spärrad uppgift

Valfri


Spärrstatus

Valfri

Inkludera händelse

Valfri

Anges när man vill 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 spärr på förskrivningskedje-id eller patientreferens.

3.2.1.2. Hämta spärr med logiskt id

Tabell 3. Hämta med logiskt-id

Term

Villkor

Kommentar

Spärr-id

Obligatoriskt

3.2.1.3. Hämta versioner av en spärr

Tabell 4. Hämta versioner av spärr

Term

Villkor

Kommentar

Spärr-id

Obligatoriskt
Historik Valfri

_history

Används för att hämta alla versioner av en spärr

Version Valfri

_history/"version"

Används för att hämta en specifik version av en spärr

3.2.1.4. Hämta version av spärr kopplad till händelse

Tabell 5. Hämta med händelse-id

Term

Villkor

Kommentar

Händelse-id

Obligatoriskt

3.2.2. Händelse – sökparametrar

3.2.2.1. Hämta händelser tillhörande en resurs

Tabell 6.

Term

Villkor

Kommentar

Resursreferens

Obligatorisk

Logiskt id till den resurs vars händelser ska hämtas.
Händelsetyp

Valfri

Endast en kod. Används för att hämta samtliga händelser av en viss händelsetyp för angivet logiskt id.

3.2.2.2. Hämta händelse med logiskt id

Tabell 7. Hämta händelser

Term

Villkor

Kommentar

Händelse-id

Obligatorisk

Logiskt id till den händelse som ska hämtas.

3.3. Hämtade informationsresurser

3.3.1. Informationsresurs Spärr

Beskrivning av resursen "Spärr" finns i informationsspecifikationen Spärr – NLLDatalock.

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

VR024 Definition Förskrivare av läkemedel
VR025 Validering av anropande apotek mot EXPO

VR095

Validering av patient i meddelandehuvud mot patient i sökvillkor

VR096

Validering av att efterfrågad resurs tillhör patienten i meddelandehuvud

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 resurser körs inga AFF-kontroller.

4.5. Valideringsregler

Valideringsregler beskriver validering vid hämtning av information från Nationella läkemedelslistan. Alla regler finns beskrivna på sidan Valideringsregler.

Tabell 9. Valideringsregler för denna tillämpningsanvisning

Regel-id Regelnamn
VAL001 Validering av åtkomsttyp "Åtkomst till dospatients uppgifter"    
VAL006 Validering av åtkomsttyp "Nödåtkomst"
VAL009 Validering av status på patient för ändamål "Vård", "Direktåtkomst till egna uppgifter" och "Underlättande av läkemedelsanvändning"    
VAL010 Validering av status på patient för ändamål "Expediering"    
VAL011 Validering av registrerat åtkomstsamtycke patient till vårdpersonal
VAL013 Giltig kombination av ändamål, åtkomsttyp och behörighetsroll

4.6. Filtreringsregler

Filtreringsregler beskriver filtrering av uppgifter vid hämtning av information från Nationella läkemedelslistan. Alla regler finns beskrivna på sidan Filtreringsregler

Tabell 10. Filtreringsregler för denna tillämpningsanvisning

Regel-id

Regelnamn

FIL017 Maskning av information för patient med skyddade personuppgifter
FIL020 Filtrering av sekretesspärr
FIL021 Filtrering av integritetsspärr
FIL023 Filtrering av apotekspersonals namn    

5. Presentationskrav

Följande presentationskrav gäller vid visning av information som hämtas enligt denna tillämpningsanvisning.

Tabell 10 - presentationskrav 

Krav-id

Beskrivning av krav

Krav gäller

38:P.1 
  • För apotek är det valfritt att visa övrig information än det som anges i krav 38:P.3 och 38:P.4 från resursen spärr för användare. Om information visas ska bara aktiva spärrar visas och i enlighet med presentationskraven i informationsspecifikation Spärr – NLLDatalock.
  • Vid presentation av information från resursen spärr ska information från resursen spärrhändelse också visas. Se presentationskrav i informationsspecifikation Spärrhändelse – NLLProvenanceBasicDataLock
apotek
38:P.2 

För vården är det obligatoriskt att visa aktiv sekretesspärr och dess spärrhändelse för användare i enlighet med presentationskraven i informationsspecifikation Spärr – NLLDatalock och Spärrhändelse – NLLProvenanceBasicDataLock

Det är valfritt att visa inaktiv (hävd) sekretesspärr, men om den visas ska även spärrhändelsen visas.

Det är valfritt att hämta aktiva integritetsspärrar för åtkomsttyper som ger tillgång till spärrad information för att kunna markera vilka uppgifter som patienten spärrat. Inaktiv (hävd) integritetsspärr ska inte visas.

vård
38:P.3

Vid presentation av förskrivningar och dess uttag samt uttag gjorda på pappersrecept ska uppgift, om den har en aktiv sekretesspärr, markeras tydligt så att det framgår för användaren att uppgiften är spärrad för direktåtkomst för vårdnadshavare eller annat ombud för patienten. Markering ska finnas i både översiktsvy och detaljerad vy.

Det är valfritt för vård att med hjälp av hämtade aktiva integritetsspärrar markera vilka uppgifter som patienten spärrat.

vård

apotek

38:P.4

Vid presentation av en förskrivning där behandlingsorsak har sekretesspärr ska det markeras att behandlingsorsaken är spärrad gentemot patienten.

vård

apotek

38:P.5 Det är inte tillåtet att hämta och visa spärr och spärrhändelse.

e-handel



Versionshistorik

Version

Datum

Release

Kommentar

1.0 2021-11-27 21.0 Ny handbok vård- och apotekstjänster
1.1 2022-06-29 - Rättning av sökparameter i enlighet med informationsspecifikation för "Spärr"  från "Spärrtyp" till "Spärrorsak".
1.2 2022-11-10 21.4 I avsnitt meddelandehuvud ersatt regler med hänvisning till tillämpningsmönster i Informationsspecifikation meddelandehuvud.
1.3 2023-05-04

21.5

Revidering av presentationskrav efter översyn av verksamhetsflöde Läsåtkomst, vård:

  • 38:P.2 - kravet justerat så att det endast är obligatoriskt att visa aktiv sekretesspärr och dess spärrhändelse samt att det är valfritt att hämta aktiva integritetsspärrar
    • Kompletterat med att det är valfritt att hämta aktiva integritetsspärrar för åtkomsttyper som ger tillgång till spärrad information för att kunna markera vilka uppgifter som patienten spärrat.

Förtydligande:

  • 38:P.1 - förtydligat krav, ingen ändring av innehåll.

Reviderad och tillagd beskrivning att det är möjligt från 21.5 för ändamålet Vård att hämta aktiva integritetsspärrar för åtkomsttyper som ger tillgång till spärrad information. 

Ensning av termer i Spärrhändelse med Händelser till Händelse-id och Resursreferens.

1.4 2023-09-14 - Språklig förbättring 38:P.4
1.5 2023-11-09 21.7 Uppdaterat variant 1.1 med Möjlig inkluderad resurs samt lagt till sökvillkor Inkludera händelse i tabell 2.
1.6 2024-02-22 21.8 Uppdaterat Filtreringsregler, nu visas de regler som gäller vid hämtning av resursen Spärr + spärrhändelse
1.7 2024-08-26

21.10

Förändringar till release 21.10:

  • Ny regel VR196 metUppdaterat variant 1.1 med Möjlig inkluderad resurs samt lagt till sökvillkor Inkludera händelse i tabell 2.adata testresurs
1.8 2025-02-12

21.12

Uppdatering dokumentation:

  • Behörighetsroll Sjuksköterska utan förskrivningsrätt har ny benämning sjuksköterska..
1.9 2025-04-29

21.13

Uppdateringar dokumentation

  • Lagt till kapitel 4.5 som beskriver  valideringsregler som används i den här tillämpningsanvisningen. 
  • Lagt till filtreringsreglerna  FIL017 och FIL023
  • Förtydligat hur ändamål och åtkomst ska anges under kapitel 3.1 Meddelandehuvud
1.10 2026-05-20

21.17

  • Språklig översyn av texten i inledande avsnitt 1. Verksamhetsbeskrivning.
  • 38:P.2 förtydligat att en inaktiv (hävd) integritetsspärr inte ska visas.