TA 56 - Återställ förskrivning - Apotek

Denna tillämpningsanvisning beskriver hur expedierande apotekspersonal på apotek kan återställa en förskrivning i Nationella läkemedelslistan som felaktigt har avslutats eller makulerats.

Verksamhetsbeskrivning

Syftet med denna tillämpningsanvisning är att beskriva hur expedierande apotekspersonal kan återställa en förskrivning som felaktigt har avslutats eller makulerats. Funktionen ska användas när ett avslut eller makulering skett av misstag. Vid återställa förskrivning skapas en ny version av befintlig förskrivning som motsvarar informationen i föregående version.

Observera att även värdet i attributet Akut förändring blir samma som i föregående version.

En förutsättning för att en avslutad eller makulerad förskrivning ska kunna återställas är att förskrivningen innan den felaktigt avslutades eller makulerades hade status Aktiv, Slutexpedierad eller Parkerad. När förskrivningen återställs kommer förskrivningen återgå till sin föregående status.

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.

1.3. Resurser

I tabell 1 nedan listas de informationsresurser, FHIR-resurser och FHIR-profiler som ska användas vid återställning av förskrivning. 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 återställning av förskrivning

Informationsresurs	FHIR-Resurs	FHIR-Profil
Förskrivning	MedicationRequest	NLLMedicationRequest
Personal	Practitioner	NLLPractitioner
Patient	Patient	NLLPatient
Händelse	Provenance	NLLProvenance Specialiserad profil NLLProvenanceMedicationRequestOther
Dosering	Dosage	NLLDosage

2. Delfunktion och varianter av tillämpningsanvisningen

2.1. Förkrav

Inga förkrav finns.

2.2. Delfunktion 1 – Återställ förskrivning

Expedierande personal på apotek återställer en förskrivning som av misstag har avslutats eller makulerats. Förskrivningen återställs till sin föregående version.

2.2.1. Variant 1.1 Återställ enskild förskrivning

Krav-ID: 56:1:1.1

2.2.1.1. Beskrivning av tillämpning

Användaren har valt en förskrivning som har status Avslutad eller Makulerad och begär att den ska återställas till sin föregående version.

Information som krävs för att återställa förskrivning och kontroller som sker finns under avsnitt 2.3 Efterfrågad information samt 3. Regler och kontroller.

2.2.2. Variant 1.2 Återställ till parallella förskrivningar

Krav-ID: 56:1:1.2

2.2.2.1. Beskrivning av tillämpning

Användaren har valt två förskrivningar som har status Avslutad eller Makulerad, och som tidigare var parallella, och begär att de ska återställas till sin föregående version för att återställas till parallella förskrivningar.

Information som krävs för att återställa förskrivning och kontroller som sker finns under avsnitt 2.3 Efterfrågad information samt 3. Regler och kontroller.

2.3. Efterfrågad information

Villkorens betydelse när en resurs hanteras.

Obligatorisk/Obligatoriskt
Innebär att attributet alltid ska anges, om det inte anges kommer ett fel att returneras. Om värdet inte får ändras framgår det i kommentar till respektive attribut.

Valfri/Valfritt
Innebär att användaren styr utifrån behoven när funktionen eller attributet ska nyttjas. Det är dock en obligatorisk funktionalitet alternativt ett obligatoriskt attribut i det anropande systemet. Se ytterligare regler för situationer när det måste anges eller när tidigare värde inte får ändras. Finns beskrivet i tillhörande verksamhetsregler och AFF-kontroller.

Får inte ändras
Innebär att attributet är obligatoriskt i anropet. Systemet behöver alltid skicka samma värde som finns angivet i föregående version. Kontroll att värdet inte har ändrats sker i NLL.

Ignoreras
Innebär att angivet värde ignoreras, gäller bland annat värden som beräknas och returneras vid läsning.

Får inte anges
Innebär att om ett värde anges kommer ett fel att returneras.

Valfritt att implementera
Innebär att möjlighet att ange eller ändra attribut är valfritt att implementera. Dock kvarstår presentationskrav för attributet.

2.3.1. FHIR-operation

2.3.1.1. Återställa förskrivning - $restore

FHIR-operationen $restore används för att återställa en förskrivning till en tidigare version. Beskrivning av attribut och information om hur anrop utförs finns i informationsspecifikation för FHIR-operation Återställ förskrivning - $restore.

Tabell 2. Attribut återställa förskrivning

Term

Villkor

Resurs

