TA 58 - Hämta bevakade förskrivningar- Vård

Denna tillämpningsanvisning beskriver olika möjligheter att bevaka förskrivningar i Nationella läkemedelslistan.



1. Verksamhetsbeskrivning

Syftet med denna tillämpningsanvisning är att beskriva hur hälso- och sjukvårdspersonal kan bevaka dospatienters förskrivningar när de förändras eller är på väg att gå ut för att kunna hantera dessa.

För en lista på upp till 50 dospatienter per anrop returneras de förskrivningar vars giltighet håller på att gå ut eller de som har fått en förändring inom ett visst tidsintervall. Resultatet kan användas för att få en översikt över de patienter man valt och visa vad som hänt i patientens lista.

(warning)   Observera! Om något behöver åtgärdas i patientens läkemedelslista måste patientens hela läkemedelslista hämtas. 

Det är möjligt att använda informationen i en enskild patients läkemedelslista för att visa vilka förskrivningar som håller på att gå ut och vilka som blivit ändrade.

1.1.  Behörighetsroller

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

  • Förskrivare
  • Sjuksköterska
  • 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.

1.3.  Resurser 

I tabell 1 nedan listas de informationsresurser, FHIR-resurser och FHIR-profiler som ska användas vid hämta bevakade förskrivningar. Se Generell beskrivning av FHIR för en mer generell beskrivning av FHIR-resurser och FHIR-profiler i Nationella läkemedelslistan.

Tabell 1. Informationsresurser vid hämtning av bevakade förskrivningar

Informationsresurs

FHIR-Resurs

FHIR-Profil
Förskrivning MedicationRequest

NLLMedicationRequest
Patient Patient NLLPatient

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:

  • Patienten är dospatient

2.2. Delfunktion 1 –  Hämta förskrivningar vars giltighet löper ut

Hälso- och sjukvårdspersonal hämtar de förskrivningar vars giltighet löper ut inom ett angivet tidsintervall för en lista av dospatienter, maximalt 50 patienter. Se R002 för hur urval sker.

2.2.1. Variant 1.1 Hämta förskrivningar vars giltighet löper ut inom ett givet tidsintervall

Krav-ID: 58:1:1.1

2.2.1.1. Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar förskrivningar vars sista giltighetsdag ligger som mest 90 dagar framåt i tiden.

Information som krävs för att hämta förskrivningar och kontroller som sker finns under avsnitt 3.2 Indata samt 4. Regler och kontroller

2.3. Delfunktion 2 - Hämta förskrivningar med förändringar 

Hälso- och sjukvårdspersonal hämtar de förskrivningar som har förändringar som skett inom ett angivet tidsintervall för en lista av dospatienter, maximalt 50 patienter.

Som förändring räknas händelser som genererar en ny version av förskrivningen, se R001 för hur urval sker.

Läs mer om händelser Händelser i Nationella läkemedelslistan 

2.3.1. Variant 2.1 Hämta förskrivningar med förändringar inom ett givet tidsintervall

Krav-ID: 58:2:2.1

2.3.1.1. Beskrivning av tillämpning

Hälso- och sjukvårdspersonal hämtar förskrivningar som förändrats som mest 60 dagar bakåt i tiden.

Information som krävs för att hämta förskrivningar och kontroller som sker finns under avsnitt 3.2 Indata samt 4. Regler och kontroller

2.4. Krav på Hämta bevakade förskrivningar - Vård

Tabell 2. Krav Hämta bevakade förskrivningar - vård

Krav id Beskrivning Kommentar
58:2.1 Det anslutande systemet får maximalt ha 4 veckors sökperiod framåt och bakåt som standardinställning. Möjlighet att ange kortare sökperiod måste finnas och möjlighet att ange längre sökperiod får finnas. Möjlighet för användaren att ändra detta inom ramarna för delfunktionerna får finnas.
58:2.2 Hämtningen ska aktiveras genom ett aktivt val från användaren och får inte genereras automatiskt vid inloggning i systemet som standardinställning.

Möjlighet för användaren att välja att hämtning sker i samband med inloggning får finnas. 

