Differences

This shows you the differences between two versions of the page.

--- fmk:1.6.0:intro:dispensering [2026-06-01 09:55] – [Step 2: Planlagt administration] sas
+++ fmk:1.6.0:intro:dispensering [2026-06-03 11:05] (current) – sas
@@ Line 1: / Line 1: @@
 ====== Dispensering i FMK 1.6 ======
-**Siden er ikke færdig, der vil komme flere forklarende billeder og alternative workflow**
 Dispensering i FMKs 1.6 snitflade er en udvidelse af Dosisdispensering som blev indført i FMK's 1.4.6.E3 snitflade. Med udgangpunkt i de dataformater og services som blev introduceret dengang, udvides og generaliseret modellen nu til at fælles datamodel for både dosisdispensering fra apotekerne, men også for den manuelle ophældning som sker ved bl.a. hjemmeplejen.
 Målet med at udvidelsen til også at inkludere hjemmeplejens ophældninger er at skabe et fælles overblik over patientens pakkede medicin, med indsigt i den pakkede medicin kan en læge fx vælge af udskift en dosis-ændring til næste ophældning (så længe det er klinisk ansvarligt) og dermed mindske presset på apotek/hjemmepleje, som ellers skulle ud i akutte ompakninger.
-Der understøttes 2 forskellige workflows for dispensering i FMK 1.6.
+**Der understøttes 2 forskellige workflows for dispensering i FMK 1.6.**
-Apotekernes Dosisdispensering er et af disse workflow som kendetegner sig med en større række status-skift på allerede planlagte dispenseringsperioder, og flere muligheder for substitution igennem processen.
+**Apotekernes dosisdispensering** er et af disse workflow som kendetegner sig med en større række status-skift på allerede planlagte dispenseringsperioder, og flere muligheder for substitution igennem processen.
-Manuel ophældning er det andet nye workflow som rettes mod bl.a. hjemmeplejen hvor der ikke er samme koordinations-proces mellem 2 organisation (udleverings og pakkeapotek) og hvor processen er mere lige til med at foretage en ophældning og herefter skal denne registeres.
+**Manuel ophældning** er det andet nye workflow som rettes mod bl.a. hjemmeplejen hvor der ikke er samme koordinations-proces mellem 2 organisation (udleverings og pakkeapotek) og hvor processen er mere lige til med at foretage en ophældning og herefter skal denne registeres.
-De 2 workflow gennemgås længere nede på siden, men først lidt omkring opsætningen af et nyt dispenseringskort, da denne proces er den samme i de 2 workflow.
+De 2 workflow gennemgås længere nede på siden, men først lidt omkring opsætningen af et nyt dispenseringskort og planlagte administrationer hertil, da denne proces er den samme i de 2 workflow.
 ===== Step 1: Dispenseringskortet =====
@@ Line 31: / Line 28: @@
 Planlagt administration fungere som en administrationsplan for en given lægemiddelordination og skal tilknyttes til dispenseringskortet inden man kan få pakningen af medicinen registeret på FMK.
-**Bemærk:** Det skal pointeres her at i FMK vil dispensering af medicin bør kun benyttes for medicin som pakkes/hældes op til patienten i X dage. Eventuelle lægemiddelordinationer som administreres dagligt, eller som patienten selv håndtere, er ikke en del af det FMK betegner som dispensering eller planlagt administration. Systemer er velkommende til at anvende andre begreber i deres egen UI til deres brugere (Ophældnings-plan/skema, Planlæg DD-medicin, el.lign), hvis det bedre beskriver termer som deres brugere arbejder med i dag. Dermed ikke sagt at FMK ændre i vores navngivning.
+** Det skal pointeres her at i FMK bør dispensering af medicin, og registreringen af dette, kun benyttes for medicin som pakkes/hældes op til patienten i X dage (dosis-ruller, doseringsæsker o.lign). Eventuelle lægemiddelordinationer som administreres dagligt, eller som patienten selv håndtere, er ikke en del af det FMK betegner som dispensering eller planlagt administration.**
+**Systemer er velkommende til at anvende andre begreber i deres egen UI til deres brugere (Ophældnings-plan/skema, Planlæg DD-medicin, el.lign), hvis det bedre beskriver termer som deres brugere arbejder med i dag. Dermed ikke sagt at FMK ændre i vores navngivning.**
 Den planlagte administration kan ses som værende den ansvarlige organisations fortolkning af lægens dosering, og har også er også udformet efter en basic struktureret dosering.
