TA 42 – Skapa utdrag – Uthämtade läkemedel

Denna tillämpningsanvisning beskriver hur ett utdrag över uthämtade läkemedel kan skapas, det vill säga skapa en pappersutskrift.





1. Verksamhetsbeskrivning

Syftet med denna tillämpningsanvisning är att beskriva hur ett utdrag, det vill säga en pappersutskrift, skapas för uthämtade läkemedel. Utskriften används för att få en samlad bild av en patients alla uthämtade läkemedel.

Expedierande personal på apotek kan på patientens eller vårdnadshavarens begäran generera en utskrift innehållande patientens uthämtade läkemedel. Detta omfattar även minderåriga patienter i åldern 13–17 år.

En privatperson kan generera samma utskrift via webbtjänster, till exempel via Läkemedelskollen som tillhandahålls av E-hälsomyndigheten.

1.1. Behörighetsroller 

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

  • Farmaceut på apotek
  • Icke-legitimerad apotekspersonal
  • Privatperson

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.

Ändamål, åtkomsttyper, resurser och behörigheter innehåller 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 berörs 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

Patient Patient

NLLPatient


2.  Delfunktion och varianter av tillämpningsanvisningen

Tillämpningsanvisningen föregås av att en person med behörig roll begär en utskrift av en patients uthämtade läkemedel från Nationella läkemedelslistan

  1. Behörig användare anger vilken patient som utskriften avser, i vissa fall även patientens ombud, samt vilket ändamål och vilken åtkomsttyp som åberopas.
  2. Validering av anropet sker enligt angivna valideringsregler.
  3. Systemet genererar och returnerar en utskrift.

2.1. Förkrav

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

Delfunktion 1 – Skapa utdrag för uthämtade läkemedel 

2.1.1. Variant 1.1 Skapa utdrag för uthämtade läkemedel 

Krav-ID: 42:1:1.1

2.1.1.1. Beskrivning

Expedierande apotekspersonal eller privatperson via webbtjänst hämtar en utskrift över en patients uthämtade läkemedel med hjälp av en patientreferens.

  • Vårdnadshavare till en specifik patient vill få information om patientens uthämtade läkemedel. Vårdnadshavaren begär ett utdrag av uthämtade läkemedel från apotekspersonal på ett fysiskt apotek.
  • En privatperson vill få information om sina uthämtade läkemedel. Personen begär ett utdrag av sina uthämtade läkemedel från apotekspersonal på ett fysiskt apotek.
  • Privatperson vill få information om sina uthämtade läkemedel och begär utdrag via en webbtjänst.
  • Vårdnadshavare till en specifik patient under 13 år vill få information om patientens uthämtade läkemedel och begär utdrag via en webbtjänst.


Berörd resurs: Patient

Returnerad resurs: Utdrag (PDF)

3. Hanterad information 

3.1. FHIR-Operation

FHIR-operation  $print-dispenses ska används. Beskrivning av attribut och information om hur anrop utförs beskrivs i informationsspecifikation Skapa utdrag uthämtade läkemedel - $print-dispenses

Tabell 2. Attribut indata skapa utdrag uthämtade läkemedel



Patient-id Obligatoriskt
Från och med-datum

Valfritt att implementera funktionalitet för detta datum. Om datum inte anges blir defaultvärdet 15 månader bakåt från dagens datum.

Till och med-datum Valfritt att implementera funktionalitet för detta datum. Om datum inte anges blir defaultvärdet dagens datum.

3.2. Meddelandehuvud

Information i meddelandehuvudet ska för denna tillämpningsanvisning anges enligt regler tillämpningsmönster i 2.2.2. Hämta med säkerhetsintyg med åtkomsttyp och ändamål i Informationsspecifikation – meddelandehuvud.

Giltig kombination av ändamål och åtkomsttyp anges enligt Giltiga kombinationer privatpersonrelaterade ändamål respektive Giltiga kombinationer apoteksrelaterade ändamål.

3.3. Returnerad information

Utdata från FHIR-operationen $print-dispenses returneras. Utdata attribut i operationen beskrivs i informationsspecifikation  Skapa utdrag uthämtade läkemedel - $print-dispenses.

Tabell 3. Attribut utdata skapa utdrag uthämtade läkemedel

Term

Kommentar

PDF

Returneras vid lyckat anrop

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

Regel-id

Regelnamn

