Denna tillämpningsanvisning beskriver olika möjligheter för att hämta en patients förskrivningar och historik (versioner, händelser och förskrivningskedjor), uttag kopplade till dessa förskrivningar, samt uttag gjorda på pappersrecept.

1. Verksamhetsbeskrivning

Syftet med denna tillämpningsanvisning är att beskriva olika möjligheter för att hämta en patients förskrivningar och historik (versioner, händelser och förskrivningskedjor), uttag kopplade till dessa förskrivningar, samt uttag gjorda på pappersrecept.

Hälso- och sjukvårdspersonal kan med patients samtycke eller i vissa situationer där patienten är oförmögen att lämna samtycke, få åtkomst till patientens information i Nationella läkemedelslistan.

Följande ändamål är tillämpliga för att få tillgång till informationen:

• åstadkomma säker ordination
• bereda vård och behandling
• komplettera journal.

Åtkomst ges till följande information:

• Förskrivningar och dess uttag
• Förskrivningshistorik
• Uttag på pappersrecept (uttag utan referens till förskrivning).

1.1. Behörighetsroller 

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

• Förskrivare
• Sjuksköterska utan förskrivningsrätt
• Farmaceut inom hälso- och sjukvård
• Dietist.

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 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

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
• Relevanta uppgifter som krävs för önskad sökning eller hämtning ska ha hämtas i Nationella läkemedelslistan. Exempelvis en resursidentitet eller referens till ombud. Se krav för sökvillkor under sökning och hämtning.
• 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 patients förskrivningar

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 få åtkomst till patients förskrivningar och uttag.

Förskrivningar kan sökas med olika sökvillkor eller hämtas med en referens till det logiska id:t för förskrivningen.

Variant 1.1 Hämta förskrivningar med patientreferens eller förskrivnings-id

Krav-ID: 15:1:1.1

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar den senaste versionen av en patients förskrivningar med en Patientreferens eller ett förskrivnings-id 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 uttag och den händelse som tillhör den returnerade versionen av förskrivningen.

Berörd resurs: Förskrivning, Patient

Returnerad resurs: Förskrivning

Möjlig inkluderad resurs: Uttag, Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

Variant 1.2 Hämta versioner av en förskrivning

Krav-ID: 15:1:1.2

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar en eller alla versioner av en förskrivning med ett förskrivnings-id enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Hämta versioner av en förskrivning.

Berörd resurs: Förskrivning

Returnerad resurs: Förskrivning

Resurser som returneras beskrivs i Hämtade informationsresurser.

Variant 1.3 Hämta förskrivningar via en händelse

Krav-ID: 15:1:1.3

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar en eller flera förskrivningar via en händelse enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning för händelse, Hämta förskrivningar via händelse. Den version av förskrivningen som händelsen tillhör returneras. Vid hämtningen är det möjligt att inkludera uttag och och den händelse som tillhör den returnerade versionen av förskrivningen.

Berörd resurs: Händelse

Returnerad resurs: Förskrivning

Möjlig inkluderad resurs: Uttag, Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

Variant 1.4 Hämta förskrivningar i en förskrivningskedja

Krav-ID: 15:1:1.4

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar förskrivningar som tillhör samma förskrivningskedja enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning för förskrivningar. Den senaste versionen av varje förskrivning i kedjan returneras. Vid hämtningen är det möjligt att inkludera uttag och den händelse som tillhör varje returnerad version av en förskrivning.

Berörd resurs: Förskrivning

Returnerad resurs: Förskrivning

Möjlig inkluderad resurs: Uttag, Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

Variant 1.7 Hämta förskrivningar med förskrivningsidentiteter

Krav-ID: 15:1:1.7

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal kan hämta förskrivningar med förskrivningsidentiteter som angivits via Nationellt e-receptformat (NEF) som sökparametrar (originalordinations-id, produktradnummer, radnummer) eller ett OR-ordinations-id med angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning. Den senaste versionen av förskrivningen returneras. Vid hämtningen är det möjligt att inkludera uttag och den händelse som tillhör den returnerade versionen av förskrivningen.

Berörd resurs: Förskrivning

Returnerad resurs: Förskrivning

Möjlig inkluderad resurs: Uttag, Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser

2.3. Delfunktion 2 - Hämta händelser för en förskrivning

I denna delfunktion beskrivs hur användare kan komplettera sin åtkomst till en patients förskrivningar med ytterligare information om historik för en förskrivning.

Informationen inkluderar händelser associerade till förskrivningen.

Variant 2.1 Hämta händelser via en förskrivning

Krav-ID: 15:2:2.1

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar händelser för en förskrivning enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Hämta händelser för en förskrivning.

Berörd resurs: Förskrivning