@@ Line 59: / Line 58: @@
 {{:fmk:1.6.0:intro:hentdispenseringskort.drawio.png|}}
+I svaret fra service en større mængde data, en visuel beskrivelse kommer herunder. Vi anbefaler man åbner billeder i et nyt vindue så man nemmere kan zoome.
+{{:fmk:1.6.0:intro:dispensingcard2.drawio.png|}}
 Service-beskrivelse: [[fmk:1.6.0:services:hent_dispenseringskort|her]]
@@ Line 76: / Line 79: @@
 Nyt i 1.6 for apotekets workflow generelt er at man ved enhver opdatering af en dispenseringsperiode (også statusskift) skal angive versionsnummeret på den nuværende version af perioden i sin forespørgsel, og FMK validere at dette er den seneste version inden. Dette skal forsøge at forhindre at apoteket foretager kalde i blinde uden at vide hvilken status perioden burde være i.
+**Der præsenteres først det "primære" workflow med at få pakket en dosisrulle fra oprettelse af perioden til effektuering ved apoteket. Der findes en række alternative workflow som præsenteres efterfølgende, disse omhandler fx hvad man gør hvis der sker fejl under processen og man ønsker at afbryde pakningen undervejs**
 ===== Pakning af en dispenseringsperiode =====
 Frem mod en pakning er der yderligere data som apoteket skal have oprettet, inden de for lov til at sende en dispenseringsperiode til pakning ved pakkeapoteket.
@@ Line 89: / Line 93: @@
 ==== Step A2: Register substitutionskladder (Optionelt) ====
-Frem mod en pakning kan apoteket registrere de forventede substitutions for hver planlagt administration i en substitutions-kladde. En kladde kan kun "oprettes", ønsker man at ændre hvilken substitution man forventer at bruge, opretter man en ny kladde, og den gamle slettes. FMK supportere ikke ikke versionering af kladderne.
+Frem mod en pakning kan udleveringsapoteket registrere hvilket lægemiddel man ønsker at få pakkes (alt efter hvad der er i sortiment) for hver planlagt administration i en substitutions-kladde. En kladde kan kun "oprettes", ønsker man at ændre hvilken substitution man forventer at bruge, opretter man en ny kladde, og den gamle slettes. FMK supportere ikke ikke versionering af kladderne.
+**FMK kalder det for en "substitutions"-kladde, vel vidende at apoteket måske har andre ord som bedre ville beskrive at mange vælger det lægemiddel som skal pakkes. Konceptet set fra FMKs vinkel er dog at hvis udleveringsapoteket skal have pakket noget andet end det som står på lægemiddelordinationen, så anses det som en substitution af det som lægen har ordineret, derfor kalder vi det en substitution. Systemerne er velkommende til at give processen et andet navn i deres UI.**
+Dette step erstatter angivelsen af substitution direkte sammen med den planlagte administration i 1.4 snitfladen, hvor "Planlagt dispensering" indeholdte både angivelsen af en substitution og den planlagte administration. Der er flere grunde til at FMK har flyttet substitutionen ud som et separat workflow.
+  - er fordi vi oplevede at antallet af gange hvor der skulle laves "fulde" opdateringer, blot for at skifte hvilket lægemiddel udleveringsapoteket ønskede pakket, resulterede i en stor mængde redundant data.
+  - Hjemmeplejen har ikke samme brug for substitutions-angivelse før pakningen
+  - Vedligeholdelse af den planlagte administration behøves i 1.6.0 KUN ske når lægen opdatere lægemiddelordinationen.
+Substitutionskladder tillader at apoteket forsat kan "klargøre" deres pakning frem mod den deadline man har overfor pakkeapoteket, blot på en simplere måde som er specifikt for deres workflow, og resultere i mindre redundant data.
 Hvis apoteket ønsker at anvende de substitutionskladder man har oprettet, skal dette angives når en periode sættes "Klar til pakning" i step A3.
