TA 55 - Generera doseringsanvisning
Denna tillämpningsanvisning beskriver hur en doseringsanvisning skapas med hjälp av en funktion i Nationella Läkemedelslistan.
1. Verksamhetsbeskrivning
Syftet med denna tillämpningsanvisning är att beskriva den funktion som E-hälsomyndigheten erbjuder för att generera patientanpassad text till doseringsanvisningen. Alla system som skapar eller uppdaterar förskrivningar behöver en funktion som genererar en doseringsanvisning. Om inte E-hälsomyndighetens funktion som beskrivs i denna tillämpningsanvisning används behöver systemet en egen funktion. Då gäller kraven i TA 21 - Doseringsanvisning.
I Nationella läkemedelslistan är informationen som ingår i doseringsanvisningen strukturerad i hög grad. På en förskrivning som registreras i Nationella läkemedelslistan ska informationen skickas in både i strukturerat format och som patientanpassad text till doseringsanvisningen. Doseringsanvisningen skrivs ut på den etikett som sätts på patientens läkemedelsförpackning på apoteket. Doseringsanvisningen kan även visas digitalt för patienten och behörig personal.
En doseringsanvisning i Nationella läkemedelslistan består av fyra block:
- Behandlingsändamål
- Doseringsinstruktion
- Administreringsinstruktion
- Annan instruktion.
Blocken doseringsinstruktion och administreringsinstruktion består av text som genereras utifrån den strukturerade informationen på en förskrivning, se schematisk beskrivning i figur 1. Det är dessa två texter som E-hälsomyndighetens funktion för doseringsanvisning genererar. Anslutande system presenterar sedan de fyra blocken till doseringsanvisningen som visas för användaren och sparas i Nationella läkemedelslistan.
Läs mer om strukturerad dosering och administreringssätt på sidan TA 22 - Dosering och administreringssätt.
Figur 1. Schematisk beskrivning av hur en doseringsanvisning är sammansatt. Klicka på bilden för att se den större.
Funktionen kontrollerar även att sammanlagt antal tecken för alla fyra block inte överskrids i doseringsanvisningen. Vid varje anrop utförs även doseringskontroller innan texten genereras. Se figur 2 för en översiktlig beskrivning av detta flöde. Utöver omvandling till patientanpassad text samt kontroller för att generera korrekt doseringsanvisning, skapar E-hälsomyndighetens funktion en formaterad text för doseringsinstruktionen. Syftet med den formaterade doseringsinstruktionen är att tillhandahålla en längre doseringsinstruktion som kan skrivas ut och lämnas till patienten eller visas i digitala kanaler. Denna doseringsinstruktion innehåller även radbrytningar för ökad läsbarhet.
Figur 2. Beskrivning av flöde för generering av doseringsanvisning. Klicka på bilden för att se den större.
Exempel på verksamhetsflöde i vården
När en förskrivare ska förskriva ett läkemedel till sin patient sker följande:
- Förskrivaren väljer ett läkemedel och anger strukturerad information om dosering och administreringssätt. Hen anger även behandlingsändamål och eventuellt annan instruktion.
- Vårdinformationssystemet anropar E-hälsomyndighetens funktion för doseringsanvisning med den information som förskrivaren angivit.
- Funktionen genererar en doseringsinstruktion och en administreringsinstruktion utifrån den strukturerade informationen om dosering och administreringssätt.
- Den genererade texten returneras till vårdinformationssystemet. Även behandlingsändamål och eventuellt annan instruktion returneras samt en formaterad doseringsinstruktion.
- Förskrivaren tittar på resultatet av hela doseringsanvisningen innan hen skickar den kompletta förskrivningen till Nationella läkemedelslistan. I förskrivningen finns då både strukturerad information om dosering och administreringssätt, men även den patientanpassade texten till doseringsanvisningens olika block.
Exempel på verksamhetsflöde på apotek
På apotek används denna funktion vid registrering av pappersrecept eller när en dosering behöver ändras.
När en farmaceut ska ändra en dosering sker följande:
- Farmaceuten justerar den strukturerade doseringen på förskrivningen.
- Expedieringssystemet anropar E-hälsomyndighetens funktion för doseringsanvisning.
- Funktionen genererar en doseringsinstruktion och en administreringsinstruktion utifrån den strukturerade informationen om dosering och administreringssätt.
- Den genererade texten returneras till expedieringssystemet. Även behandlingsändamål och eventuellt annan instruktion returneras samt en formaterad doseringsinstruktion.
- Farmaceuten tittar på resultatet av hela doseringsanvisningen innan hen skickar den kompletta förskrivningen till Nationella läkemedelslistan. I förskrivningen finns då både strukturerad information om dosering och administreringssätt, men även den patientanpassade texten till doseringsanvisningens olika block.
1.1. Behörighetsroller
Följande behörighetsroller berörs av denna tillämpningsanvisning:
- Maskin-till-maskin.
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. FHIR-operation
I tabell 1 anges vilken FHIR-operation som ska användas när en doseringsanvisning ska genereras.
Tabell 1. FHIR-operation
Beskrivning | Utökad FHIR-operation |
|---|---|
Generera doseringsanvisning | $patient-dosage-directions FHIR-operationen beskrivs här: Generera doseringsanvisning - $patient-dosage-directions |
2. Delfunktion och varianter av tillämpningsanvisningen
2.1. Delfunktion 1: Generera doseringsanvisning
Variant 1.1 Generera doseringsanvisning
Krav-ID: 55:1:1.1
Beskrivning av tillämpning
Ett vård- eller apotekssystem skickar in strukturerad information och får tillbaka patientanpassade texter till två av blocken i doseringsanvisningen, doseringsinstruktion och administreringsinstruktion. Den information som krävs för att skapa texterna och de kontroller som görs på informationen finns beskrivna under avsnitten Efterfrågad information samt Regler och kontroller.
3. Efterfrågad information
3.1. Indata
Information som ska bifogas vid anrop till FHIR-operationen $patient-dosage-directions anges i tabell 2.
Tabell 2. Indata
Term | Villkor | Kommentar |
|---|---|---|
| Behandlingsändamål | Valfri. Tillåtna tecken kontrolleras enligt FK004. | Se villkor i respektive tillämpningsanvisning för att se om behandlingsändamål är obligatoriskt eller inte när en förskrivning skapas eller ändras. |
| Dosering | Obligatorisk. Kontrolleras i AFF. Se avsnitt 6.4 AFF-kontroller och kontrollsamlingar. | För detaljer om vilka attribut som ska anges vid vilken typ av dosering, se TA 22 Dosering och administreringssätt. |
3.2. Meddelandehuvud
Information i meddelandehuvudet ska för denna tillämpningsanvisning anges enligt regler tillämpningsmönster 2.1. Hämta utan säkerhetsintyg i Informationsspecifikation – meddelandehuvud.
4. Returnerad information
4.1. Returnerad information
I tabell 3 beskrivs vilken information som returneras när en doseringsanvisning genererats.
Tabell 3. Returnerad information
Term | Kommentar |
|---|---|
| Behandlingsändamål | Det som kan skilja mot Behandlingsändamål i indata är avskiljare enligt avsnitt 4.2. |
| Doseringsinstruktion | |
| Doseringsinstruktion formaterad | Detta attribut innehåller en formaterad doseringsinstruktion som är avsedd att exempelvis skrivas ut till patienten. I de fall den genererade texten till doseringsinstruktionen blir för lång för att skrivas ut på apoteksetiketten så innehåller Doseringsinstruktion formaterad den kompletta texten. Attributet Doseringsinstruktion innehåller då endast texten "Enligt separat doseringsschema". Doseringsinstruktion formaterad innehåller även radbrytningar för ökad läsbarhet.
|
| Administreringsinstruktion | |
| Annan instruktion | |
| Notifiering | Information om notifieringar finns under avsnitt 4.3. Hantering av långa texter samt notifieringar |
Doseringsinstruktion formaterad 4.2. Avskiljare
Attributen i doseringsanvisningen inleds och avslutas med avskiljare enligt nedan:
- Behandlingsändamål inleds med en versal och avslutas med punkt (om det inte redan finns) och ett mellanslag.
- Doseringsinstruktion inleds med versal och avslutas med punkt (dock inte om punkt redan finns vid fritextdosering) och ett mellanslag.
- Administreringsinstruktion inleds med versal och avslutas med punkt och ett mellanslag.
Attributet Annan instruktion förändras inte.
4.3. Hantering av långa texter samt notifieringar
Den returnerade informationen kan innehålla två typer av notifieringar: varningar och information.
En notifiering returneras exempelvis när den genererade doseringsinstruktionen blir för lång och E-hälsomyndigheten förkortar den till "Enligt separat doseringsschema". I tabell 5 finns en sammanställning över de fall då notifieringar returneras och vilken information som returneras i respektive fall.
Tabell 4. Sammanställning av returnerad information och notifieringar
Förutsättningar | Returnerad information | Returnerad notifiering | |
|---|---|---|---|
|
Användaren får förkorta lämplig del i doseringsanvisningen och funktionen för generering av doseringsanvisning anropas igen. | Varning enligt R011: Doseringsanvisning är för lång, vänligen förkorta. | |
|
| Information enligt R012: Doseringsinstruktionen är förkortad. | |
|
Användaren får förkorta lämplig del i doseringsanvisningen och funktionen för generering av doseringsanvisning anropas igen. | Varning enligt R011: Doseringsanvisning är för lång, vänligen förkorta. | |
|
| Information enligt R012: Doseringsinstruktionen är förkortad. | |
|
Användaren får förkorta lämplig del i doseringsanvisningen och funktionen för generering av doseringsanvisning anropas igen. | Varning enligt R011: Doseringsanvisning är för lång, vänligen förkorta. |
5. Krav på doseringsanvisning
I tabell 5 beskrivs krav på anslutande system som ska använda E-hälsomyndighetens funktion för att generera doseringsanvisning.
Tabell 5. Krav på anslutande system
Krav-id | Beskrivning av krav | Kommentar |
|---|---|---|
| 55:1:1.2 | Text som är genererad utifrån strukturerad information får inte ändras. Ändringar ska göras i den strukturerade informationen och en ny genererad text skapas. Det är inte tillåtet för användaren att manuellt lägga till text i doseringsinstruktion eller administreringsinstruktion. | |
| 55:1:1.3 | En doseringsanvisning är obligatorisk på förskrivningar som avser läkemedel och teknisk sprit. | |
| 55:1:1.4 | En doseringsanvisning ska alltid genereras vid en ny förskrivning samt vid alla förändringar av dosering och administreringssätt. En rekommendation är att även generera en ny doseringsanvisning när behandlingsändamål förändras eftersom det säkerställer att korrekta avskiljare införs (se avsnitt 4.2). | |
| 55:1:1.5 | Om E-hälsomyndighetens funktion för att generera doseringsanvisning inte är tillgänglig eller om hela Nationella läkemedelslistan är otillgänglig behöver anslutande system möjliggöra att användaren ändå kan skapa en doseringsinstruktion och en administreringsinstruktion utifrån en fritextdosering respektive fritext för administreringssätt. | E-hälsomyndigheten kan stänga av funktionen för att generera doseringsanvisning vid fel eller vid misstanke om fel i genereringen av text. I detta fall returneras felmeddelande enligt R010. |
6. Regler och kontroller
6.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. I tabell 6 nedan listas de generella verksamhetsregler som används i den här tillämpningsanvisningen.
Tabell 6. Generella verksamhetsregler
Regel-id | Regelnamn | Anmärkning |
|---|---|---|
| VR085 | Identifiering av doseringstyp |
6.2. Automatiska kompletteringar
Inga automatiska kompletteringar finns för denna tillämpningsanvisning.
6.3. Specifika verksamhetsregler
Verksamhetsregler beskriver validering och verksamhetslogik som E-hälsomyndigheten ansvarar för. I tabell 8 listas de specifika verksamhetsregler för denna tillämpningsanvisning.
Tabell 7. Specifika verksamhetsregler
| Regel-id | Regelnamn | Felkod och felmeddelande |
|---|---|---|
| R001 | Är ett giltigt kodvärde för dosenhet angivet? | 2-25-805 Ogiltigt värde, %s, för dosenhet. |
| R002 | Är ett giltigt kodvärde för doseringshastighetsenhet angivet? | 2-25-806 Ogiltigt värde, %s, för doseringshastighetenhet. |
| R003 | Är ett giltigt kodvärde för maxdosenhet angivet? | 2-25-807 Ogiltigt värde, %s, för maxdosenhet. |
| R004 | Är giltigt kodvärde för administreringsmetod angivet? | 2-25-801 Ogiltigt värde, %s, för administreringsmetod. |
| R005 | Är giltigt kodvärde för administreringsväg angivet? | 2-25-800 Ogiltigt värde, %s, för administreringsväg. |
| R006 | Är giltigt kodvärde för administreringsställe angivet? | 2-25-802 Ogiltigt värde, %s, för administreringsställe. |
| R007 | Är giltigt kodvärde för precisering av administreringsställe angivet? | 2-25-803 Ogiltigt värde, %s, för precisering av administreringsställe. |
| R008 | Är giltigt kodvärde för medicinteknisk produkt vid läkemedelsadministrering angivet? | 2-25-804 Ogiltigt värde, %s, för medicinteknisk produkt vid läkemedelsadministrering. |
| R009 | Är ett giltigt kodvärde angivet för period på dygnet? | 2-25-812 Ogiltigt värde, %s, för period på dygnet. |
| R010 | Information om att generera doseringsangivning är inte tillgänglig för tillfället. | 2-25-811 Funktionen för att generera doseringsangivning är inte tillgänglig för tillfället. |
| R011 | Information om att doseringsanvisningen är för lång. | 2-25-808 Doseringsanvisning är för lång, vänligen förkorta. |
| R012 | Information om att doseringsinstruktionen är förkortad. | 4-25-809 Doseringsinstruktionen är förkortad. |
| R013 | Information om att doseringsinstruktion formaterad är förkortad. | 4-25-813 Doseringsinstruktion formaterad är förkortad. |
6.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 som kontrollerar att en dosering innehåller rätt attribut i rätt kombinationer finns på sidan Doseringskontroller. I kolumnen "Kontroll i TA 55 - Generera doseringsanvisning" i tabell 1, anges om kontrollen körs vid generering av doseringsanvisning.
6.5. Formatkontroller
E-hälsomyndigheten gör formatkontroller på vissa attribut i Nationella läkemedelslistan. I tabell 9 listas de formatkontroller som används i den här tillämpningsanvisningen. Formatkontrollerna beskrivs detaljerat på sidan Formatkontroller i Nationella läkemedelslistan.
Tabell 8. Formatkontroller
Regel-id | Regelnamn |
|---|---|
| FK004 | Enkel textvalidator |
7. Presentationskrav
Följande presentationskrav gäller vid visning av information som hämtas enligt denna tillämpningsanvisning.
Tabell 9 - Presentationskrav
Krav-ID | Beskrivning av krav | Krav gäller |
|---|---|---|
| 55:P.1 | Användaren som skapar eller ändrar innehållet i doseringsanvisningen måste kunna se texten i sin helhet, dvs. alla fyra block i rätt ordning, innan den skickas in till Nationella läkemedelslistan.
| vård apotek |
| 55:P.2 | Vid visning av doseringsanvisning ska informationen presenteras i följande ordning:
| vård apotek e-handel till privatperson |
Versionshistorik
Version | Datum | Kommentar |
|---|---|---|
| 1.0 | 2022-11-10 | Ny sida Handbok vård- och apotekstjänster |