TA 12 – Hämta information om patients läkemedelslista


Beskriver olika möjligheter att hämta aggregerad information som finns på en patients läkemedelslista.







1. Verksamhetsbeskrivning

Syftet med denna tillämpningsanvisning är att beskriva olika möjligheter att hämta aggregerad information som finns på en patients läkemedelslista.

Hälso- och sjukvårdspersonal, apotekspersonal samt privatperson kan för olika ändamål och åtkomsttyper få åtkomst till denna information på läkemedelslistan. 

Följande information om en patients läkemedelslista finns på resursen som returneras, men vilka attribut som är synliga beror på behörighetsroll samt valt ändamål och vald åtkomsttyp:

  • läkemedelslisteversion
  • läkemedelsliste-id
  • patientreferens
  • markering om läkemedelslistan innehåller särskilt läkemedel
  • markering om läkemedelslistan innehåller spärrade uppgifter.

1.1. Behörighetsroller

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

  • Hälso- och sjukvårdspersonal
    • Förskrivare
    • Sjuksköterska utan förskrivningsrätt
    • Farmaceut inom hälso- och sjukvård
    • Dietist
  • Expedierande Apotekspersonal
    • Farmaceut
    • Icke-legitimerad apotekspersonal
  • Privatperson
    • Patient
    • Vårdnadshavare
    • Ombud

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.

På sidan Ändamål, åtkomsttyper, resurser och behörigheter finns en beskrivning av giltiga kombinationer av ändamål, åtkomsttyp, resurs och behörighetsroll.

1.3. Resurser 

I tabell 1 nedan listas de informationsresurser, FHIR-resurser och FHIR-profiler som hämtas 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 - Resurser

Informationsresurs

FHIR-Resurs

FHIR-Profil

Anmärkning

Information Läkemedelslista Basic

NLLMedicationListInfo


2. Delfunktion och varianter av tillämpningsanvisningen

2.1. Förkrav

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

2.2. Delfunktion 1: Hämta information om patients läkemedelslista – Vård

Hälso- och sjukvårdspersonal använder relevant åtkomsttyp för ändamålen åstadkomma säker ordination, bereda vård och behandling samt komplettera journal för att hämta övergripande information om en patients läkemedelslista. Exempel på sådan information är om patienten har särskilda läkemedel som har förskrivits inom de senaste 24 månaderna och/eller om de har uppgifter som är spärrade för vården. Resursen Information läkemedelslista har även attributet läkemedelslisteversion som ska användas i system som läser patientens uppgifter i Nationella läkemedelslistan flera gånger under en och samma session. När en patients läkemedelslista skapas får läkemedelslisteversionen nummer 1 och vid varje efterföljande händelse räknas versionsnumret upp med ett. Genom att hämta Information läkemedelslista kan man då avgöra om hämtning av patientens uppgifter behöver göras igen under den pågående sessionen. 

Information läkemedelslista kan sökas med olika sökvillkor eller hämtas med en referens till en resurs.

2.2.1. Variant 1.1 Hämta läkemedelslisteinformation med patientreferens

Krav-ID: 12:1:1.1

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar övergripande information om en patients läkemedelslista med en patientreferens 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 läkemedelslistan.

Berörd resurs: Information läkemedelslista

Returnerad resurs: Information läkemedelslista

Möjlig inkluderad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.2.2. Variant 1.2 Hämta läkemedelslisteinformation med referens (logiskt id) till Information läkemedelslista

Krav-ID: 12:1:1.2

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar övergripande information om en patients läkemedelslista med en referens till Information läkemedelslista (dess logiska id) enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor sökning och hämtning.

Berörd resurs: Information läkemedelslista

Returnerad resurs: Information läkemedelslista

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.3. Delfunktion 2: Hämta information om patients läkemedelslista – Apotek

Apotekspersonal hämtar övergripande information om en patients läkemedelslista. Ett versionsnummer (Läkemedelslisteversion) är det enda som returneras för resursen Information läkemedelslista för de ändamål och åtkomsttyper som är giltiga för apotekspersonal. När en patients läkemedelslista skapas får läkemedelslisteversionen nummer 1 och vid varje efterföljande händelse räknas versionsnumret upp med ett. Ett system som läser patientens uppgifter i Nationella läkemedelslistan flera gånger under samma session kan använda detta versionsnummer för att avgöra om något har ändrats under pågående session och i så fall hämta upp patientens uppgifter igen.

Information läkemedelslista kan sökas med olika sökvillkor eller hämtas med en referens till en resurs.

2.3.1. Variant 2.1 Hämta läkemedelslisteinformation med patientreferens

Krav-ID: 12:2:2.1

Beskrivning av tillämpning

Apotekspersonal hämtar övergripande information om en patients läkemedelslista med en patientreferens 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 läkemedelslistan.

Berörd resurs: Information läkemedelslista

Returnerad resurs: Information läkemedelslista

Möjlig inkluderad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.3.2. Variant 2.2 Hämta läkemedelslisteinformation med referens (logiskt id) till Information läkemedelslista

Krav-ID: 12:2:2.2

Beskrivning av tillämpning