Returnerad resurs:  Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

Variant 2.2 Hämta enskild förskrivningshändelse

Krav-ID: 15:2:2.2

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar en specifik händelse för en förskrivning 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.

2.4. Delfunktion 3 – Hämta uttag

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 få åtkomst till uttag kopplade till en patient eller uttag tillhörande en viss förskrivning. Det går även att hämta ett specifikt uttag med ett logiskt id till resursen.

Variant 3.1 Hämta uttag via en förskrivning

Krav-ID: 15:3:3.1

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar uttag via en förskrivning enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning. Den senaste versionen av varje uttag returneras. Vid hämtningen är det möjligt att inkludera den händelse som tillhör den returnerade versionen av uttaget.

Berörd resurs: Förskrivning

Returnerad resurs: Uttag

Möjlig inkluderad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

Variant 3.2 Hämta en patients alla uttag via referens till patient

Krav-ID: 15:3:3.2

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar alla uttag för en viss patient enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning. Den senaste versionen av varje uttag returneras. Vid hämtningen är det möjligt att inkludera den händelse som tillhör den returnerade versionen av uttaget.

Berörd resurs: Patient

Returnerad resurs: Uttag, Uttag pappersrecept

Möjlig inkluderad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

Variant 3.3 Hämta uttag via logiskt id till uttag

Krav-ID: 15:3:3.3

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar ett uttag via en referens till uttaget enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning. Den senaste versionen av uttaget returneras.

Berörd resurs: Uttag, Uttag pappersrecept

Returnerad resurs: Uttag, Uttag pappersrecept

Resurser som returneras beskrivs i Hämtade informationsresurser.

Variant 3.4 Hämta uttag pappersrecept för en patient eller med logiskt id för uttag pappersrecept

Utgått, inkluderas i stället i Variant 3.2 och 3.3.

Variant 3.5 Hämta versioner av ett uttag

Krav-ID: 15:3:3.5

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar en specifik version eller alla versioner av ett uttag eller uttag pappersrecept med uttagets logiska id enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Hämta versioner av ett uttag.

Berörd resurs: Uttag, Uttag pappersrecept

Returnerad resurs: Uttag, Uttag pappersrecept

Resurser som returneras beskrivs i Hämtade informationsresurser.

Variant 3.6 Hämta uttag för en lista av förskrivningar

Krav-ID: 15:3:3.6

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar uttag för flera förskrivningar genom att ange en lista av förskrivnings-id:n enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning. Den senaste versionen av varje uttag returneras. Vid hämtningen är det möjligt att inkludera den händelse som tillhör den returnerade versionen av uttaget.

Berörd resurs: Förskrivning

Returnerad resurs: Uttag

Möjlig inkluderad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.5. Delfunktion 4 - Hämta händelser för uttag

I denna delfunktion beskrivs hur användare kan komplettera sin åtkomst till uttag med ytterligare information om händelser associerade till uttaget.

Variant 4.1 Hämta händelser via ett uttag

Krav-ID: 15:4:4.1

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar händelser för ett uttag eller uttag pappersrecept enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Hämta händelser för ett uttag.

Berörd resurs: Uttag, Uttag pappersrecept

Returnerad resurs:  Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

Variant 4.2 Hämta enskild uttagshändelse

Krav-ID: 15:4:4.2

Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar en specifik händelse för ett uttag eller ett uttag pappersrecept 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  Informationsspecifikation – meddelandehuvud.

3.2. Sökning och hämtning per resurs

Här anges sökparametrar och hämtningar via logiska id som returnerar olika resurser.

Se Simplifier Guide för Nationella läkemedelslistan för teknisk information om sökning och hämtning kan ske.

Förskrivning – sökparametrar

Sökning på förskrivningar med patient med personnummer 

Tabell 2

Sökning på tidigare förskrivningsidentiteter (NEF och OR)

Tabell 3

Sök förskrivningar med logiskt id på en händelse

Tabell 4 

Förskrivning – Hämta via logiskt id

Hämta senaste version med logiskt id

Tabell 5

Hämta versioner av en förskrivning

Tabell 6

Förskrivning – Hämta förskrivningar via annan resurs

Här beskrivs hur hämtning av förskrivningar kan ske genom att ange en annan basresurs som hämtningen utgår från. Sökningen returnerar förskrivningar som är relaterade till angiven resurs.

För mer information - se Compartment searches i  Simplifier Guide för Nationella läkemedelslistan.

Hämta förskrivningar via en händelse 

Tabell 7

Hämta förskrivningar via patientresurs

Tabell 8

Hämta förskrivningar via en patientresurs med sökparametrar