Referens till den version av förskrivningsresursen som ska återställas till måste anges.

Två resursreferenser kan anges om återställning till parallella förskrivningar ska ske.

Resultat

Vid lyckat anrop returneras senaste versionen av den eller de förskrivningsresurser som skapats vid återställningen.

2.3.2. Meddelandehuvud

Information i meddelandehuvudet ska för denna tillämpningsanvisning anges enligt regler för tillämpningsmönster 2.3 Skapa eller uppdatera resurser som beskrivs i Informationsspecifikation – meddelandehuvud.

2.3.3. Informationsresurs Händelse

En händelse måste alltid innehålla information om den som utför händelsen. I de fall en händelse utförs på uppdrag av någon annan ska information om uppdragsgivare anges.

Informationen hanteras i profilen Händelse och ska refereras i meddelandehuvud X-Provenance, se Informationsspecifikation – meddelandehuvud.

Tabell 3. Informationsresurs Händelse

Term	Villkor	Kommentar
Händelse-id	Sätts automatiskt enligt Auto33.
Händelsetidpunkt	Sätts automatiskt enligt Auto07.
Händelsetyp	Obligatorisk. "Återställa förskrivning"
Händelseorsak	Obligatorisk. Giltigt värde är OTH. Valideras i AFF.
Beskrivning händelseorsak	Obligatorisk. Tillåtna tecken kontrolleras enligt FK004.
Resursreferenser	Referenser sätts automatiskt enligt VR105.
Utförare	Obligatorisk.	Se informationsresurs Personal (Farmaceut eller Icke-legitimerad apotekspersonal)
Uppdragsgivare	Valfri. Valideras enligt VR107.	Se informationsresurs Personal (Förskrivare)

2.3.4. Informationsresurs Personal

Referens till informationsresurs Personal finns på Händelsen för Utförare och eventuell Uppdragsgivare.

Tabell 4. Informationsresurs Personal

Term	Villkor händelse		Kommentar
Personal	Utförare (Farmaceut eller Icke-legitimerad apotekspersonal)	Uppdragsgivare (Förskrivare)
Yrkeskod	Obligatoriskt att ange Yrkeskod eller Utökad yrkeskod. Angivet värde valideras mot Legitimationsregistret VR033 och mot intyget VR034.	Obligatoriskt att ange Yrkeskod eller Utökad yrkeskod. Validering mot Legitimationsregistret sker i AFF-kontroll.
Utökad yrkeskod	Obligatoriskt att ange Yrkeskod eller Utökad yrkeskod. Angivet värde valideras mot Legitimationsregistret VR033 och mot intyget VR034.	Obligatoriskt att ange Yrkeskod eller Utökad yrkeskod. Validering mot Legitimationsregistret sker i AFF-kontroll.
Legitimationskod	Obligatorisk för Farmaceut på apotek enligt VR033, om ingen legitimationskod angivits kompletteras det enligt VR041 Valideras mot säkerhetsintyget enligt VR034. Valideras mot Legitimationsregistret enligt VR033	N/A
Individuell förskrivarkod	Får inte anges.	Obligatoriskt att ange antingen Individuell förskrivarkod eller Gruppförskrivarkod. Validering mot Legitimationsregistret sker i AFF-kontroll
Gruppförskrivarkod	Får inte anges.	Obligatoriskt att ange antingen Individuell förskrivarkod eller Gruppförskrivarkod. Validering mot Legitimationsregistret sker i AFF-kontroll
Användar-id	Obligatorisk.	Får inte anges.
Förnamn	Obligatorisk. Tillåtna tecken kontrolleras enligt FK003.	Obligatorisk. Tillåtna tecken kontrolleras enligt FK003.
Efternamn	Obligatorisk. Tillåtna tecken kontrolleras enligt FK003.	Obligatorisk. Tillåtna tecken kontrolleras enligt FK003.
Telefon	Får inte anges. Hämtas från Expeditionsställeregistret utifrån angiven GLN-kod. Inga personliga kontaktuppgifter får anges för apotekspersonal.	Obligatoriskt att ange ett telefonnummer till förskrivares arbetsplats som är tillgängligt för patient enligt VR159. Telefonnummer till förskrivaren är valfritt att ange.	Högst två telefonnummer kan anges enligt VR160. Struktur upprepas för varje telefonnummer.
Telefonnummer	Får inte anges.	Obligatorisk.
Rangordning	Får inte anges.	Obligatorisk.
Tillgänglig för patient	Får inte anges.	Obligatorisk.
Telefonnummer tillhör	Får inte anges.	Obligatorisk. Person – anger att telefonnummer tillhör individ. Arbetsplats – anger att telefonnummer tillhör arbetsplats.
Arbetsplats	Uppgifter om arbetsplats och dess kontaktuppgifter hämtas från Expeditionsställeregistret, därför anges endast arbetsplats-id (GLN-kod).	Obligatoriskt att ange information om förskrivares arbetsplats.
Arbetsplatstyp	Obligatorisk. Giltigt värde är "Apotek", valideras enligt VR110.	Obligatorisk. Giltigt värde är "Vårdenhet", valideras enligt VR110.
Arbetsplats-id	Obligatorisk. Angiven GLN-kod valideras mot intyget VR039 och mot Expeditionsställeregistret VR025. Vid dosdispenserad förskrivning måste GLN-koden tillhöra samma apoteksaktör som dospatientens dosproducent. Valideras i AFF.	Valfri att implementera. Vårdenhetens HSA-id eller organisationsnummer kan anges.
Arbetsplats id typ	Obligatorisk. Giltigt värde är "GLN-kod".	Obligatorisk om arbetsplats-id anges. Giltiga värden är "HSA-id" eller "Organisationsnummer".
Arbetsplatsnamn	Får inte anges.	Obligatorisk.
Adressuppgift	Får inte anges. Hämtas från Expeditionsställeregistret utifrån angiven GLN-kod.	Obligatoriskt att ange adressuppgift till förskrivarens arbetsplats. En besöksadress ska anges om möjligt, i andra hand kan en postadress anges. Endast en adress av varje adresstyp kan anges, enligt VR184.
Adresstyp	Får inte anges.	Obligatorisk.
Adress	Får inte anges.	Obligatorisk.
Postnummer	Får inte anges.	Obligatorisk.
Postort	Får inte anges.	Obligatorisk.
Landskod	Får inte anges.	Får inte anges.