Kravet finns för att minimera antalet onödiga hämtningar av prestandaskäl och för att undvika ofrivilliga åtkomster till Nationella läkemedelslistan. 
58:2.3 Det ska vara möjligt för användaren att välja att endast en av delfunktionerna ska användas. Hämtning ska göras enligt den variant som användaren aktivt valt. 

Det är också tillåtet att användaren väljer att bara använda en av delfunktionerna som standard.

Kravet finns för att minimera antalet onödiga hämtningar av prestandaskäl och för att undvika ofrivilliga åtkomster till Nationella läkemedelslistan.

3. Hanterad information

Information om hur anrop utförs samt definition av FHIR-operationen finns i informationsspecifikationen Hämta bevakade förskrivningar - $monitoring. 

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.

Ändamål och åtkomst anges enligt kombination för aktuell resurs för mer information se Giltiga kombinationer vårdrelaterade ändamål.

3.2.  Indata

3.2.1. FHIR-operation - $monitoring

FHIR-operationen $monitoring används för att hämta bevakade förskrivningar. Beskrivning av attribut och information om hur anrop utförs finns i tabell 3 samt definition av FHIR-operationen Hämta bevakade förskrivningar - $monitoring . 

Tabell 3. Indata för hämta bevakade förskrivningar.

Term

 Villkor

Kommentar
Personnummer

Minst ett och högst 50 kan anges, kontrolleras enligt R007


Från och med datum

Antingen Från och med datum eller Giltighetsdatum måste anges.

Giltigt datum kontrolleras enligt R008.

Anges för att hämta förskrivningar som har förändringar inom tidsintervallet angivet datum och dagens datum.
Giltighetsdatum

Antingen Från och med datum eller Giltighetsdatum måste anges.

Giltigt datum kontrolleras enligt R009.

Anges för att hämta förskrivningar vars giltighet löper ut mellan dagens datum och det angivna datumet (Giltighetsdatum).

3.3. Hämtade informationsresurser

För information om anrop samt definition av FHIR-operationen se Infospec Hämta bevakade förskrivningar - $monitoring . 

3.3.1. Patientinformation 

En begränsad del av patientinformationsresursen returneras en gång för varje patient som har förskrivningar enligt sökkriteriet. 

Beskrivning av resursen "Patient" finns i informationsspecifikationen Patient – NLLPatient


Tabell 4. Delar av patientinformation som returneras.

Kravterm

Kommentar
Patient-id
Personnummer
Redigerat namn
Förnamn

Tilltalsnamn markering
Efternamn

3.3.2. Informationsresurs Förskrivning

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

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. För detta TA används endast verksamhetsregler för beräknade värden, alla dessa finns beskrivna på sidan Generella verksamhetsregler.

4.2.  Specifika verksamhetsregler 

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

Tabell 5. Specifika verksamhetsregler i denna tillämpningsanvisning

Regel-id

Regelnamn

Beskrivning av regel

Felkod och felmeddelande

R001

Förändrade förskrivningar

För varje patient i sökningen returneras senaste versionen av de förskrivningar som:

  • har fått en ny version inom angivet intervall.
  • eller som har en första doseringsdag inom eller senare än angivet tidsintervall.

För varje förskrivning returneras information enligt Hämtade informationsresurser

N/A

R002

Förskrivningar vars giltighet löper ut

För varje patient i sökningen returneras senaste versionen av de förskrivningar som har en Sista giltighetsdag som infaller inom angivet intervall men som inte

  • har status Avslutad eller Makulerad.
  • eller har Senaste datum för avslut av behandling inom intervallet Dagens datum - Sökvillkor Giltighetsdatum.
  • eller har Sista doseringsdag inom intervallet Dagens datum - Sökvillkor Giltighetsdatum.

För varje förskrivning returneras information enligt Hämtade informationsresurser.

 N/A

R003

Filtrering av patient utan dossamtycke

För patient som inte har ett aktivt dosunderlag (status "Godkänt" eller "Ej godkänt") returneras inga förskrivningar.

 N/A

R004

Filtrering av avliden patient