Detta är en sökvariant av sökning via patientresurs som beskrivs i tabell 8 ovan, här beskrivs möjligheten att komplettera sökningen med ytterligare sökparametrar.

Tabell 9

Händelse – sökparametrar

Hämtning av händelser tillhörande en resurs

Tabell 10 

Händelse – hämtning med logiskt id

Tabell 11

Händelser – hämta händelser via annan resurs 

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 12

Uttag – sökparametrar

Sökning på uttag och/eller uttag pappersrecept tillhörande en viss patient eller en viss förskrivning

Tabell 13

Uttag – Hämta

Hämta senaste versionen av ett uttag/uttag pappersrecept via logiskt id

Tabell 14 

Hämta versioner av ett uttag/uttag pappersrecept

Tabell 15

Uttag – hämta uttag via annan resurs

Här beskrivs hur hämtning av uttag kan ske genom att ange en annan basresurs som hämtningen utgår från. Sökningen returnerar uttag som är relaterade till angiven resurs.

För mer information - se Compartment searches i  Simplifier Guide för Nationella läkemedelslistan.

Hämta uttag via en förskrivning

Tabell 16 

3.3. Hämtade informationsresurser

Informationsresurs Förskrivning

Beskrivning av resursen "Förskrivning" finns i informationsspecifikationen Förskrivning – NLLMedicationRequest.

Informationsresurs Händelse

Beskrivning av resursen "Händelse" finns i informationsspecifikationen Händelse – NLLProvenance.

Informationsresurs Personal

Beskrivning av resursen "Personal" finns i informationsspecifikationen Personal – NLLPractitioner.

Informationsresurs Uttag

Beskrivning av resursen "Uttag" finns i informationsspecifikationen Uttag – NLLMedicationDispense.

Informationsresurs Uttag pappersrecept

Beskrivning av resursen "Uttag pappersrecept" finns i informationsspecifikationen Uttag pappersrecept – NLLDispensePaperPrescription.

Informationsresurs Dosering

Vid förskrivning av läkemedel och teknisk sprit är dosering obligatoriskt och valideras i AFF-kontroller. Se detaljerad information om doseringsparametrar och regler kring dosering i TA 22 – Dosering och administreringssätt samt TA 21 – Doseringsanvisning.

Om uttag saknar dosering ska expedierad dosering hämtas från den förskrivningsversion som uttaget refererar till.

Beskrivning av resursen "Dosering" finns i informationsspecifikationen Dosering – NLLDosage.

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 på sidan Filtreringsregler. I tabell 17 nedan listas de filtreringsregler som används i den här tillämpningsanvisningen.

Tabell 17

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.

I tabell 18 nedan listas de generella verksamhetsregler som används i den här tillämpningsanvisningen.

För beräknade värden se informationsspecifikation för resurs samt verksamhetsregler.

Tabell 18

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

AFF-kontroller (automatiska format- och författningskontroller) är valideringar som säkerställer kvaliteten på informationen i Nationella läkemedelslistan. AFF-kontrollerna och kontrollsamlingarna beskrivs detaljerat på sidan Automatiska format- och författningskontroller (AFF-kontroller).

Vid hämtning av resurser körs AFF-LÄS för förskrivningar. Se Krav på anropsresultat och felhantering.

5. Presentationskrav

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

En beskrivning av respektive verksamhetsflöde hittar du via sidorna Förskrivning, patient utan dossamtycke, Förskrivning, patient med dossamtycke (dospatient) och Läsåtkomst, vård.

Tabell 19 - presentationskrav 

