TA 57 - Återställ förskrivning - Vård

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

1. Verksamhetsbeskrivning

Syftet med denna tillämpningsanvisning är att beskriva hur förskrivare 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.

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:

Förskrivare

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. 2.1. Förkrav

Inga förkrav finns.

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

Förskrivare återställer förskrivning som av misstag har avslutats eller makulerats. Förskrivningen återställs till sin föregående version.

Variant 1.1 Återställ enskild förskrivning

Krav-ID: 57:1: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.

Variant 1.2 Återställ till parallella förskrivningar

Krav-ID: 57:1:1.2

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 åter bli 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

FHIR-operation

Å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 måste anges till den version av förskrivningsresursen som återställning ska ske till.

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.

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.

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 (Förskrivare)
Uppdragsgivare	Får inte anges.

Informationsresurs Personal

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

Tabell 4. Informationsresurs Personal

Term	Villkor händelse	Kommentar
Personal	Utförare (Förskrivare)
Yrkeskod	Obligatoriskt att ange Yrkeskod eller Utökad yrkeskod, enligt VR144. Valideras mot säkerhetsintyget enligt VR034. Valideringar mot Legitimationsregistret sker i AFF-kontroll.
Utökad yrkeskod	Obligatoriskt att ange Yrkeskod eller Utökad yrkeskod, enligt VR144. Valideras mot säkerhetsintyget enligt VR034. Valideringar mot Legitimationsregistret sker i AFF-kontroll.
Legitimationskod	Obligatoriskt för sjuksköterska som saknar individuell förskrivarkod, om ingen legitimationskod angivits kompletteras legitimationskoden enligt VR041. Valideras mot säkerhetsintyget enligt VR034. Valideringar mot Legitimationsregistret sker i AFF-kontroller.
Individuell förskrivarkod	Obligatoriskt att ange antingen Individuell förskrivarkod eller Gruppförskrivarkod. Valideras mot säkerhetsintyget enligt VR034. Valideringar mot Legitimationsregistret sker i AFF-kontroller.
Gruppförskrivarkod	Obligatoriskt att ange antingen Individuell förskrivarkod eller Gruppförskrivarkod. Valideras mot säkerhetsintyget enligt VR034. Valideringar mot Legitimationsregistret sker i AFF-kontroll.
Användar-id	Får inte anges.
Förnamn	Obligatorisk. Tillåtna tecken valideras enligt FK003
Efternamn	Obligatorisk. Tillåtna tecken valideras enligt FK003
Telefon	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	Obligatorisk.
Rangordning	Obligatorisk.
Tillgänglig för patient	Obligatorisk.
Telefonnummer tillhör	Obligatorisk. Person – anger att telefonnummer tillhör individ. Arbetsplats – anger att telefonnummer tillhör arbetsplats.
Arbetsplats	Obligatoriskt att ange information om förskrivarens arbetsplats.
Arbetsplatstyp	Obligatorisk. "Vårdenhet" eller "Enskild förskrivare" ska anges, valideras enligt VR110.
Arbetsplats-id	Valfri. Vårdenhetens HSA-id eller ett organisationsnummer kan anges.
Arbetsplats id typ	Obligatorisk om Arbetsplats-id anges. Giltiga värden är "HSA-id" eller "Organisationsnummer".
Arbetsplatsnamn	Obligatorisk.
Adressuppgift	Obligatoriskt att ange adressuppgift till förskrivarens arbetsplats. En besöksadress ska anges om möjligt, i andra hand kan en postadress anges. En adress av varje adresstyp kan anges, enligt VR184.
Adresstyp	Obligatorisk.
Adress	Obligatorisk.
Postnummer	Obligatorisk.
Postort	Obligatorisk.
Landskod	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
VR033	Validering av legitimation mot FORS
VR034	Validering av händelsens utförare mot säkerhetsintyget
VR041	Komplettera legitimationskod från Legitimationsregistret utifrån personnummer i intyget
VR085	Identifiering av doseringstyp
VR099	Förändring av dosunderlagets status och version
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
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
VR179	Uppdatering av aggregerad akutmarkering för dospatient
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örskrivningen 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	Kommentar
1.0	2024-05-06	Ny tillämpningsanvisning för tillämpning av funktion för att återställa förskrivning.