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 pappersrecept på apotek.

---

---

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 pappersrecept på apotek.

Expedierande apotekspersonal (farmaceut och icke-legitimerad apotekspersonal) kan få åtkomst till information i patientens läkemedelslista.

Något av följande ändamål krävs för att få tillgång till uppgifterna:

• expediering
• underlättande av patients läkemedelsanvändning.

Samtycke krävs för att få tillgång till uppgifterna för ändamålet underlättande av patients läkemedelsanvändning samt att för ändamålet expediering få åtkomst till uppgift om behandlingsorsak på förskrivning.

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

• Farmaceut på apotek
• Icke-legitimerad apotekspersonal.

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

2. Delfunktion och varianter av tillämpningsanvisningen

2.1. Förkrav

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

• Uppgift om patient och patientreferens ska alltid hämtas 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. 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

Expedierande apotekspersonal använder relevant åtkomsttyp för ändamålen expediering och underlättande av patients läkemedelsanvändning 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 en resurs.

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

Krav-ID: 14:1:1.1

Beskrivning av tillämpning

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

2.2.2. Variant 1.2 Hämta versioner av en förskrivning

Krav-ID: 14:1:1.2

Beskrivning av tillämpning

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

Berörd resurs: Förskrivning

Returnerad resurs: Förskrivning

Resurser som returneras beskrivs i Hämtade informationsresurser.

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

Krav-ID: 14:1:1.3

Beskrivning av tillämpning

Apotekspersonal 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. Den version av förskrivningen som händelsen genererade returneras. Den version av förskrivningen som händelsen genererade 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: Händelse

Returnerad resurs: Förskrivning

Möjlig inkluderad resurs: Uttag, Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

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

Krav-ID: 14:1:1.4

Beskrivning av tillämpning

Apotekspersonal 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. Den senaste versionen av varje förskrivning i kedjan returneras. 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.

2.2.5. Variant 1.6 Hämta direktadresserade förskrivningar

Krav-ID: 14:1:1.6

Beskrivning av tillämpning

Apotekspersonal hämtar direktadresserade förskrivningar till ett apotek med angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning. Sökningen måste göras i kombination med ett specifikt födelsedatum eller ett datumintervall för utfärdandedatum. Den senaste versionen av varje förskrivning returneras och det är endast förskrivningar med födelsedatum som 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.

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

Krav-ID: 14:1:1.7

Beskrivning av tillämpning

Apotekspersonal kan hämta förskrivningar med förskrivningsidentiteter som angivits via Nationellt e-receptformat (NEF) som sökparametrar (originalordinations-id, produktradnummer, radnummer) med angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning. Denna tillämpning möjliggör att hämta en förskrivning utifrån den 2D-kod som finns på receptblanketten när en förskrivning har blivit omvandlad till pappersformat. 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 en användare via sin åtkomst till en patients förskrivningar kan hämta ytterligare information om historik för en förskrivning.

Informationen inkluderar händelser associerade till förskrivningen.

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

Krav-ID: 14:2:2.1

Beskrivning av tillämpning

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

Berörd resurs: Förskrivning

Returnerad resurs:  Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.3.2. Variant 2.2 Hämta enskild förskrivningshändelse

Krav-ID: 14:2:2.2

Beskrivning av tillämpning

Apotekspersonal 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

Apotekspersonal använder relevant åtkomsttyp för ändamålen expediering eller underlättande av läkemedelsanvändning för att få åtkomst till uttag och uttag pappersrecept kopplade till en patient eller uttag tillhörande en viss förskrivning. Det går även att hämta ett specifikt uttag eller uttag pappersrecept med ett logiskt id till resursen.

2.4.1. Variant 3.1 Hämta uttag via en förskrivning

Krav-ID: 14:3:3.1

Beskrivning av tillämpning

Apotekspersonal hämtar uttag via en förskrivning enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Uttag – sökparametrar. 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.4.2. Variant 3.2 Hämta en patients alla uttag via referens till patient

Krav-ID: 14:3:3.2

Beskrivning av tillämpning

Apotekspersonal hämtar alla uttag för en patient enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Uttag – sökparametrar. 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: Uttag, Uttag pappersrecept

Returnerad resurs: Uttag, Uttag pappersrecept

Möjlig inkluderad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.4.3. Variant 3.3 Hämta uttag via referens till uttag

Krav-ID: 14:3:3.3

Beskrivning av tillämpning

Apotekspersonal hämtar ett uttag eller uttag pappersrecept via en referens till uttaget enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Hämta uttag via logiskt id. 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.

2.4.4. Variant 3.4 Hämta uttag pappersrecept

Utgår, inkluderas istället i Variant 3.2 och 3.3.

2.4.5. Variant 3.5 Hämta versioner av ett uttag

Krav-ID: 14:3:3.5

Beskrivning av tillämpning