@@ Line 145: / Line 158: @@
 ===== Alternative workflow ved apoteket =====
-**TODO**
+Workflowet beskrevet ovenover er det mest basale process fra klaring til udlevering af en dosisdispenseringsperiode, hvor alt går godt fra start til slut. Det er ikke altid tingende kører så flydende, og der kan ske fejl i processen som der så skal rettes op på inden man sikkert kan pakke og udlevere medicinen til borgeren.
+==== AA-1: Medicin-ændringer efter "Klar til pakning" men før "Pakning påbegyndt" ====
+Når udleveringsapoteket har sat "Klar til pakning" er det normalt 100% klar til at pakkeapoteket kan sætte gang i deres pakningsproces, og FMK har valideret og accepteret der data er korrekte. Der vil dog typisk gå noget tid mellem udleveringsapoteket har overgivet perioden, til pakkeapoteket går i gang med deres proces. Hvis der skulle ske noget i det tidsrum som kræver at der foretages ændringer i den plan som pakkeapoteket pakker efter, skal perioden tages tilbage til udleveringsapoteket så ændringerne kan arrangeres inden perioden igen kan sendes tilbage til pakkeapoteket.
+=== Service: Afbryd håndtering af dispenseringsperiode ===
+Service kan anvendes på perioder som er i "Klar til pakning" eller "Effektueres ikke", men er primært kritisk brugt på "Klar til pakning". Servicen foretager valideringen af perioden (ID, version, Status mm). Og hvis alt er i orden, flytter periodens status tilbage til "Planlagt".
+Såfremt at perioden var i "Klar til pakning" vil brugen af denne service også nedlægge de dispenseringer som blev registeret i Step A3 (Start håndtering). Dermed er der igen låst op for ændringer af den medicin som pakkes i perioden, og udleveringsapoteket kan lave opdateringer af deres planlagte administration + eventuelt substitutionskladder.
+Når de nødvendige ændringer er foretaget til den planlagte administration, kan man genstarte processen fra Step A3.
+Servicebeskrivelse findes [[fmk:1.6.0:services:afbryd_handtering_af_dosisdispenseringsperiode|her]]
+==== AA-2: Afbrydning af pakning ved pakkeapoteket ====
+Såfremt perioden er overtaget at pakkeapoteket (status "Pakning påbegyndt"), er den låst til pakkeapoteket, dvs udleveringsapoteket har ingen mulighed for at trække perioden tilbage såfremt der er ændringer. Der kan dog være situationer hvor man alligevel er nødt til at flytte periodens status tilbage igen for at udbedre fejl eller mangler.
+=== Service: Afbryd pakning ===
+Service kan benyttes mens perioden er i enten "Pakning påbegyndt" eller "Pakning afsluttet", og vil resultere i at perioden flyttes tilbage til "Klar til pakning".
+Hvis der er tale om fejl ved pakkeapoteket som gør perioden skal pakkes om, kan de blot med det samme forsætte med Step A4 igen.
+Hvis der er tale om at udleveringsapoteket skal foretage ændringer, skal AA-1 anvendes, for at yderligere afbryde håndteringen af perioden, så perioden kommer tilbage i "Planlagt", hvor ændringer i den planlagte administration kan finde sted.
+Servicebeskrivelse findes [[fmk:1.6.0:services:afbryd_pakning|her]]
+==== AA-3: Tilbagefør udlevering ====
+Hvis man er nået så langt at udleveringen er blevet fortaget, og medicinen er afsendt til patienten eller hentet på apoteket. Er processen normalt slut, og man kigger kun fremad mod næste pakning.
+Man kan dog komme i en situation hvor man bliver nødt til at tilbageføre udleveringen, såfremt medicinen er kommer return til apoteket. Fx hvis medicinen ikke er blevet afhentet ved udleveringsstedet, eller patienten kommer tilbage med deres rulle.
+=== Service: Tilbagefør effektuering af dispenseringsperiode ===
+Service kan anvendes mens perioden er i status "Effektueret", og resultere i at perioden flyttes tilbage til status "Pakning afsluttet".
+Derudover så resultere servicen i at de registrerede udleveringer som blev foretaget i Step A7 bliver fjernet igen, da man forventer at alt medicinen er blevet trukken tilbage samlet. Det er muligt så at flytte perioden tilbage igennem AA-2 og AA-1 for at komme tilbage til "Planlagt" hvis medicinen skal ændres. Men i de fleste tilfælde vil man nok i stedet anvende AA-4 for at kassere perioden helt og starte forfra, fx med an akut periode hvis der skal pakkes hurtigere end normalt.
+Servicebeskrivelse findes [[fmk:1.6.0:services:tilbagefor_effektuering_af_dispenseringsperiode|her]]
+==== AA-4: Kassering af dispenseringsperiode ====
+Såfremt man helt ønsker at stoppe processen, eller stoppe indtagelse af rullen, bør man i FMK gøre dette ved at kassere dispenseringsperioden.
+Kasseringen betyder effektivt at man opgiver den pågældende periode, og man ikke foretager yderligere handlinger.
+=== Service: Kasser dispenseringsperiode ===
+Hvis perioden er i status "Effektueret" resultere kasseringen i at perioden får status "Kasseres", dette signalere at den er/bør kasseres ved patienten. Ved alle andre statusser resultere kasseringen i at perioden får status "Ikke udleveret af apoteket", da FMK forventer perioden er i apotekets kontrol når man kassere den.
+Service kan så længe perioden IKKE har en af følgende status: "Pakning påbegyndt", "Kasseres" eller "Ikke udleveret af apoteket".
+Kasseringen kan ikke finde sted i "Pakning påbegyndt" fordi der har pakkeapoteket låsen, og de forventer at skulle pakke med mindre de bliver direkte kontaktet af udleveringsapoteket, og dette sker udenom FMK.
+De 2 sidste giver forhåbentlig lidt sig selv, hvis perioden allerede er kasseret, giver det ikke mening at gøre det igen.
+I 1.6 er der tilføjet en mulighed for at angive en Årsag til kasseringen, denne kan anvendes af apoteket såfremt man det giver mening at signalere hvorfor medicinen ikke udleveres eller rullen stoppes før tid.
+Servicebeskrivelse findes [[fmk:1.6.0:services:kasser_dispenseringsperiode|her]]
+==== AA-5: Fejl i kassering af dispenseringsperiode ====
+Skulle kasseringen af en dispenseringsperiode ske ved en fejl, er der mulighed for at fortryde denne handling.
+=== Service: Fortyd Kassering af dispenseringsperiode ===
+Hvis perioden er i enten status "Kasseres" eller "Ikke udleveret af apoteket" er det muligt at fortryde kasseringen af den pågældende dispenseringsperiode, og få perioden returneret til den status den havde før kasseringen.
+Bemærk dog at der foretages valideringer af at perioden stadig passer ind med de andre dispenseringsperioder på dispenseringskortet. Er der fx oprettet en ny periode som overlapper med den kasserede i mellemtiden, vil FMK ikke acceptere fortrydelsen, da det vil kunne resultere i perioder med overlappende gyldighed, hvilket ligner dobbelt-dosis.
+Servicebeskrivelse findes [[fmk:1.6.0:services:fortryd_kassering_af_dispenseringsperiode|her]]
 ====== Workflow ved manuel dispensering ======
 Workflowet med at registrere ophældning af medicin igennem dispensering i FMK 1.6 er simplificeret en del. Dette skyldes bl.a. at mange af de forlæggende handlinger med at anskaffe medicinen allerede er dokumenteres på FMK, igennem Udleveringer på udleveringsgrundlag. Og der er heller ikke nogen brug for et "bestillings" workflow som ved apoteket. Registreringen af ophældningen er derfor kogt ned til 1 service, som kan anvendes med meget få oplysninger omkring den pakkede medicin, og så tager FMK automatisk udgangspunkt i de planlagte administrationer til at danne en fuld dispenseringsperiode.