3. Regler och kontroller

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

Tabell 5. Generella verksamhetsregler i denna tillämpningsanvisning

Regel-id	Regelnamn
VR016	Kontrollera om patient är avliden
VR025	Validering av anropande apotek mot EXPO
VR033	Validering av legitimation mot FORS
VR034	Validering av händelsens utförare mot säkerhetsintyget
VR039	Validering av anropande apotek mot intyget
VR041	Komplettera legitimationskod från Legitimationsregistret utifrån personnummer i intyget
VR085	Identifiering av doseringstyp
VR099	Förändring av dosunderlagets status och version
VR103	Filtrering av behandlingsorsak och beskrivning annan behandlingsorsak när skapad eller förändrad förskrivningsresurs returneras till apotek
VR105	Referens till de resurser som påverkats av händelsen
VR107	Kontroll att uppdragsgivare är tillåtet att ange
VR110	Kontrollera arbetsplatstyp på Arbetsplats
VR148	Kontrollera att användare på apotek har behörighet att hantera läkemedel och tekniskt sprit
VR172	Kontroll att utförande eller uppdragsgivande förskrivare har förskrivningsrätt för artikel på förskrivning med framtida användning
VR174	Kontroll av Första och Sista doseringsdag på parallella förskrivningar
VR184	Antalet adresser per adresstyp begränsas

3.2. Automatiska kompletteringar

Automatisk komplettering innebär att E-hälsomyndigheten tillför information för vissa attribut vid vissa tillfällen. En detaljerad beskrivning av alla automatiska kompletteringar finns i Automatiska kompletteringar.

Tabell 6. Automatiska kompletteringar i denna tillämpningsanvisning

Regel-id	Regelnamn
Auto06	Versionsnummer för patients läkemedelslista genereras
Auto07	Komplettering av tidpunkt för händelse
Auto08	Generera unikt OR-ordinations-id för ny version av en förskrivning
Auto19	Förskrivningsversion genereras
Auto33	Händelsen kompletteras med ett händelse-id

3.3. Specifika verksamhetsregler

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

Tabell 7. Specifika verksamhetsregler i denna tillämpningsanvisning

Regel-id

Regelnamn

Beskrivning av regel

Felkod och felmeddelande

R001

Kontroll om förskrivning är möjlig att återställa

Förskrivningen är tillåten att återställa om:

Förskrivningsstatus är antingen Makulerad eller Avslutad.
Förskrivningen är antingen den senaste i förskrivningskedjan, eller så har senare förskrivning/ar i samma kedja förskrivningsstatus Makulerad. För att parallell förskrivning med status Avslutad ska kunna återställas undantar kontrollen de förskrivningar som angivits i samma anrop.

2-25-441 Återställning kan endast ske för en förskrivning med förskrivningsstatus Makulerad eller Avslutad.

2-25-442 Återställning kan inte ske då det finns senare förskrivning i samma förskrivningskedja som har annan förskrivningsstatus än Makulerad.

R002

Kontroll om angiven version är tillåten att återställa till

Den version av förskrivning som återställning ska ske till anges i anropet. Angiven version är tillåten om:

det är förskrivningens föregående version.
den har någon av förskrivningsstatusarna Slutexpedierad, Parkerad eller Aktiv.
Sista giltighetsdag för versionen inte är passerad.

2-25-443 Förskrivningen kan endast återställas till föregående version.

2-25-444 Återställning kan endast ske till en version med förskrivningsstatus Aktiv, Slutexpedierad eller Parkerad.

2-25-445 Förskrivningen kan inte återställas till en version där Sista giltighetsdag är passerad

R003

Kontroll vid återställning till parallella förskrivningar

Kontrollerar om det är möjligt att göra en återställning som innebär att två parallella förskrivningar återställs i förskrivningskedjan.

Vid anrop där en förskrivning anges för återställning

Kontrolleras om det redan finns förskrivningar i samma kedja med status aktiv, parkerad eller slutexpedierad.

Finns det fler än en förskrivning med status aktiv, parkerad eller slutexpedierad tillåts inte återställning. (2-25-452).
Finns det redan en förskrivning med status aktiv, parkerad eller slutexpedierad kontrolleras datumen mellan den förskrivningsversion som ska återställas och den andra förskrivningen i kedjan enligt datumregler i VR174, för att se att de bildar parallella förskrivningar. Om något fel uppstår enligt VR174 returneras felmeddelande 2-25-451.

Vid anrop där två förskrivningar anges för återställning

Kontrolleras att angivna förskrivningar avser samma förskrivningskedja. (2-25-447)
kontrolleras att datum på versionerna av de två förskrivningar som ska återställas följer regler i VR174, för att se att de bildar parallella förskrivningar. Om något fel uppstår enligt VR174 returneras felmeddelande 2-25-446.

2-25-447 Angivna förskrivningar för återställning måste avse samma förskrivningskedja.

2-25-452 Förskrivningen går inte att återställa då det redan finns parallella förskrivningar i förskrivningskedjan.

2-25-446 Angivna förskrivningar går inte att återställa samtidigt.

2-25-451 Det finns en annan förskrivning i samma förskrivningskedja med datum för användning som måste justeras innan återställning av angiven förskrivning kan ske.

R004

Komplettering av information vid ny förskrivningsversion

En ny version av förskrivningen med återställd information skapas genom att all information kopieras från förskrivningsversion för återställning.

När ny förskrivningsversion skapas sätts sedan följande attribut automatiskt:

Kravterm	Anmärkning
Förskrivningsversion	Sätts enligt Auto19
OR-ordinations-id	Övergångslösning. Sätts automatiskt enligt Auto08
Läkemedelslisteversion	Sätts automatiskt enligt Auto06

3.4. AFF-kontroller och kontrollsamlingar

Vid återställ förskrivning körs inga AFF-kontroller.

3.5. Formatkontroller

E-hälsomyndigheten gör formatkontroller på vissa attribut i Nationella läkemedelslistan. Formatkontrollerna beskrivs detaljerat på sidan Formatkontroller i Nationella läkemedelslistan.

Tabell 8. Formatkontroller i denna tillämpningsanvisning

Regel-id	Regelnamn
FK003	Tillåtna tecken i namnfält
FK004	Enkel textvalidator

4. Presentationskrav

Inga specifika presentationskrav finns för denna tillämpningsanvisning.

Versionshistorik

Version	Datum	Release	Kommentar
1.0	2024-05-06	21.5	Ny tillämpningsanvisning för tillämpning av funktion för att återställa förskrivning.
1.1	2024-08-26	21.10	Lagt till ett förtydligande i verksamhetsbeskrivningen rörande att värdet i attributet Akut förändring blir samma som i föregående version. Ny informationsruta med förtydligande av villkor under rubrik 2.3 Efterfrågad information. Förtydligat villkoret i attributet Arbetsplats-id (Uppdragsgivare)