VR163 Informationsfiltrering vid åtkomst från privatperson

4.2. Automatiska kompletteringar 

Inga automatiska kompletteringar finns för denna tillämpningsanvisning.

4.3. Specifika verksamhetsregler 

Verksamhetsregler beskriver validering och verksamhetslogik som E-hälsomyndigheten ansvarar för. 

Tabell 5. Specifika verksamhetsregler

Regel-id

Rubrik

Beskrivning av regel


R001

Visning av gjorda uttag max 15 månader tillbaka Uttag som är gjorda max 15 månader sedan visas på utskriften.  N/A

R002

Sortering av listan Listan sorteras enligt fallande ordning, med senaste uttag först. N/A
R003 Endast uttag för läkemedel visas på utskriften

Endast uttag som avser läkemedel ska visas i utskriften. Hjälpmedel och livsmedel visas inte på utskriften.

N/A
R004 Visning av uttagstyper

Om uttaget är krediterat visas det med överstruken text.

Ett uttag som är backat eller efterregistrerat visas inte.

N/A
R005 Visning av Doseringsanvisning

Information för doseringsanvisning hämtas från förskrivningsversionen som expedierades. Om en uttagsdosering finns visas den istället för förskrivningsversionens dosering

N/A

 

4.4. AFF-kontroller och kontrollsamlingar

Ingen kontrollsamling körs för denna tillämpningsanvisning.

4.5. Valideringsregler

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

Tabell 6. Valideringsregler för denna tillämpningsanvisning

Regel-id

Regelnamn

VAL002 Validering av åtkomsttyp "Vårdnadshavare"
VAL005 Validering av åtkomsttyp "Egna uppgifter"
VAL009 Validering av status på patient för ändamål "Vård", "Direktåtkomst till egna uppgifter" och "Underlättande av läkemedelsanvändning"
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 7. Filtreringsregler för denna tillämpningsanvisning

Regel-id

Regelnamn

FIL011 Filtrering av sekretesspärrad information för vårdnadshavare vid ändamål Direktåtkomst till egna uppgifter
FIL022 Filtrering av förskrivarens information på EES-recept


5. Presentationskrav

Inga specifika presentationskrav finns för denna tillämpningsanvisning.

6. Exempel av utskriften

Det finns exempel på hur utskriften kan se ut på sidan Utskrifter och läsanvisningar.


Versionshistorik

Version

Datum

Release

Kommentar

1.0 2021-11-27
Ny handbok vård- och apotekstjänster
1.1 2022-03-30
Uppdaterat R005
1.2 2022-11-10


Förbättringar dokumentation

  • Kapitel 3.1 FHIR-Operation, uppdaterat
  • Kapitel 3.2 Meddelandehuvud, uppdaterat
  • Kapitel 3.3 Returnerad information, uppdaterat
  • I avsnitt meddelandehuvud ersatt regler med hänvisning till tillämpningsmönster i Informationsspecifikation meddelandehuvud.
  • Kapitel 4.3 Specifika verksamhetsregler, lagt till kolumn för felkod och felmeddelande
1.3 2023-11-09


Lagt till inparametrar Från och med-datum och Till och med-datum

1.4 2024-08-26


Förtydligat villkor på inparametrar Från och med-datum och Till och med-datum

1.5 2025-02-13 21.12
  • Lagt till befintlig regel VR163 som saknades.

Ändringar pga omstrukturering av filtreringsregler:

  • FIL011 tillagd. 
  • FIL008 samt FIL009 borttagna då de regler som påverkar detta TA nu ingår i FIL011.
1.6 2025-04-29 21.13
  • Språklig justering av sidans inledande text
  • Filtreringsregler flyttat in under avsnitt 4. Regler och kontroller.
  • Avsnitt 4.5 Valideringsregler tillagt under avsnitt 4. Regler och kontroller. VAL013 som beskriver en befintlig validering har lagts till.
  • Referens tillagd till information om giltiga kombinationer av ändamål och åtkomsttyp under avsnitt 3.2 Meddelandehuvud.
  • Omformulering under förkrav, samt Resurs vårdnadshavare borttagen då hantering av vårdnadshavare inte ingår i denna tillämpningsanvisning.
  • Språkliga justeringar i tabell 5, samt borttag av kolumn "anmärkning".
1.7 2025-11-06
Korrigerat fel i beskrivningen av R004, efterregistrerade uttag visas inte på utskriften.