@@ Line 167: / Line 243: @@
 Såfremt man anvendes systemkald til at foretage sin registrering, er det vigtigt man er ops på at man helst skal angive dato hvor det pakkede medicin starter. Dette så man undgår at FMK anvender "dags-dato" som start, hvis den faktisk ophældning var sket aftenen før, men brugeren først har fået netværksadgang efter midnat.
-Til forskel for apotekets workflow har det manuelle workflow ikke lige så meget fokus på substitution. Vi tillader at man registrere hvilke udleveringer der er anvendt for den givene planlagt administration, og systemer kan derigennem finde frem til det pågældende lægemiddel. Desuden har vi tidligere blevet oplyst at til forskel fra apoteket, så kan der i en given periode sagtens anvendes forskellige substituerbare lægemidler, hvilket apotekets workflow ikke understøtter. Så frem for en meget kompliceret og uforståeligt løsning med at registrere substitutioner ned på dags/tidspunkts niveau, har vi den nuværende løsning som giver mulighed for at signalere hvilke lægemidler der er i spil, men uden at det specificeres ned i detaljer som for FMK ikke er nødvendige.
+Til forskel for apotekets workflow har det manuelle workflow ikke lige så meget fokus på substitution. Vi tillader at man registrere hvilke udleveringer der er anvendt for den givne planlagt administration, og systemer kan derigennem finde frem til det pågældende lægemiddel. Desuden har vi tidligere blevet oplyst at til forskel fra apoteket, så kan der i en given periode sagtens anvendes forskellige substituerbare lægemidler, hvilket apotekets workflow ikke understøtter. Så frem for en meget kompliceret og uforståeligt løsning med at registrere substitutioner ned på dags/tidspunkts niveau, har vi den nuværende løsning som giver mulighed for at signalere hvilke lægemidler der er i spil, men uden at det specificeres ned i detaljer som for FMK ikke er nødvendige.
 Prøvekørsel er at begreb som manuel dispensering "arver" fra dosisdispensering, hvor man ofte gerne vil kører en kontrol om FMK mener data er korrekte, men uden man faktisk ønsker at registrere at man har foretaget en ophældning. Servicen kører alle valideringer valideringer igennem og returnere fejl såfremt der findes nogen, alternativt OK såfremt en registrering ville være OK på det tidspunkt forespørgslen fandt sted. Apoteket bruger bl.a. prøvekørsler til en nattelig gennemgang af alle deres dispenseringskort, og opsamler eventuelle fejl til udbedring om morgnen.
