TA 43 – Skapa utdrag – Förskrivningshistorik – Apotek

Denna tillämpningsanvisning beskriver hur expedierande apotekspersonal kan skapa en utskrift med förskrivningens expedieringshistorik.

1. Verksamhetsbeskrivning

Syftet med denna tillämpningsanvisning är att beskriva hur expedierande apotekspersonal kan skapa ett utdrag, det vill säga skapa en pappersutskrift, med förskrivningens historik. Utskriften används för att få en samlad bild av vad som har hänt på en specifik förskrivning och vilka expedieringar som har gjorts kopplat till förskrivningen. Utskriften kan användas för ändamålet expediering.

Utskriften är endast till för internt bruk på apotek och får aldrig lämnas ut till patient.

För läsanvisning och exempel på utskrift se Utskrifter och läsanvisningar.

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.

Ändamål, åtkomsttyper, resurser och behörigheter innehåller en beskrivning av giltiga kombinationer av ändamål, åtkomsttyp, resurs och behörighetsroll.

1.3. Resurser

I tabell 1 nedan listas de informationsresurser, FHIR-resurser och FHIR-profiler som berörs av denna tillämpningsanvisning.

Se Generell beskrivning av FHIR för en generell beskrivning av FHIR-resurser och FHIR-profiler i Nationella läkemedelslistan.

Tabell 1. Informationsresurser

Informationsresurs	FHIR-Resurs	FHIR-Profil	Anmärkning
Förskrivning	MedicationRequest	NLLMedicationRequest

2. Delfunktioner och varianter av tillämpningsanvisningen

Expedierande apotekspersonal begär en utskrift från Nationella läkemedelslistan avseende förskrivningshistorik med ändamål "Expediering" och åtkomsttyp "Utan krav på samtycke".
Utskriften genereras i form av en PDF-fil
PDF-filen skickas till anropande system
Åtkomsten loggas i åtkomstlogg

2.1. Förkrav

Innan en delfunktion kan tillämpas måste följande krav vara uppfyllda:

Patientreferens har hämtats enligt TA 05 – Hämta patientinformation.
Patients förskrivningar har hämtats enligt TA14 – Hämta förskrivningar och uttag – Apotek.

2.2. Delfunktion 1 – Skapa utdrag – Förskrivningshistorik

2.2.1. Variant 1.1 Skapa utdrag – Förskrivningshistorik

Krav-ID: 43:1:1.1

Beskrivning: Expedierande apotekspersonal vill generera en utskrift för att kunna ta del av all historik och alla expedieringar för en specifik förskrivning.

Berörd resurs: Förskrivning

Returnerad resurs: Utdrag (PDF)

3. Hanterad information

3.1. FHIR-operation

FHIR-operationen $print-prescription-history ska användas. Beskrivningen av hur operationen anropas och dess indata beskrivs i informationsspecifikation Skriv ut recepthistorik - $print-prescription-history.

Tabell 2. Indata skriv ut recepthistorik

Term	Kommentar
Förskrivnings-id	Obligatorisk

3.2. Meddelandehuvud

Information i meddelandehuvudet ska för denna tillämpningsanvisning anges enligt regler tillämpningsmönster 2.2.2 Hämta med säkerhetsintyg med ändamål och åtkomsttyp som beskrivs i Informationsspecifikation – meddelandehuvud.

Giltig kombination av ändamål och åtkomsttyp anges enligt Giltiga kombinationer apoteksrelaterade ändamål.

3.3. Returnerad information

Utdata från FHIR-operationen $print-prescription-history returneras. Utdata attribut beskrivs i informationsspecifikation Skriv ut recepthistorik - $print-prescription-history

Tabell 3. Attribut utdata skriv ut recepthistorik

Term	Kommentar
PDF	Returneras vid lyckat anrop

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. Alla dessa finns beskrivna i Generella verksamhetsregler.

Tabell 4. Generella verksamhetsregler i denna tillämpningsanvisning

Regel-id	Regel
VR025	Validering av anropande apotek mot Expeditionsställeregistret
VR033	Validering av legitimation mot Legitimationsregistret
VR039	Validering av anropande apotek mot intyget
VR040	Beräkning av avräknad mängd

4.2. Specifika verksamhetsregler

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

