Denna tillämpningsanvisning beskriver olika möjligheter för en privatperson att hämta information i Nationella läkemedelslistan.

---

---

1. Verksamhetsbeskrivning

Syftet med denna tillämpningsanvisning är att beskriva olika möjligheter för en privatperson att hämta information i Nationella läkemedelslistan.

En patient får ha åtkomst till egna uppgifter i Nationella läkemedelslistan och kan hämta information om sina förskrivningar och uthämtade läkemedel och andra varor. Även patientens ombud  (via fullmakt) och vårdnadshavare får under vissa villkor åtkomst till patientens uppgifter. Informationen förmedlas via E-hälsomyndighetens webbapplikation Läkemedelskollen och kan även förmedlas via en apoteksaktörs e-handel.

Tillämpningsanvisningen beskriver funktioner för att hämta en patients förskrivningar samt eventuella uttag kopplade till dessa. Det är också möjligt att hämta förskrivningshistorik samt uttag pappersrecept, det vill säga uttag utan koppling till en förskrivning i Nationella läkemedelslistan.

Generellt har en vuxen patient tillgång till all sin information. För ombud med fullmakt eller för vårdnadshavare kan det finnas begränsningar i tillgång till information beroende på förekomst av spärrad information eller begränsningar som fullmakten anger.

1.1. Behörighetsroller 

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

• Privatperson

En definition av behörighetsrollerna finns på sidan Roller.

De olika användarroller som tillämpas med olika åtkomsttyper är:

• Patient – Åtkomst till egna uppgifter
• Vårdnadshavare – Vårdnadshavare
• Ombud - med fullmakt att utföra apoteksärenden

Se Ändamål, åtkomsttyper, resurser och behörigheter.

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

2.1. Förkrav

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

• Uppgift om patient och patientreferens ska 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 eller referens till ombud. Se krav för sökvillkor under sökning och hämtning per resurs.

• Ett ändamål och en åtkomsttyp har valts, se regelverk och vägledning i Ändamål, åtkomsttyper, resurser och behörigheter.

2.2. Delfunktion 1 – Hämta patients förskrivningar

Denna delfunktion innehåller varianter för olika användarrollers åtkomst till patients förskrivningar.

2.2.1. Variant 1.1 Hämta patients förskrivningar – Patient

Krav-ID:  01:1:1.1

2.2.1.1. Beskrivning

Patient hämtar samtliga eller ett urval av en patientens förskrivningar enligt angivna ändamål och åtkomsttyper i Meddelandehuvud  och sökvillkor enligt sökning och hämtning per resurs. Det är även 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, senaste version

Möjlig inkluderad resurs: Uttag, Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.2.2. Variant 1.2 Hämta patients förskrivningar – Vårdnadshavare

Krav-ID: 01:1:1.2

2.2.2.1. Beskrivning

Vårdnadshavare hämtar samtliga eller ett urval av en patientens förskrivningar enligt angivna ändamål och åtkomsttyper i Meddelandehuvud och sökvillkor enligt sökning och hämtning per resurs. Det är även 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, senaste version

Möjlig inkluderad resurs: Uttag, Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.2.3. Variant 1.3 Hämta patients förskrivningar – Ombud med fullmakt för apoteksärenden

Krav-ID: 01:1:1.3

2.2.3.1. Beskrivning

Ombud med fullmakt för apoteksärenden hämtar samtliga eller ett urval av en patientens förskrivningar enligt angivna ändamål och åtkomsttyper i Meddelandehuvud och sökvillkor enligt sökning och hämtning per resurs. Det är även 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, senaste version

Möjlig inkluderad resurs: Uttag, Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.3. Delfunktion 2 – Hämta historik för förskrivning

I denna delfunktion beskrivs hur användare kan komplettera sin åtkomst till en patients läkemedelslista med ytterligare information om historik för en förskrivning. Informationen inkluderar händelser associerade till förskrivningen samt möjligheten att hämta de versioner av förskrivningen som varje händelse föranledde. Det är också möjligt att hämta samtliga förskrivningar som ingår i samma förskrivningskedja via en sökning på Förskrivningskedje-id.

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

Krav-ID: 01:2:2.1

2.3.1.1. Beskrivning

Användare hämtar de händelser som skapats för en förskrivning för att få en överblick över hur förskrivningen har förändrats över tid enligt angivna ändamål och åtkomsttyper i Meddelandehuvud och enligt sökning och hämtning per resurs.

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 version av förskrivning kopplad till en händelse

Krav-ID: 01:2:2.2

2.3.2.1. Beskrivning

Användare hämtar de resurser som en händelse refererar till enligt angivna ändamål och åtkomsttyper i Meddelandehuvud och enligt sökning och hämtning per resurs. 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.3. Variant 2.3 Hämta samtliga versioner av en förskrivning

Krav-ID:  01:2:2.3

2.3.3.1. Beskrivning

