TA 50 – Kontrollera och godkänn produktionsuttag – Apotek
Denna tillämpningsanvisning beskriver hur expedierande apotekspersonal på dosapotek kan kontrollera eller registrera produktionsuttag för en eller flera dosdispenserade förskrivningar för en patient med dossamtycke (dospatient).
1. Verksamhetsbeskrivning
Syftet med denna tillämpningsanvisning är att beskriva hur expedierande apotekspersonal på dosapotek kan kontrollera eller registrera produktionsuttag för en eller flera dosdispenserade förskrivningar för en patient med dossamtycke (dospatient).
Registrering av ett uttag görs i samband med expediering av en förskrivning. Uttaget innehåller information om vad som expedierats och vilken mängd. Det sparas även information om vem som registrerat uttaget och när det gjorts.
Innan ett uttag registreras är det möjligt att göra en kontroll av uttaget. Syftet med denna kontroll är att identifiera eventuella felaktigheter innan uttaget registreras.
I samband med kontroll och registrering av uttag genomförs automatiska format– och författningskontroller (AFF-kontroller). Dessa kontroller kan vara avvisande eller ge en varning. Avvisande fel måste åtgärdas och varningar ska åtgärdas eller accepteras av expedierande apotekspersonal för att uttaget ska vara möjligt att registrera.
Registrering av uttag avseende helförpackning, även för patient med dossamtycke, beskrivs i tillämpningsanvisning TA 46 – Registrera och kontrollera uttag – Apotek.
1.1. Behörighetsroller
Följande behörighetsroller berörs av denna tillämpningsanvisning:
- Farmaceut på apotek
- Icke-legitimerad apotekspersonal
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 för denna tillämpningsanvisning.
Se Generell beskrivning av FHIR för en mer generell beskrivning av FHIR-Resurser och FHIR-Profiler i Nationella läkemedelslistan.
Tabell 1. Informationsresurser
Informationsresurs |
FHIR-Resurs |
FHIR-Profil |
---|---|---|
Expedition | Bundle | NLLDispatch |
Uttag | MedicationDispense |
NLLMedicationDispense |
Dosering | Dosage | NLLDosage |
Händelse | Provenance |
NLLProvenance Specialiserad profil |
Personal |
Practitioner | NLLPractitioner |
AFF varningar och fel | DetectedIssues | NLLDetectedIssues |
2. Delfunktion och varianter av tillämpningsanvisningen
2.1. Förkrav
Innan delfunktionen (delfunktionerna) kan tillämpas måste följande krav vara uppfyllda:
- Patientreferens har hämtats enligt TA 05 – Hämta patientinformation
- Senaste versionen av förskrivningen har hämtats enligt TA 14 Hämta förskrivningar och uttag – Apotek
- Senaste versionen av patientens dosunderlag har hämtats enligt TA 35 – Hämta dosunderlag
- Farmaceut har utfört farmakologisk kontroll av patientens läkemedelslista och godkänt dosunderlaget om något har förändrats sen senaste produktion, TA 18 – Godkänn dosunderlag – Apotek
2.2. Delfunktion 1 – Kontrollera produktionsuttag
2.2.1. Variant 1.1 Kontrollera produktionsuttag
KRAV Krav-ID: 50:1:1.1
Beskrivning tillämpning
Expedierande apotekspersonal kontrollerar dosdispenserade uttag inför produktionsuttaget (expediering) för att bedöma och kunna korrigera eventuella fel eller varningar innan en registrering av uttag sker. Inga uppgifter sparas vid kontrollera uttag.
Information som krävs för varianten, och de kontroller som görs av informationen finns under kapitel 2.4 - Efterfrågad information samt 3.0 - Regler och kontroller.
2.3. Delfunktion 2 – Godkänn Produktionsuttag
2.3.1. Variant 2.1 Godkänn Produktionsuttag
KRAV Krav-ID: 50:2:2.1
Beskrivning tillämpning
Expedierande apotekspersonal på dosapotek registrerar uttag för dosdispenserade förskrivningar. Om inga fel eller varningar förekommer sparas uttag för de förskrivningar som ingår i expedieringen. Om fel eller varningar förekommer på någon av de ingående uttagen i expedieringen avvisas hela expedieringen och inget uttag registreras.
Information som krävs för att godkänna uttaget och de kontroller som görs av informationen finns under kapitel 2.4 - Efterfrågad information samt 3.0 - Regler och kontroller.
2.4. Efterfrågad information
Villkorens betydelse när en resurs skapas:
Obligatorisk/Obligatoriskt
Innebär att attributet alltid ska anges, om det inte anges kommer ett fel att returneras.
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.
Sätts automatiskt
Innebär att attributet sätts automatiskt i NLL enligt angiven regel. Om ett värde anges i anropet kommer det att ignoreras.
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 attribut är valfritt att implementera. Dock kvarstår presentationskrav för attributet.
2.4.1. FHIR-operation
För variant 1.1 Kontrollera produktionsuttag ska FHIR-operationen kontrollera uttag, $verify, användas. Beskrivning av attribut och information om hur anrop utförs beskrivs i informationsspecifikation för Kontrollera uttag eller förskrivning - $verify.
Tabell 2. Attribut kontrollera produktionsuttag
Term |
villkor |
---|---|
Förskrivning |
N/A |
Uttag | Ska anges om ett uttag registreras |
Uttag pappersrecept | N/A |
Expediering | Ska anges om ett eller flera uttag registreras i en expediering (bundle). |
AFF resultat | Returneras alltid |
AFF Fel | Returneras om AFF-fel förekommer vid ett lyckat anrop. |
Informationsresurs Meddelandehuvud
Information i meddelandehuvudet ska för denna tillämpningsanvisning anges enligt tillämpningsmönster 2.3 Skapa eller uppdatera resurser som beskrivs i Informationsspecifikation – meddelandehuvud.
2.4.2. Informationsresurs Resurssamling
Om flera uttag ingår i samma expediering används en resurssamling för att hålla ihop uttag i expediering i en transaktion. Se informationsspecifikation Resurssamling-bundle.
2.4.3. Informationsresurs Uttag
Produktionsuttag anges enligt informationsspecifikation – Uttag – NLLMedicationDispense.
Tabell 3. Attribut informationsresurs Uttag
Term |
Villkor |
Kommentar |
---|---|---|
Logiskt id för uttag | Sätts automatiskt enlig Auto38 | |
Uttagsversion | Sätts automatiskt enlig VR123 | |
Expeditions-id |
Antingen anges expeditions-id eller sätts automatiskt enligt VR035 av eHM. Ingår i dubblettkontroll VR168 Om expeditions-id anges kontrolleras att:
|
Expeditions-id hämtas med tjänsten HamtaExpeditionsIdService. Detta id ska sedan användas i rapportering till FOTA och HKDB. Tjänsten finns specificerad i bilaga GT - Funktionsspecifikation. |
Aktörens expeditions-id | Obligatorisk Kontrolleras i VR164 för uttag i samma expediering |
|
Aktörens expeditionsradnummer | Obligatorisk Ingår i dubblettkontroll VR168 |
Ska vara unikt inom expedieringen, valideras i AFF. |
Expeditionstidpunkt | Obligatorisk. Att datumet är rimligt kontrolleras enligt VR051. |
Ska vara samma tidpunkt för alla uttag i expedieringen. |
Krediterande expeditions-id | Ignoreras |
Angivet värde ignoreras. Används enbart vid backning eller kreditering av uttag |
Krediteringstidpunkt | Ignoreras | Angivet värde ignoreras. Används enbart vid backning eller kreditering av uttag |
Handelsvara | ||
Varunummer |
Obligatorisk för handelsvara. Valideras i AFF. |
|
Läkemedel | ||
NPL-id |
Obligatorisk för läkemedel. Valideras i AFF. |
Används bara för validering, sparas inte på uttaget |
NPL-pack-id |
Obligatorisk för läkemedel. Valideras i AFF. |
|
Antal expedierade förpackningar | Får inte anges | |
Avräknad mängd | Får inte anges | |
Expedierad mängd | Obligatorisk Angivet värde ska vara > 0 |
|
Uttagstyp | Obligatoriskt att ange en uttagstyp | Dosdispenserade och helförpackningsuttag kan inte blandas i en expediering enligt VR153 |
Helförpackningsuttag |
Får inte anges | Helförpackningsuttag hanteras i TA 46 – Kontrollera och godkänn uttag– Apotek |
Dosdispenserat uttag |
Kodvärde "DD" ska anges vid dosdispenserade uttag. |
Att förskrivningen är dosdispenserad valideras i R002 och VR153 |
Expedierad Startförpackning |
Får inte anges | |
Förmånsval | Obligatorisk. Giltigt kodvärde valideras i VR036 |
Om expediering får göras inom förmån valideras i AFF. |
Generikautbyte utfört |
Obligatorisk om expediering inom förmån, valideras i AFF. |
Om expediering utom förmån är det valfritt att ange. |
Beslut slutexpediering |
Får inte anges |
|
Uttagsstatus |
Obligatorisk. |
|
Uttagsnotering |
Valfritt. |
|
Dosering |
Får inte anges. |
Planerad dosering från förskrivningen används alltid för dosdispenserade uttag |
Referens till förskrivning |
Obligatorisk. |
Uppgift om patient finns på expedierad förskrivning. |
Accepterade varningar |
Valfritt. |
Inbäddad resurs i uttag, se informationsspecifikation AFF fel och varningar – NLLDetectedIssue, samt instruktioner i Krav på anropsresultat och felhantering. |
2.4.4. Informationsresurs Dosering
Se detaljerad information om doseringsparametrar och regler kring dosering i TA 22 – Dosering och administreringssätt.
Dosering får inte anges för produktionsuttag enligt R006. Dosering från expedierad förskrivningsversion används alltid.
2.4.5. Informationsresurs Händelse
Händelsen anges enligt informationsspecifikation – Händelse – NLLProvenance och ska refereras i meddelandehuvud X-Provenance, se Informationsspecifikation – meddelandehuvud.
Tabell 4. Attribut informationsresurs Händelse
Kravterm |
Villkor |
Kommentar |
---|---|---|
Händelse-id | Sätts automatiskt enligt Auto33 | |
Händelsetidpunkt |
Sätts automatiskt enligt Auto07 | |
Händelsetyp | Obligatorisk. Gilgit värde "Expediera" |
Ingår i dubblettkontroll VR168 |
Beskrivning händelseorsak | Får inte anges | Ingen händelseorsak får anges kopplat till uttaget. Notering kring uttaget kan anges i uttagsnotering |
Händelseorsak | Ignoreras | |
Resursreferenser | Kompletteras automatiskt enligt VR105. | |
Utförare | Obligatorisk | Se informationsresurs Personal utförare (Farmaceut eller Icke-legitimerad apotekspersonal) |
Uppdragsgivare |
Autokompletteras enligt VR149 med den farmaceut på ett dosapotek som närmast i tid godkände patientens dosunderlag. |
Se informationsresurs Personal uppdragsgivare (Farmaceut eller Icke-legitimerad apotekspersonal) Att en uppdragsgivare inte anges kontrolleras i VR107 |
2.4.6. Informationsresurs Personal
Uppgifter om expedierande apotekspersonal samt arbetsplats, anges enligt informationsspecifikation Personal – NLLPractitioner. I tabell 5 nedan listas den information i Personal som är specifik för denna tillämpningsanvisning.
Tabell 5. Attribut informationsresurs Personal
Term |
Villkor | |
---|---|---|
Personal | Utförare Farmaceut på apotek eller icke-legitimerad apotekspersonal |
Uppdragsgivare Den farmaceut på ett dosapotek som närmast i tid godkände patientens dosunderlag sätts automatiskt som uppdragsgivare |
Yrkeskod |
Obligatoriskt att ange Yrkeskod eller utökad yrkeskod enligt VR144 Valideras mot säkerhetsintyget enligt VR034 Valideras mot Legitimationsregistret (FORS) enligt VR033 |
Sätts automatiskt enligt VR149 |
Utökad yrkeskod |
Obligatoriskt att ange Yrkeskod eller utökad yrkeskod enligt VR144 Valideras mot säkerhetsintyget enligt VR034 Valideras mot Legitimationsregistret (FORS) enligt VR033 |
Sätts automatiskt enligt VR149 |
Legitimationskod |
Obligatorisk för Farmaceut på apotek enligt VR033, om ingen legitimationskod angivits kompletteras legitimationskoden enligt VR041 Valideras mot säkerhetsintyget enligt VR034. Valideras mot Legitimationsregistret(FORS) enligt VR033 Kommentar: |
Sätts automatiskt enligt VR149 |
Individuell förskrivarkod | Får inte anges | Får inte anges |
Gruppförskrivarkod | Får inte anges. | Får inte anges |
Användar-id | Obligatorisk. | Sätts automatiskt enligt VR149 |
Efternamn | Obligatorisk. | Sätts automatiskt enligt VR149 |
Förnamn | Obligatorisk. | Sätts automatiskt enligt VR149 |
Telefon | Inga kontaktuppgifter får anges för apotekspersonal. Telefonnummer till arbetsplatsen hämtas från Expeditionsställeregistret utifrån angiven GLN-kod för arbetsplatsen vid läsning. | |
Tillgänglig för patient |
Får inte anges | Får inte anges |
Telefonnummer |
Får inte anges | Får inte anges |
Telefonnummer tillhör |
Får inte anges | Får inte anges |
Rangordning |
Får inte anges | Får inte anges |
Arbetsplats | Obligatoriskt att ange information om apotekspersonals arbetsplats. Med undantag för arbetsplatsnamn som hämtas från Expeditionsställeregistret utifrån angiven GLN-kod för arbetsplatsen vid läsning. |
Information om arbetsplats autokompleteras för uppdragsgivaren. Med undantag för arbetsplatsnamn som hämtas från Expeditionsställeregistret utifrån angiven GLN-kod för arbetsplatsen vid läsning. |
Arbetsplats-id |
Obligatorisk. |
Sätts automatiskt enligt VR149 |
Arbetsplats-id typ |
Obligatorisk | Sätts automatiskt enligt VR149 |
Arbetsplatsnamn |
Får inte anges | Får inte anges. |
Arbetsplatstyp |
Obligatorisk. Giltigt värde "Apotek", valideras enligt VR110. |
Sätts automatiskt enligt VR149 |
Adressuppgift |
Får inte anges för apotekspersonal, med undantag för Landskod på utföraren. Adressuppgifter hämtas från Expeditionsställeregistret utifrån angiven GLN-kod för arbetsplatsen vid läsning. |
|
Adresstyp |
Får inte anges | Får inte anges |
Adress |
Får inte anges | Får inte anges |
Postort |
Får inte anges | Får inte anges |
Postnummer |
Får inte anges | Får inte anges |
Landskod |
Valfritt. Om angivet giltigt värde "SE". |
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. Reglerna finns beskrivna i Generella verksamhetsregler.
Tabell 6 . Generella verksamhetsregler som används i denna tillämpningsanvisning
Regel-id |
Regelnamn |
---|---|
VR025 | Validering av anropande apotek mot Expeditionsställeregistret |
VR030 | Expediering och händelsetyper |
VR033 | Validering av legitimation mot Legitimationsregistret |
VR034 |
Validering av händelsens utförare mot intyget |
VR035 | Hantera expeditions-id/krediterande expeditions-id |
VR036 | Giltiga värden i förmånsval |
VR037 | Hantering av AFF-varningar vid expedition |
VR038 | Expedition till unik person |
VR039 | Validering av anropande apotek mot intyget |
VR041 | Komplettera legitimationskod från Legitimationsregistret utifrån personnummer i intyget |
VR051 | Kontroll av expeditionstidpunkt eller krediteringstidpunkt |
VR099 |
Förändring av dosunderlagets status och version |
VR102 | Kontroll av att dubblettanrop inte sker från anropande system |
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 |
VR123 | Uttagsversion |
VR144 | Yrkeskod eller utökad yrkeskod måste anges |
VR149 | Information om uppdragsgivare kompletteras när produktionsuttag godkänns |
VR151 | Kontrollera uttagsstatus |
VR153 | Helförpackningsuttag och dosdispenserade uttag får inte blandas i en expediering som registreras |
VR164 | Kontroll av aktörens expeditions-id |
VR168 | Dubblettkontroll uttag |
3.2. Automatiska kompletteringar
Automatisk komplettering innebär att E-hälsomyndigheten tillför information för vissa attribut enligt specificerade regler. Reglerna finns beskrivna i Automatiska kompletteringar
Tabell 7. Automatiska Kompletteringar som används i denna tillämpningsanvisning
Regel-id |
Regelnamn |
---|---|
Auto06 |
Versionsnummer för patients läkemedelslista genereras |
Auto07 | Komplettering av tidpunkt för händelse |
Auto33 | Händelsen kompletteras med ett händelse-id |
Auto38 | Komplettering av logiskt id för uttag |
3.3. Specifika verksamhetsregler
Verksamhetsregler beskriver validering och verksamhetslogik som E-hälsomyndigheten ansvarar för.
Tabell 8. Specifika verksamhetsregler
Regel-id |
Regelnamn |
Beskrivning av regel |
Felkod och felmeddelande |
---|---|---|---|
R002 |
Endast dosdispenserade förskrivningar kan expedieras om dosdispenserat uttag görs. |
Kontroll att expedierade förskrivningar är dosdispenserade. |
2-25-26 Endast dosdispenserade förskrivningar kan expedieras |
R006 |
Uttagsdosering får ej anges för uttag på dosdispenserad förskrivning | Kontroll att ingen uttagsdosering är angiven vid produktionsuttag. Dosering från expedierad förskrivningsversion används alltid.
|
2-25-175 Uttagsdosering kan ej anges på uttag tillhörande en dosdispenserad förskrivning. |
3.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 och kontrollsamlingarna beskrivs detaljerat på sidan Automatiska format- och författningskontroller (AFF-kontroller).
Vid expediering körs EXP-kontrollerna.
3.5. Formatkontroller
E-hälsomyndigheten gör formatkontroller på vissa attribut i Nationella läkemedelslistan. Reglerna finns beskrivna i Formatkontroller.
Tabell 9. Formatkontroller som används i denna tillämpningsanvisning
Id |
Beskrivning |
---|---|
FK004 | Enkel textvalidator |
4. Presentationskrav
Inga specifika presentationskrav finns för denna tillämpningsanvisning.
5. Rekommendationer
REKOMMENDATION
För alla förskrivningar som skapats via en aktör ansluten via versionspaket 17.1 kommer uppgift om "Förmånsvillkor uppfyllda" endast att anges i doseringstexten. Det är alltid informationen i doseringstexten som gäller i dessa fall. Vid expediering av dessa förskrivningar kommer AFF-varning, P.103 returneras. Expedierande apotekspersonal bör uppdatera förskrivningen med flagga för "Förmånsvillkor uppfyllda" innan expediering för att underlätta vid nästa expediering.
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 |
Borttagna verksamhetsregler
Nya verksamhetsregler
Förtydligat hur accepterade varningar hanteras VR037, informerat om att kontroll kommer införas som innebär att accepterade varningar enbart kan anges vid delfunktion 2 - Godkänn produktionsuttag Språkliga förbättringar för bättre läsbarhet |
1.2 | 2022-05-25 | 21.2 |
Förbättringar dokumentation
|
1.3 | 2022-11-10 | 21.4 |
Förbättringar dokumentation
|
1.4 | 2023-05-04 | 21.5 |
Förbättringar dokumentation
|
1.5 | 2023-08-24 | 21.6 |
Förbättringar dokumentation
|
1.6 | 2023-11-09 | 21.7 |
Förbättrad hantering expeditions-id. Nytt är att expeditions-id som hämtas via tjänsten HamtaExpeditionsIdService kan anges. Om ett expeditions-id anges kontrolleras att det är unikt enligt VR035. Samt att alla uttag expedieringen har samma Expeditions-id valideras i AFF |
1.7 | 2024-02-22 | 21.8 |
Förbättringar dokumentation
|
1.8 | 2024-05-06 | 21.9 |
Förändring:
|
1.9 | 2024-08-26 | 21.10 |
Ny informationsruta med förtydligande av villkor under rubrik 2.4 Efterfrågad information. |