För patient som är markerad som avliden i folkbokföringen returneras inga förskrivningar.

 N/A

R005

 Validering av högsta antal returnerade förskrivningar

Om svaret på sökningen ger träff på fler än 999 förskrivningar kastas ett felmeddelande.

2-26-379  Fel vid läsning av receptuppgifter. Högsta antalet träffar har uppnåtts, minska sökintervallet. 

R007

 Validering av sökvillkor patientRef

Kontroll sker av att:

  • Minst ett personnummer anges
  • Max 50 personnummer anges i ett och samma anrop.

2-26-373 Minst en patientreferens måste anges

2-26-380 Maximalt antal patientreferenser (50) har överskridits

R008

 Validering av sökvillkor Från och med datum

Anges för att hämta förskrivningar som har förändringar inom tidsintervallet angivet datum och dagens datum.

  • En av Från och med datum eller Giltighetsdatum måste anges, båda får inte anges.
  • Från och med datum anges till ett datum mellan dagens datum och högst 60 dagar bakåt i tiden.

2-26-381 Från och med datum måste vara dagens datum eller tidigare

2-26-382 Från och med datum får maximalt vara 60 dagar bakåt i tiden

2-26-375 Endast en av Datum from eller Giltighetsdatum får anges

2-26-376 Antingen Datum from eller Giltighetsdatum måste anges

R009

 Validering av sökvillkor Giltighetsdatum

Anges för att hämta förskrivningar vars giltighet löper ut mellan dagens datum och det angivna datumet (Giltighetsdatum).

  • En av Från och med datum eller Giltighetsdatum måste anges, båda får inte anges.
  • Giltighetsdatum anges till ett datum mellan dagens datum och högst 90 dagar framåt i tiden.

2-26-383 Giltighetsdatum måste vara samma eller senare som dagens datum

2-26-384 Giltighetsdatum får inte vara längre fram i tiden än 90 dagar från dagens datum

2-26-375 Endast en av Datum from eller Giltighetsdatum får anges

2-26-376 Antingen Datum from eller Giltighetsdatum måste anges

4.3.  Kontrollsamling - Automatisk format- och författningskontroll (AFF)

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 förskrivningsresurser utförs kontrollsamling AFF-LÄS. Resultatet returneras med varje förskrivningsresurs enligt Hämtade informationsresurser.  

4.4. 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
VAL001 Validering av åtkomsttyp "Åtkomst till dospatients 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.5. 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 i denna tillämpningsanvisning

Regel-id

Regelnamn
FIL023 Filtrering av apotekspersonals namn

5.  Presentationskrav

Tabell 6. Presentationskrav Hämta bevakade förskrivningar - Vård

Krav-id Beskrivning av krav Kommentar
58:P.1 Om hämtning görs för flera patienter ska resultatet visas i en separat vy eller lista för användaren. Möjlighet till åtgärd av förskrivningar direkt från den vyn eller listan får inte finnas.

I en vy där flera patienters information visas finns ökad risk för hantering av fel patient om ändringar får ske direkt i listan.

Dessutom saknas information om händelser, historik eller uttag kopplade till returnerade förskrivningar. Användaren kan inte heller veta om patientens samtliga förskrivningar visas i listan.




 Versionshistorik

Version

Datum

Release

Kommentar
1.0 2024-11-05 21.11 Ny tillämpningsanvisning för hämtning av bevakade förskrivningar.
1.1 2025-02-13 21.12
  • Justering av R002
  • Behörighetsroll sjuksköterska utan förskrivningsrätt ersätts av rollen sjuksköterska

1.2

 2025-04-29 21.13

Förbättringar dokumentation;

  • Lagt till kapitel 4.4 Valideringsregler
  • Lagt till kapitel 4.5 Filtreringsregler
  • Tagit bort R006 är ersatt av VAL013
  • Ändamål och åtkomst borttagen från Tabell 3. Indata för hämta bevakade förskrivningar. 
  • Lagt till hänvisning till Giltiga kombinationer vårdrelaterade ändamål i kapitel 3.1 Meddelandehuvud