Apotekspersonal hämtar övergripande information om en patients läkemedelslista med en referens till Information läkemedelslista (dess logiska id) enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning.

Berörd resurs: Information läkemedelslista

Returnerad resurs: Information läkemedelslista

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.4. Delfunktion 3: Hämta information om patients läkemedelslista – Privatperson

Privatperson hämtar övergripande information om en patients läkemedelslista. Resursen Information läkemedelslista returnerar för de ändamål och åtkomsttyper som är giltiga för behörighetsroll Privatperson endast ett versionsnummer (Läkemedelslisteversion). När en patients läkemedelslista skapas får läkemedelslisteversionen nummer 1 och vid varje efterföljande händelse räknas versionsnumret upp med ett. Detta versionsnummer kan användas i system som läser patientens uppgifter i Nationella läkemedelslistan flera gånger under en och samma session. Genom att hämta Information läkemedelslista kan man då avgöra om hämtning av patientens uppgifter behöver göras igen under den pågående sessionen.

Information läkemedelslista kan sökas med olika sökvillkor eller hämtas med en referens till en resurs.

2.4.1. Variant 3.1 Hämta läkemedelslisteinformation med patientreferens 

Krav-ID: 12:3:3.1

Beskrivning av tillämpning

Privatperson hämtar övergripande information om en patients läkemedelslista med en patientreferens 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 läkemedelslistan.

Berörd resurs: Information läkemedelslista

Returnerad resurs: Information läkemedelslista

Möjlig inkluderad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.4.2. Variant 3.2 Hämta läkemedelslisteinformation med referens (logiskt id) till Information läkemedelslista

Krav-ID: 12:3:3.2

Beskrivning av tillämpning

Privatperson hämtar övergripande information om en patients läkemedelslista med en referens (logiskt id) till resursen Information läkemedelslista enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning.

Berörd resurs: Information läkemedelslista

Returnerad resurs: Information läkemedelslista

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. 

3.2.1. Information Läkemedelslista

Hämta med patientreferens

Tabell 2- Hämta patients läkemedelslista

Term

Villkor

Kommentar

Patientreferens

Obligatorisk

Logiskt id för patient

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 anges i variant: 1.1, 2.1 och 3.1

Hämta via logiskt id för resurs.

Tabell 3 - Hämta läkemedelslista med logiskt-id

Term

Villkor

Kommentar

Läkemedelsliste-id

Obligatorisk

Logiskt id för Information läkemedelslista. Används endast om man vill hämta en specifik resurs.

3.3. Hämtade informationsresurser

3.3.1. Informationsresurs Information läkemedelslista

Beskrivning av resursen "Information läkemedelslista" finns i informationsspecifikationen Information läkemedelslista – NLLMedicationListInfo.

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 i Ändamål, åtkomsttyper, resurser och behörigheter – Filtreringsregler. 

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 på sidan Generella verksamhetsregler.

Tabell 4 - Generella verksamhetsregler

Regel-id

Regelnamn

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 används i denna tillämpningsanvisning.

4.4. AFF-kontroller och kontrollsamlingar

Vid hämtning av resurser körs inga AFF-kontroller.

5. Presentationskrav

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

Tabell 5 - Presentationskrav

Krav-id

Beskrivning av krav

Krav gäller

12:P.1

Om en patient har spärrat uppgifter ska det tydligt framgå för användare i vården att det finns spärrade uppgifter som inte visas.

Detta gäller inte vid nödåtkomst eller när ett dossamtycke tillämpas för åtkomst, eftersom eventuella spärrade uppgifter ändå visas. 

vård
12:P.2

Det ska framgå för förskrivare av läkemedel om patienten har fått särskilda läkemedel förskrivna de senaste 24 månaderna (dvs. om attributet "Innehåller särskilt läkemedel" = true). Detta ska framgå både när patientens läkemedelslista inte kan visas p.g.a. att patientens samtycke saknas och när patienten givit sitt samtycke (eftersom förskrivningar av särskilda läkemedel kan vara spärrade av patienten och därmed inte visas för förskrivaren).

Detta gäller inte vid nödåtkomst eller när ett dossamtycke tillämpas för åtkomst, eftersom eventuella särskilda läkemedel ändå visas vid dessa åtkomststyper.

vård



Versionshistorik

Version

Datum

Kommentar

1.0 2021-11-27 Ny handbok vård- och apotekstjänster
1.1 2022-06-29 Förtydligat syftet för respektive delfunktion
1.2 2022-11-10

Förbättring av dokumentation:

  • Uppdaterat  kapitel 3.2 Meddelandehuvud med hänvisning till tillämpningsmönster för meddelandehuvud i informationsspecifikation meddelandehuvud.
1.3 2023-11-09

Lagt till "Möjlig inkluderad resurs" i variant 1.1, 2.1 och 3.1. Lagt till "Inkludera händelse" som sökvillkor.

1.4 2024-08-26

Ny verksamhetsregel VR196

Förbättring dokumentation

  • Lagt till verksamhetsregel VR096 och VR095 som saknades i Tillämpningsanvisning
  • Lagt till namn på tabeller samt numrerat om från tabell 2 och framåt