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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

3.2.1. Förskrivning – sökparametrar

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

Tabell 2 - Sökparametrar patient med personnummer

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

Tabell 3 -  Sök förskrivning med tidigare förskrivningsidentitet  

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

Tabell 4- Hämta förskrivning med händelse-id

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

Hämta senaste version med logiskt id

Tabell 5 - Hämta senaste version av förskrivning

Hämta versioner av en förskrivning

Tabell 6 - Hämta förskrivningshistorik eller specifik version 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.

Hämta förskrivningar via en händelse 

Tabell 7 - Hämta förskrivning via en händelse

Hämta förskrivningar via patientresurs

Tabell 8 - Hämta en patients förskrivningar

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 - Sökparametrar vid hämtning av patients förskrivningar

3.2.4. Händelse – sökparametrar

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

Tabell 10 - Hämta händelse med referens till resurs

Händelse – hämtning med logiskt id

Tabell 11 - Hämta händelse med logiskt-id

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 12 - Hämta händelser via en annan resurs

3.2.6. Uttag – sökparametrar

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

Tabell 13 -  Sök uttag kopplat till patient eller förskrivning

3.2.7. Uttag – Hämta

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

Tabell 14  - Hämta uttag med logiskt-id för uttag.

 

Hämta versioner av ett uttag/uttag pappersrecept

Tabell 15 - Hämta uttagshistorik eller specifik version av ett uttag

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.

Hämta uttag via en förskrivning

Tabell 16  - Hämta uttag via en förskrivning

3.3. Hämtade informationsresurser

3.3.1. Informationsresurs Förskrivning

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

3.3.2. Informationsresurs Händelse

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

3.3.3. Informationsresurs Personal

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

3.3.4. Informationsresurs Uttag

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

3.3.5. Informationsresurs Uttag pappersrecept

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

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

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

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.

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

Tabell 17 - Filtreringsregler

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 

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

6. Rekommendationer

REKOMMENDATION

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.

Versionshistorik