Krav-id	Beskrivning av krav	Kommentar	Krav gäller för verksamhetsflöde
15:P.1	Anslutande system ska kunna visa förskrivningshistorik för användaren. Det innebär att: Samtliga förskrivningskedjor för en patient ska kunna visas. När en förskrivningskedja visas ska samtliga förskrivningar och förskrivningsversioner som ingår i förskrivningskedjan kunna visas, och det ska framgå för användaren hur de förhåller sig till varandra inom kedjan. För varje förskrivningsversion ska det gå att se information om den händelse* som är kopplad till versionen.	Kravet ska vara uppfyllt under andra halvåret 2028 för:  Förskrivning, patient utan dossamtycke Förskrivning, patient med dossamtycke (system som endast har funktionalitet för helförpackning)	Förskrivning, patient med dossamtycke (dospatient) - för system med full dosfunktionalitet
15:P.2	Anslutande system ska kunna visa uttag för användaren. Det innebär att: Senaste versionen av patientens samtliga uttag med uttagsstatus "Expedierad" ska kunna visas. Gäller både uttag och uttag pappersrecept. Att visa händelser för dessa uttag är valfritt.  Det är valfritt att visa tidigare versioner av uttaget. Det är valfritt att visa uttag med uttagsstatus "Borttaget". Gäller både uttag och uttag pappersrecept. Om dessa uttag visas ska det framgå vilka uttag som är expedierade respektive borttagna (backade eller krediterade) samt tillhörande händelse.	Om händelsen inte visas kan användaren inte se vilket apotek som expedierat uttaget. På händelser för uttag med uttagsstatus "Borttaget" finns en beskrivning av händelseorsaken som är viktig att kunna se (obligatorisk att ange på krediterade uttag, valfritt på backade uttag).	Förskrivning, patient utan dossamtycke Förskrivning, patient med dossamtycke (dospatient)
15:P.3	Följande informationsspecifikationer innehåller ytterligare presentationskrav som gäller när respektive resurs visas. Kraven specificerar vilka attribut som är obligatoriska respektive valfria att presentera för användaren, samt presentationskrav som är direkt knutna till värden för vissa attribut: Förskrivning – NLLMedicationRequest Uttag – NLLMedicationDispense Uttag pappersrecept – NLLDispensePaperPrescription Händelse – NLLProvenance Personal – NLLPractitioner		Förskrivning, patient utan dossamtycke Förskrivning, patient med dossamtycke (dospatient) Läsåtkomst, vård
15:P.4	Urval och vyer som inkluderar förskrivningar med förskrivningsstatus Aktiv ska även inkludera förskrivningsstatus Parkerad. Även parallella förskrivningar med status Slutexpedierad ska inkluderas enligt 15:P.5.		Förskrivning, patient utan dossamtycke Förskrivning, patient med dossamtycke (dospatient) Läsåtkomst, vård
15:P.5	När det finns parallella förskrivningar, det vill säga två förskrivningar i samma förskrivningskedja som har någon av statusarna aktiv, parkerad eller slutexpedierad, ska det i en översiktsvy tydligt framgå att förskrivningarna hör ihop. De parallella förskrivningarna får inte separeras vid till exempel en annan sortering av läkemedelslistan. När en förskrivning är parallell ska detta även framgå i detaljvyer där förskrivningen visas eller hanteras.		Förskrivning, patient utan dossamtycke Förskrivning, patient med dossamtycke (dospatient) Läsåtkomst, vård
15:P.6	Senaste versionen av patientens alla förskrivningar samt tillhörande händelse* ska visas. Alla förskrivningar i patientens Nationella läkemedelslista ska vara möjliga att se, men alla behöver inte visas i samma vy.  Visning av förskrivningskedjor, förskrivningsversioner  och uttag är valfritt men rekommenderas.  Om förskrivningskedjor visas gäller krav 15:P.1. Om förskrivningsversioner visas gäller krav 15:P.1. Om uttag visas gäller krav 15:P.2.	E-hälsomyndigheten rekommenderar visning av uttag, förskrivningsversioner och förskrivningskedjor eftersom: Förskrivningar som ingår i en förskrivningskedja kan hållas samman för att kunna visa historik på ett användarvänligt sätt.  Versioner av en förskrivning kan innehålla viktiga ändringar.  Uttag innehåller information om vad patienten hämtat ut på apoteket.	Läsåtkomst, vård
15:P.7	Senaste versionen av patientens alla förskrivningar samt tillhörande händelse* ska visas. Alla förskrivningar i patientens Nationella läkemedelslista ska vara möjliga att se, men alla behöver inte visas i samma vy.  Visning av förskrivningskedjor och förskrivningsversioner, utöver senaste versionen, är valfritt men rekommenderas.  Om förskrivningskedjor visas gäller krav 15:P.1. Om förskrivningsversioner visas gäller krav 15:P.1. Att hämta och visa alla versioner av en förskrivning är obligatoriskt när funktionen uppdatera förskrivning (TA 39) införs. Att hämta och visa förskrivningskedjor är obligatoriskt när funktionerna ersätta (TA 26), förnya (TA 24) eller skapa parallell förskrivning (TA10) införs.	Tillfälligt krav, utgår under andra halvåret 2028 och ersätts av 15:P.1.	Förskrivning, patient utan dossamtycke  Förskrivning, patient med dossamtycke (dospatient) -  för system som endast har funktionalitet för helförpackning

* Observera att det kan vara en uttagshändelse som triggar en ny version av en förskrivning och att det därmed är uttagshändelsen som ska visas på den senaste förskrivningsversionen. Detta kan exempelvis ske när sista uttaget expedieras och förskrivningen status ändras till slutexpedierad.

5.1. Rekommendationer

REKOMMENDATION

På sidan Datum i Nationella läkemedelslistan beskrivs rekommendationer för presentation av datum som är viktiga att beakta.

Versionshistorik