Apotekspersonal hämtar en eller alla versioner av ett uttag eller uttag pappersrecept med ett uttags-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.

2.4.6. Variant 3.6 Hämta uttag för en expediering

Krav-ID: 14:3:3.6

Beskrivning av tillämpning

Apotekspersonal hämtar uttag tillhörande en viss patient som gjorts för en expediering med expeditions-id:t för expedieringen enligt angivna ändamål och åtkomsttyper i meddelandehuvud och sökvillkor i sökning och hämtning, Uttag – sökparametrar. Den senaste versionen av uttaget returneras. Vid hämtningen är det möjligt att inkludera den händelse som tillhör den returnerade versionen av uttaget.

Berörd resurs: Uttag, Uttag pappersrecept

Returnerad resurs: Uttag , Uttag pappersrecept

Möjlig inkluderad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.4.7. Variant 3.7 Hämta uttag för en lista av förskrivningar

Krav-ID: 14:3:3.7

Beskrivning av tillämpning

Apotekspersonal 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, Uttag – sökparametrar. 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.

2.5.1. Variant 4.1 Hämta händelser via ett uttag

Krav-ID: 14:4:4.1

Beskrivning av tillämpning

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

2.5.2. Variant 4.2 Hämta enskild uttagshändelse

Krav-ID: 14:4:4.2

Beskrivning av tillämpning

Apotekspersonal hämtar en specifik händelse 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ä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 som beskrivs i  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 hur sökning och hämtning kan ske.

3.2.1. Förskrivning – sökparametrar

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

Tabell 2 - Sökparametrar 

Sökning på tidigare förskrivningsidentiteter (NEF och OR)Tabell 3 - Sök med tidigare förskrivningsidentiteter 

3.2.1.2. Sökning av direktadresserade förskrivningar

Tabell 4 - Sök  direktadresserade förskrivningar

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

Tabell 5 - Sök förskrivningar med Händelse-id

3.2.2. Förskrivning – Hämta via logiskt id

3.2.2.1. Hämta senaste version med logiskt id

Tabell 6 - Hämta förskrivning med logiskt-id

3.2.2.2. Hämta versioner av en förskrivning

Tabell 7 - Hämta versioner av förskrivning

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

3.2.3.1. Hämta förskrivningar via en händelse

Tabell 8

3.2.3.2. Hämta förskrivningar via patientresurs

Tabell 9

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

Här beskrivs möjligheter att komplettera sökning via patientresurs som beskrivs i tabellen ovan med ytterligare sökparametrar.

Tabell 10

3.2.4. Händelse – sökparameter

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

Tabell 11

3.2.4.2. Händelse – hämtning med logiskt id

Tabell 12

3.2.5. 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 13

3.2.6. Uttag – sökparametrar

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

Tabell 14

3.2.7. Uttag – Hämta

3.2.7.1. Hämta uttag eller uttag pappersrecept via logiskt id 

Tabell 15

3.2.7.2. Hämta versioner av ett uttag eller uttag pappersrecept 

Tabell 16

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

3.2.8.1. Hämta uttag via en förskrivning

Tabell 17

3.3. Hämtade informationsresurser

3.3.1. Informationsresurs Händelse

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

3.3.2. Informationsresurs Personal

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

3.3.3. Informationsresurs Dosering 

Vid förskrivning av läkemedel och teknisk sprit är dosering obligatoriskt och valideras i AFF. 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.3.4. Informationsresurs Förskrivning

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

3.3.5. Informationsresurs Uttag

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

3.3.6. Informationsresurs Uttag pappersrecept

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

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.

I tabell 19 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 respektive verksamhetsregler.

Tabell 19

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 tar ansvar för. 

Nedan listas de specifika verksamhetsregler som bara används i denna tillämpningsanvisning.

Tabell 20

4.4. AFF-kontroller och kontrollsamlingar

Automatiska format- och författningskontroller (AFF-kontroller) ä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.

4.5. 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 18 nedan listas de filtreringsregler som används i den här tillämpningsanvisningen.

Tabell 18 - Filtreringsregler

5. Presentationskrav

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

Tabell 21 - presentationskrav 

6. Rekommendationer

REKOMMENDATION

Observera att en vy som är avsedd att visa ”läkemedel som det är troligt att patienten använder för tillfället” även kan behöva inkludera förskrivningsstatusar utöver Aktiv och Parkerad. 

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

REKOMMENDATION

Om förskrivning eller annan resurs  som hämtas avser test  rekommenderas att det tydligt visas i anslutande system.  Testdata identifieras på ett  enhetligt sätt som metadata på resursen se exempel i  Förskrivning – NLLMedicationRequest.

REKOMMENDATION

Det är rekommenderat att visa att det finns spärrad behandlingsorsak när tillfälligt samtycke till åtkomst av behandlingsorsak finns.

Versionshistorik