Tabell 5. Specifika verksamhetsregler

Regel-id	Regelnamn	Beskrivning av regel	Felkod och felmeddelande
R003	Sortering av förskrivningsversionerna listas i numerisk ordning	Förskrivningsversionerna sorteras (eller listas) i numerisk ordning.	N/A
R004	Uttag som är registrerade, backade eller krediterade kommer med på utskriften	Alla uttagshändelser ska komma med på utskriften. Uttagstyp (registrera, backa, korrigera) och händelsetyp (Expediera, Efterregistrera uttag, Backa uttag, Kreditera och Uppdatera uttag). Anmärkning: Uttagspost med typ Korrigera och händelsetyp Uppdatera förskrivning ska inte visas. Dessa poster finns för att korrigera kvarvarande mängd på förskrivning. Händelsetyp Efterregistrera uttag och Uppdatera uttag kan enbart utföras för helförpackning.	2-25-327 Hittade ej senaste förskrivningen för mall UtskriftForskrivningshistorik
R005	Beräkna angivet värde för kvarvarande mängd vid uppdatering av förskrivning	När apotek uppdaterar en förskrivning finns möjlighet att ange ett värde som kvarvarande mängd ska ändras till. När en ny kvarvarande mängd anges skapas en korrigeringspost i uttagstabellen, som sedan ingår i beräkningen av kvarvarande mängd vid läsning (enligt VR013). Regler för visning av ändrad kvarvarande mängd: Om en korrigeringspost för kvarvarande mängd finns visas korrigeringen i listan med ändringar för versionen. Text som skrivs ut är "Kvarvarande mängd:" + värde Exempel Kvarvarande mängd: 200 Värde beräknas utifrån korrigeringsposten enligt: Korrigeringspost + Avräknad mängd på föregående version av förskrivningen	N/A
R006	Beräkning av värde som angavs i avräknad mängd vid uppdatering av uttag	I avräknad mängd lagras en korrigeringspost enligt en avräkningsmodell, se nedan. När ett uttag visas behöver värdet i avräknad mängd beräknas för att visa hur mycket som har avräknats mot förskrivningen för uttaget och inte hur mycket som har korrigerats eller backats. Vid uppdatering av uttag anger användaren det värde som ska räknas av mot förskrivningen för uttaget. VR040 beräknar därefter hur stor korrigeringsposten är och lagrar den i avräknad mängd i databasen. Beräkning: Ingående saldo + korrigeringsposter. Ingående saldo är det beräknade värdet för avräknad mängd på föregående uttagspost. Om ingen avräknad mängd är angiven vid registrering av uttaget så används den expedierade mängden istället.	N/A
R007	Förskrivningshistorik inte möjlig att skriva ut för förskrivning utfärdad på födelsedatum	Det är inte möjligt att skriva ut förskrivningshistorik för en förskrivning som utfärdats på patientens födelsedatum.	2-25-814 Förskrivningshistorik kan inte skrivas ut eftersom angiven förskrivning saknas i Nationella läkemedelslistan.

4.2.1. Specifika verksamhetsregler - Regler för mall

Regler för mall som E-hälsomyndigheten ansvarar för

Tabell 6. Specifika verksamhetsregler - Regler för mall