@@ Line 174: / Line 250: @@
 ====== Alternative workflow ======
-**TODO**
+Normalt vil manuelt dispensering blot rette fejl ved at rette op på deres planlagte administration, og herefter foretage en ny ophældning.
+vi ønsker dog at supportere et alternativ til altid at skulle foretager/registrere en ny ophældning hver gang man har skulle rette noget. Skal der startes et nyt lægemiddel? Skal et lægemiddel fjernes? Skal der ændres dosering af et lægemiddel? Disse er situationer vi ønsker at understøtte man kan gøre uden at ophælde forfra.
+===== AM-1 Rettelser til ophældt periode =====
+Service kan anvendes til 4 ting for en given dispenseringsperiode.
+  * Indsætte ny planlagt administration i perioden (ophældning af ny lægemiddel)
+  * Opdatere en planlagt administration i en periode (ændre doseringen)
+  * Fjerne en planlagt administration fra en periode (lægemiddel fjernet fra ophældning)
+  * Luk dispenseringsperiode (ophældning kasseres/afsluttes før tid)
+Alle 4 kan benyttes samtidig, men man skal være forberedt på at FMK validere på indholdet, fx at man ikke tilføjer noget til en periode man samtidig forsøger at lukke. Vi forventer ikke at servicen skal bruges til efter-registrering, så man skal forvente fejl hvis man ændre i indholdet af en periode som allerede er overstået.
+Servicebeskrivelse findes [[fmk:1.6.0:services:rediger_ophaeldning|her]]