Differences

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

--- fmk:1.6.0:services:hent_aendringslog_for_dispenseringsperiode [2025-10-29 09:48] – [Hent ændringslog for dispenseringsperiode] lbdo
+++ fmk:1.6.0:services:hent_aendringslog_for_dispenseringsperiode [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== TODO ======
-  * SDSTB-131
-  * Beskrivelse af status i "Regler"-afsnittet
-  * Eksempel på XSD-svar i stedet for det gamle brødtekst-eksempel
 ====== Hent ændringslog for dispenseringsperiode ======
-FMK har i [[fmk:1.6.0:services:Hent Medicinkort som PDF|Hent dispenseringskort som PDF]] indført en ændringsliste mellem 2 dispenseringsperioder, således at man ved en hurtig gennemgang kan se hvilke lægemiddelordinationer der er tilføjet, fjernet, og opdateret i en given periode, plus eventuelle substitutioner der er foretaget af de udleverede lægemidler.
+FMK har i [[fmk:1.6.0:services:Hent Medicinkort som PDF|Hent dispenseringskort som PDF]] indført en ændringsliste mellem 2 dispenseringsperioder, således at man ved en hurtig gennemgang kan se, hvilke lægemiddelordinationer der er tilføjet, fjernet, og opdateret i en given periode, plus eventuelle substitutioner, der er foretaget af de udleverede lægemidler.
-I starten var dette tiltænkt apoteket således de, sammen med borgeren, kunne lave en hurtigt gennemgang når patienten hentede deres dosisdispensering på apoteket, og borgeren kunne også få en udskrift at dette med hjem. Efterfølgende, og i forbindelse med at hjemmeplejen begyndte at hente mere struktureret data omkring dosisdispensering ned fra FMK ind i eget system, blev der fremstillet at krav omkring visningen af en difference-liste mellem de nuværende og næste periode. En service til dette udstilles derfor i FMK 1.6.0.
+I starten var dette tiltænkt apoteket således at de, sammen med borgeren, kunne lave en hurtigt gennemgang, når borgeren hentede sin dosisdispensering på apoteket, og borgeren kunne også få en udskrift at dette med hjem. Efterfølgende, og i forbindelse med at hjemmeplejen begyndte at hente mere struktureret data omkring dosisdispensering ned fra FMK ind i eget system, blev der fremstillet at krav omkring visningen af en difference-liste mellem de nuværende og næste periode. En service til dette udstilles derfor i FMK 1.6.0.
-====== Forespørgsel ======
+===== Forespørgsel =====
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetDispensingPeriodChangelogRequestType|Forespørgsel]]
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetDispensingPeriodChangelogRequestType|Request]]
 I forespørgslen angives først patientens ''PersonIdentifier''. Er der tale om dispenseringskort til organisationer, angives i stedet organisationens ''OrganisationIdentifier''.
-Hernæst angives ''DispensingCardIdentifier'' for dét dispenseringskort, som der ønskes ændringslog for. Hernæst ID'er på tidligere og nuværende dispenseringsperioder, ''PreviousDispensingPeriodIdentifier'' og ''CurrentDispensingPeriodIdentifier''. Disse er begge obligatoriske, idet en ændringslog kræver at vi har en tidligere pakket/ophældt periode at sammenligne med.
+Hernæst angives ''DispensingCardIdentifier'' for dét dispenseringskort, som der ønskes ændringslog for. Hernæst ID'er på tidligere og nuværende dispenseringsperioder, ''PreviousDispensingPeriodIdentifier'' og ''CurrentDispensingPeriodIdentifier''. Disse er begge obligatoriske, idet en ændringslog kræver, at der er en tidligere pakket/ophældt periode at sammenligne med.
 ==== Regler omkring visning af ændringsloggen ====
-For at undgå at ændringsloggen skaber forvirring, kræves det at den periode som man ønsker en ændringslog for er pakket færdig på det tidspunkt man henter ændringsloggen. Dvs at perioden skal have en af følgende status: ''Pakning afsluttet'', ''Ekspederet'' eller ''Kasseres'' inden FMK forsøger at lave en ændringslog for perioden. Dette skal sikre at der ikke bliver printet en ændringslog mens perioden fx stadig er under planlægning, og der kunne ske yderligere ændringer inden den bliver pakket og kommer ud til borgeren.
+For at undgå at ændringsloggen skaber forvirring, kræves det at den periode, som man ønsker en ændringslog for, er pakket færdig, på det tidspunkt man henter ændringsloggen. Dvs. at ifm. dosisdispensering skal dispenseringsperioden have en af følgende status: ''Pakning afsluttet'', ''Ekspederet'' eller ''Kasseres'' inden FMK forsøger at lave en ændringslog for perioden. Dette skal sikre, at der ikke bliver printet en ændringslog, mens perioden fx stadig er under planlægning, og der kunne ske yderligere ændringer, inden den bliver pakket og kommer ud til borgeren.
 Denne regel vil som udgangspunkt altid være opfyldt for manuel dispensering, såfremt perioden er oprettet via
