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.
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.
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:
-
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 |
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
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
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.
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. |
Ett Arbetsplats-id för förskrivarens arbetsplats ska anges om det är möjligt. HSA-id anges för vårdgivare som är HSA-ansluten, saknas HSA-id så anges istället ett organisationsnummer om sådant finns. |
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 |
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:
|
2-25-441 Återställning kan endast ske för en förskrivning med förskrivningsstatus Makulerad eller Avslutad. 2-25-442 |
||||||||
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:
|
2-25-443 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
Vid anrop där två förskrivningar anges för återställning
|
2-25-447 Angivna förskrivningar för återställning måste avse samma förskrivningskedja. 2-25-452 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:
|
|
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. |
1.1 | 2024-08-26 |
|