Användare hämtar samtliga versioner av en förskrivning för att kunna spåra ändringar enligt angivna ändamål och åtkomsttyper i Meddelandehuvud och enligt sökning och hämtning per resurs.

Berörd resurs: Förskrivning

Returnerad resurs: Förskrivning

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.3.4. Variant 2.4 Hämta enskild förskrivningshändelse

Krav-ID: 01:2:2.4

2.3.4.1. Beskrivning av tillämpning

Användare hämtar en enskild händelse för en förskrivning enligt angivna ändamål och åtkomsttyper i Meddelandehuvud och sökvillkor i sökning och hämtning per resurs, 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 patients uttag

Denna delfunktion innehåller varianter för olika användarrollers åtkomst till patients uttag.

Uttag kan ha referens till förskrivning eller sakna sådan referens (uttag pappersrecept).

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

Krav-ID: 01:3:3.1

2.4.1.1. Beskrivning

Användare hämtar uttag för en förskrivning med ett förskrivnings-id enligt angivna ändamål och åtkomsttyper i Meddelandehuvud och enligt sökning och hämtning per resurs. Den senaste versionen av varje uttag returneras. Det är även möjligt att inkludera den händelse som tillhör den returnerade versionen av uttaget.

Berörd resurs: Förskrivning

Returnerad resurs: Uttag, senaste version

Möjlig inkluderad resurs: Händelse

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.4.2. Variant 3.2 Hämta patients uttag pappersrecept

Krav-ID:  01:3:3.2 

Utgår. Inkluderas i Variant 3.5.

2.4.3. Variant 3.3 Hämta patients uttag på förskrivningar med patientreferens

Krav-ID: 01:3:3.3

Utgår. Inkluderas i Variant 3.5

2.4.4. Variant 3.4 Hämta versioner av ett uttag

Krav-ID: 01:3:3.4

2.4.4.1. Beskrivning av tillämpning

Användare hämtar en specifik version 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 per resurs, 

Berörd resurs: Uttag, Uttag pappersrecept

Returnerad resurs: Uttag, Uttag pappersrecept

Resurser som returneras beskrivs i Hämtade informationsresurser.

2.4.5. Variant 3.5 Hämta en patients alla uttag via referens till patient

Krav-ID:  01:3:3.5

Beskrivning av tillämpning

Användare 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. Det är även 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.6. Variant 3.6 Hämta uttag via referens till uttag

Krav-ID: 01:3:3.6

Beskrivning av tillämpning

Användare 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.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: 01:4:4.1

Beskrivning av tillämpning

Användare 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. 2.5.2. Variant 4.2 Hämta enskild uttagshändelse

Krav-ID: 01: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 ändamål och åtkomsttyp som beskrivs i  Informationsspecifikation – meddelandehuvud. 

3.2. Sökning och hämtning per resurs

I detta avsnitt 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 ska 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 patient med personnummer

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

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

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

3.2.2.1. Hämta senaste version via logiskt id

Tabell 4. Hämta senaste version med förskrivnings-id

3.2.2.2. Hämta versioner av en förskrivning

Tabell 5. Hämta 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 stycke om compartment searches på  Simplifier Guide - Medication Request.

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

Tabell 6. Hämta förskrivningar via händelse

3.2.3.2. Hämta förskrivningar via patientresurs

Tabell 7. Hämta förskrivningar via patient

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

Detta är en variant av sökning med hjälp av patientreferens på förskrivningar tillhörande patient med personnummer.

Tabell 8. Hämta förskrivningar via patient med sökparametrar

3.2.4. Förskrivning

3.2.4.1. Hämta händelser för en förskrivning

Tabell 9. Hämta händelser för en förskrivning

3.2.5. Händelse – sökparameter

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

Tabell 10. Hämta händelse för en resurs

3.2.5.2. Händelse – hämtning med händelse-id

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

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

Tabell 12. Hämta händelser via annan resurs

3.2.7. Uttag – sökparametrar

Tabell 13. Sökparametrar för uttag

3.2.8. Uttag – Hämta

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

Tabell 14. Hämta uttag eller uttag pappersrecept med logiskt-id

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

Tabell 15. Hämta version av uttag eller uttag pappersrecept

3.2.9. Uttag – hämta uttag via annan resurs

För mer information se avsnitt om Compartment searches för resursen uttag  i Simplifier NLLn.

3.2.9.1. 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 Personal

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

3.3.3. Informationsresurs Händelse

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

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. 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 doseringen hämtas från den förskrivningsversion som uttaget refererar till.

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

Filtrering görs även enligt verksamhetsregel VR163.

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.

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

Tabell 17. Generella verksamhetsregler för denna tillämpningsanvisning

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

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 för 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 18. Filteringsregler för denna tillämpningsanvisning

5. Presentationskrav

Följande presentationskrav gäller vid visning av information som hämtas enligt denna tillämpningsanvisning. Observera att olika krav gäller beroende på vilken åtkomsttyp som används för att hämta informationen.

Tabell 19. Presentationskrav 

6. Rekommendationer

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