@@ Line 36: / Line 33: @@
-====== Svar ======
+===== Svar =====
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetDispensingPeriodChangelogResponseType|Svaret]] indeholder først den ''PersonIdentifier'' eller ''OrganisationIdentifier'', som blev angivet i forespørgslen. Herefter forekommer en række elementer, som repræsenterer forskellige typer ændringer fra den ene periode til den anden.
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetDispensingPeriodChangelogResponseType|Response]]
+Svaret fra FMK indeholder først den ''PersonIdentifier'' eller ''OrganisationIdentifier'', som blev angivet i forespørgslen. Herefter forekommer en række elementer, som repræsenterer forskellige typer ændringer fra den ene periode til den anden.
 Ændringer er opdelt i 4 typer hændelser:
   * ''PlannedAdministrationAdded'', Tilføjet ordination. Det vil sige en ny planlagt administration, som er tilføjet til kortet siden den sidste periode blev sat klar til pakning eller ophældt. I denne gruppering kigges der ikke på status af doseringen, pakningen eller pausering.
-  * ''PlannedAdministrationRemoved'', Fjernet ordination. Det vil sige en planlagte administration som er fjernet fra kortet siden den sidste periode blev sat klar til pakning eller ophældt. I denne gruppering kigges der ikke på status af doseringen, pakningen eller pausering.
+  * ''PlannedAdministrationRemoved'', Fjernet ordination. Det vil sige en planlagt administration, som er fjernet fra kortet siden den sidste periode blev sat klar til pakning eller ophældt. I denne gruppering kigges der ikke på status af doseringen, pakningen eller pausering.
-  * ''PlannedAdministrationUpdated'', Ændringer i dosering. Doseringsændringer bestemmes ud fra at kigge på den planlagte administration som den så ud på det tidspunkt hvor begge perioder blev sat klar til Pakning eller ophældt, og så sammenlige den daglige dosis på alle dagene i den nye periode. Dette vil sige der sammenlignes ikke mellem 1. dag i den tidligere periode med 1. dag i den nye periode, det sammenlignes udelukkende de 2 doseringer på 1. dag i den nye periode.
+  * ''PlannedAdministrationUpdated'', Ændringer i dosering. Doseringsændringer bestemmes ud fra at kigge på den planlagte administration, som den så ud på det tidspunkt, hvor begge perioder blev sat klar til pakning eller ophældt, og så sammenligne den daglige dosis på alle dagene i den nye periode. Det vil sige, at der sammenlignes ikke mellem 1. dag i den tidligere periode med 1. dag i den nye periode; der sammenlignes udelukkende de 2 doseringer på 1. dag i den nye periode.
-  * ''DrugSubstitution'', Substitution af lægemiddel. Dette element forekommer for de planlagte administrationer som blev pakket/ophældt i begge perioder, og hvor der er forskel på hvilket lægemiddel der blev pakket/ophældt i de 2 perioder. For dosisdispensering afgøres dette ved at se om der er forskel på det drug-id som endeligt blev valgt af pakkeapoteket at pakke i de 2 perioder. Hvis ikke pakkeapoteket laver substitution ved pakningen, vil det være den substitution som udleveringsapoteket har valgt som benyttes, har udleveringsapoteket ikke substitueret, vil der være lægemiddelordinationens lægemiddel som benyttes.
+  * ''DrugSubstitution'', Substitution af lægemiddel. Dette element forekommer for de planlagte administrationer, som blev pakket/ophældt i begge perioder, og hvor der er forskel på hvilket lægemiddel, der blev pakket/ophældt i de 2 perioder. For dosisdispensering afgøres dette ved at se om der er forskel på det drug-id som endeligt blev valgt af pakkeapoteket at pakke i de 2 perioder. Hvis ikke pakkeapoteket laver substitution ved pakningen, vil det være den substitution som udleveringsapoteket har valgt som benyttes, har udleveringsapoteket ikke substitueret, vil der være lægemiddelordinationens lægemiddel som benyttes.
 En specifikt type hændelse vil kun fremgå i svaret, såfremt der faktisk er sket en ændring mellem sidste dispenseringsperiode og den nuværende.
-**Bemærk:** Hvis samme ordination både fjernes og herefter igen tilføjes til kortet mellem de 2 periode, vil dette fremgå i ændringsloggen som om ordinationen både er tilføjet og fjernet. Dette gøres fordi det for FMK menes som værende 2 forskellige planlagte administrationer, selv om det er på samme ordination.
+**Bemærk:** Hvis samme ordination både fjernes og herefter igen tilføjes til kortet mellem de 2 periode, vil dette fremgå i ændringsloggen som om ordinationen både er tilføjet og fjernet. Dette gøres fordi det for FMK menes som værende 2 forskellige planlagte administrationer, selvom det er på samme ordination.
 == Eksempler ==