Regel-id	Regelnamn	Beskrivning av regel
P002	Senaste versionen	Senaste versionen av en förskrivning visas alltid under avsnitt Senaste version av förskrivningen
P003	Förändringar för senaste version	Endast förändringar för senaste versionen visas under avsnitt Senaste version av förskrivningen
P004	Första version av förskrivningen	Första versionen av förskrivningen visas under avsnitt Originalversion av förskrivningen
P005	Sidhuvud och sidfot	Sidhuvud och sidfot visas på varje sida.
P006	Radbrytning	Radbrytning sker på text som inte får plats inom ett textfält. Radbrytningen sker mellan två ord.
P007	Sidbrytning	Sidbrytning sker så att enskilda förändrings- och expedieringssposter hålls ihop, samt att originalversionen av förskrivningen hålls ihop med utfärdarinformationen.
P008	Backade och krediterade uttag visas som överstrukna	Uppdaterat uttag, backat uttag eller krediterat uttag ska visas under det expedierade eller efterregistrerade uttaget med ett indrag. Om flera rader finns visas det i stigande datumordning, senaste datum sist. Datum, utförare och kommentar visas i klartext från händelsen. Om uttaget är backat eller krediterat ska tillhörande rader visas överstrukna ursprungsexpedieringen (Expediera eller Efterregistrera uttag) eventuella rad/rader med uppdaterat uttag
P009	Förändringar visas i fallande ordning	Förändringar som gjorts mellan första och sista versionen visas i avsnitt Förändringar. Versionerna visas i fallande ordning, dvs senaste versionen överst. Finns det inte fler än två versioner (dvs originalversionen och ytterligare en version) visas inte avsnittet alls.
P010	Expedieringar visas i fallande ordning	Expedieringarna visas i fallande ordning, dvs senaste expedieringen visas först. Sorteringen sker på expedieringsdatum. Expedieringen eller Expedieringarna visas efter avsnittet Senaste version av förskrivningen om det bara finns två versioner annars efter avsnittet Förändringar.
P011	Ledtext utelämnas vid saknat värde	Ledtext skrivs inte ut för ett fält som saknar värde.

4.3. Automatiska kompletteringar

Inga automatiska kompletteringar finns för denna tillämpningsanvisning.

4.4. AFF-kontroller och kontrollsamlingar

Ingen kontrollsamling körs för denna tillämpningsanvisning.

4.5. Valideringsregler

Valideringsregler beskriver validering vid hämtning av information från Nationella läkemedelslistan. Alla regler finns beskrivna på sidan Valideringsregler.

Tabell 7. Valideringsregler för denna tillämpningsanvisning

Regel-id	Regelnamn
VAL010	Validering av status på patient för ändamål "Expediering"
VAL013	Giltig kombination av ändamål, åtkomsttyp och behörighetsroll

4.6. Filtreringsregler

Filtreringsregler beskriver filtrering av uppgifter vid hämtning av information från Nationella läkemedelslistan. Alla regler finns beskrivna på sidan Filtreringsregler.

Tabell 8. Filtreringsregler för denna tillämpningsanvisning

Regel-id	Regelnamn
FIL001	Filtrering för ändamål "Expediering"
FIL005	Filtrering av Behandlingsorsak och Beskrivning annan behandlingsorsak
FIL023	Filtrering av apotekspersonals namn

5. Presentationskrav

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

6. Exempel av utskriften

Det finns exempel på hur utskriften kan se ut på sidan Utskrifter och läsanvisningar.

Versionshistorik

Version	Datum	Release	Kommentar
1.0	2021-11-27	21.0	Ny handbok vård- och apotekstjänster
1.1	2022-03-30	21.1	Små layout justeringar
1.2	2022-09-19	21.3	Språkliga justeringar.
1.3	2022-11-10	21.4	Uppdaterat med följande uppgifter: Regel P008 uppdaterat Regel P010 och P011 tillagda Regel R004 uppdaterat Regel R005 och R006 tillagda VR040 tillagd
1.3	2022-11-10	21.4	Förbättringar dokumentation Kapitel 3.1 FHIR-Operation, uppdaterat Kapitel 3.2 Meddelandehuvud, uppdaterat Kapitel 3.3 Returnerad information, uppdaterat Kapitel 4-2 Specifika verksamhetsregler lagt till kolumn för felkod och felmeddelande Språkliga förbättringar
1.4	2024-11-05	21.5	Lagt till hänvisning till sidan Utskrifter och läsanvisningar.
1.5	2025-02-13	21.12	Förbättringar dokumentation Lagt till stycke med Filtreringsregler som saknades R005 justerad Tagit bort felaktiga regler R001 och R002. Lagt till R007 som saknades. Kolumn för kommentar borttagen Lagt in länk till exempel och läsanvisning under rubriken Verksamhetsbeskrivning
1.6	2025-04-29	21.13	Filtreringsregler flyttat till avsnitt 4. Regler och kontroller. Avsnitt för Valideringsregler vid hämtning tillagt under avsnitt 4. Regler och kontroller. VAL013 som beskriver en befintlig validering har lagts till. Referens tillagd till information om giltiga kombinationer av ändamål och åtkomsttyp under avsnitt 3.2 Meddelandehuvud.