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

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:

• Patientreferens har hämtats enligt TA 05 – Hämta patientinformation
• Uppgifter har hämtats från Nationella läkemedelslistan för att kunna göra relevanta sökningar och hämtning av resurser, t.ex. resursidentiteter eller referens till ombud.
• För att välja rätt ändamål och åtkomst, se regelverk och vägledning i Ändamål, åtkomsttyper, resurser och behörigheter.

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

Hämta via logiskt id för resurs.

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

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

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

Versionshistorik