-Herunder vises et billede med nogle ændringer, og om FMK vil kategorisere dem som værende doseringer-ændringer i forhold til ændringsloggen. Forklarelse af billeder følger efter.
-{{:fmk:1.4.4:dd_dosagechange.png?direct| eksempler}}
+I dette eksempel er en ordination på primcillin blevet tilføjet til den nye dispenseringsperiode, og panodil er blevet substituteret med pamol. Derudover er der doseringsændring i lægemiddelordinationen med ID 13412309480913.
-**En kort forklaring:** De grønne, blå og gule pile angiver de 2 perioder som der sammenlignes på i forbindelse med ændringsloggen. Første pil er den forrige periode, den næste er den nye periode som ændringsloggen tilhører. Hvis denne pil har en anden farve end grøn, betyder det at der er en (mulig) ændring i den daglige dosering. Under hver sæt pille er en eller 2 kasser med en kort doserings-tekst som beskriver doseringen da forrige og nye periode blev sat klar til pakning. Hvis der kun er 1 box er der ikke blevet ændret i den planlagte dosering imellem de 2 perioder.
-  - Eksempel er der ikke ændret i doseringen mellem de 2 perioder, derfor har nye periode samme farve som forrige. Og denne planlagte dispensering komme ikke i ændringsloggen.
-  - Eksempel var der allerede planlagt inden forrige perioder sat klar til pakning, at der fra den nye periode skulle gives en anden doseringen. Og dette har ikke ændret sig inden den nye periode blev sat klar til pakning. Derfor ses dette ikke som en doseringsændring da den nye doseringen i perioden allerede var planlagt.
-  - Eksempel viser at der i forrige periode var planlagt 1 tablet dagligt i den nye periode, da den forrige blev pakket, men dette har ændret sig i mellemtiden, og den nye dosering har ikke samme daglige dosis som den forrige. Dette ses som en dosis-ændring og vil blive markeret i ændringsloggen.
-  - Eksempel viser det samme som forrige eksempel, her er der dog lavet en doserings-ændring som ikke giver en ændring i den daglige dosis. 0,5 tablet 2 gang dagligt, giver samme samlede dosis som 1 tablet 1 gang dagligt. Dette ses derfor ikke som en doserings-ændring, og vil ikke blive fremhævet i ændringsloggen.
-  - Eksempel viser at hvis man laver en lavere dosis, i steder for hævet som i eksempel 3, så ses dette også som en doserings-ændring, og vil blive fremhævet i ændringsloggen.
-  - Eksempel viser at selv om doseringen hen over en gentagelses-periode er den samme, hvis der skiftes hvilke dage den gives på, betegnes dette også som en doserings-ændring og vil blive fremhævet i ændringsloggen.
-  - Eksempel viser at hvis man sænker gentagelses-perioden for doseringen, men stadig rammer præcis de samme dage med den samme dosering som førhen, er dette ikke en ændring. Rammer der dog derimod andre dag, vil det ses som en dosis-ændring og vil komme i ændringsloggen. Dette eksempel viser specielt at der kigges på de specifikke dage, og ikke på om doseringen blive ens hvis de sammenlignes direkte.
+<file xml GetDispensingPeriodChangelogResponse.xml>
+<GetDispensingPeriodChangelogResponse>
+    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
+    <PlannedAdministrationAdded>
+        <PlannedAdministrationIdentifier>24342897402453</PlannedAdministrationIdentifier>
+        <DrugMedicationIdentifier>778719384721</DrugMedicationIdentifier>
+        <Drug>
+            <Identifier date="2012-08-06" source="Medicinpriser">28100902676</Identifier>
+            <Name>Primcillin</Name>
+            <ATC>
+                <Code date="2012-08-06" source="Medicinpriser">J01CE02</Code>
+                <Text>Phenoxymethylpenicillin</Text>
+            </ATC>
+            [...]
+        </Drug>
+        <TranslatedDosageText>2 tabletter morgen</TranslatedDosageText>
+    </PlannedAdministrationAdded>
+    <PlannedAdministrationUpdated>
+        <PlannedAdministrationIdentifier>12384127349712</PlannedAdministrationIdentifier>
+        <DrugMedicationIdentifier>13412309480913</DrugMedicationIdentifier>
+        <OldTranslatedDosageText>2 stk 2 gange daglig</OldTranslatedDosageText>
+        <NewTranslatedDosageText>2 stk 3 gange daglig</NewTranslatedDosageText>
+    </PlannedAdministrationUpdated>
+    <DrugSubstitution>
+        <PlannedAdministrationIdentifier>1234216789234</PlannedAdministrationIdentifier>
+        <DrugMedicationIdentifier>9870979817234</DrugMedicationIdentifier>
+        <PreviousDrug>
+            <Identifier date="2012-08-06" source="Medicinpriser">134123412341</Identifier>
+            <Name>Panodil</Name>
+            <ATC>
+                <Code date="2012-08-06" source="Medicinpriser">N02BE01</Code>
+                <Text>Paracetamol</Text>
+            </ATC>
+            [...]
+        </PreviousDrug>
+        <NewDrug>
+            <Identifier date="2012-08-06" source="Medicinpriser">134123412341</Identifier>
+            <Name>Pamol</Name>
+            <ATC>
+                <Code date="2012-08-06" source="Medicinpriser">N02BE01</Code>
+                <Text>Paracetamol</Text>
+            </ATC>
+            [...]
+        </NewDrug>
+    </DrugSubstitution>
+</GetDispensingPeriodChangelogResponse>
+</file>