Differences

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

--- fmk:1.6.0:services:juster_doseringsaendring [2025-10-30 13:08] – [Forespørgsel] chsk
+++ fmk:1.6.0:services:juster_doseringsaendring [2026-04-28 07:32] (current) – sas
@@ Line 1: / Line 1: @@
-====== Justering af dosering i forhold til dispenseringsperiode ======
+====== Beregning af justeret dosering i forhold til dispenseringsperiode ======
-Service anvendes til planlægning af en doseringsændring i forhold til den allerede registrerede dispensering.
-**Bemærk** Denne service foretager ingen ændringer på patientens medicinkort, der er udelukkende tale om at servicen foretager udregninger og justerer på baggrund af patientens dispensering. Den medsendte dosering justeres såfremt det er muligt frem til en medsendt dato, og en en dosering indeholdende både den nuværende dosering og den nye dosering returneres.
+Servicen anvendes til at beregne, hvordan en dosering vil se ud, hvis en læge ønsker at ændre doseringen fra en bestemt dato i forhold til patientens allerede registrerede dispensering.
+Den dato, som angives for den nye dosering, betragtes som den ønskede ikrafttrædelsesdato, og resultatet beregnes i sammenhæng med de relevante eksisterende dosering og dispenseringsperioder.
+**Bemærk** Denne service foretager ingen ændringer på patientens medicinkort. Servicen returnerer udelukkende
+en forhåndsvisning af den dosering, som vil være resultatet (fra den nuværende doseringsperiode og frem), hvis ændringen gennemføres, samt advarsler i forhold til den registrerede dispensering.
+Hvis der allerede findes en aktuel struktureret dosering på lægemiddelordinationen, vil svaret indeholde:
+  * den relevante eksisterende dosering fra den aktuelle/fremadrettede del af doseringsforløbet og frem til dagen før den nye dosering starter
+  * den nye dosering fra den ønskede startdato og frem
+Hvis der er et hul mellem den eksisterende dosering og den nye dosering, indsættes en tom doseringsperiode i svaret. Dette vil samtidig medføre en advarsel i response-headeren.
+I modsætning til servicen i tidligere snitflader, beregner den nye service ikke længere alternative datoer for doseringsændringen på baggrund af dispenseringsoplysninger.
+Dispenseringsoplysninger anvendes alene til validering og til at returnere eventuelle advarsler.
 ===== Forespørgsel =====
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#adjustdosagechangerequesttype|Request]]
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#calculatedosageadjustmentrequesttype|Request]]
-I forespørgsel skal patientens ''PersonIdentifier'' angives. Herefter anvendes enten ''DrugMedicationIdentifier''  på en af patientens nuværende lægemiddelordination, eller med et ''CreateNewDrugMedication'' element såfremt man ønsker beregning foretages i forbindelse med oprettelse af en ny ordination.
+I forespørgslen skal patientens ''PersonIdentifier'' angives, samt ''DrugMedicationIdentifier'' på lægemiddelordinationen der ønskes justeret dosering på.
-I det efterfølgende ''DosagePeriod'' element angives den nye dosering, som ønskes justeret. Denne dosering bør være som Lægen ønsker doseringen skal se ud. FMK vil så forsøge bedst muligt at justere således den indsættes på den ønskedes dato såfremt det er muligt, eller give en fejl såfremt det ikke vurderes muligt uden akut håndtering.
+I det efterfølgende ''Dosage'' element angives den nye dosering, som ønskes gældende fra den ønskede startdato. Datoen for den ønskede ikrafttræden angives i den indsendte doserings
+''Precondition/ValidFrom'', som bliver startdatoen for den første doseringsperiode i den nye strukturerede dosering.
-''AdjustToDate'' elementet sættes til den dato som doseringen ønskes justeret ind til. Denne bør helst sættes til dagen efter den nuværende dispenserede periodes slutdato, men kan også sættes tidligere såfremt det ikke er klinisk forsvarligt at vente så længe. Denne værdi erstatter ''AsSoonAsPossible'' fra FMK's E4 snitflade, som kun gav mulighed for justering til kommende periode.
+Den medsendte dosering skal være struktureret. Hvis enten den nuværende eller den nye dosering ikke er angivet som struktureret,
+returneres der en fejl, da servicen ikke kan beregne resultatet på baggrund af ustrukturerede doseringer.
-Kald til denne service indebærer en række valideringer om hvorledes doseringen faktisk kan justeres ind til den ønskede dato, eller om der er konflikter i den justering. Det vil også være muligt, at FMK returnerer en række advarsler i response-headeren, såfremt der er noget i justeringen, som lægen bør være opmærksom på, men som ikke nødvendigvis er en fejl.
+Kald til servicen indebærer validering af blandt andet:
+  * at ordinationen er håndteret dispenseret
+  * at både nuværende og ny dosering er strukturerede
+  * at den ønskede startdato ikke ligger i fortiden
-Det vil med stor sandsynlighed resultere i fejl såfremt elementer i de nuværende eller justerede dosering angives med fritekst, da FMK ikke kan lave beregninger på baggrund af disse.
+Servicen kan desuden returnere advarsler i response-headeren, hvis der er forhold, lægen bør være opmærksom på, uden at det nødvendigvis er en fejl. Det gælder eksempelvis:
+  * at den ønskede ændring giver anledning til en tom doseringsperiode
+  * at den ønskede ændring ligger før fristen for, at ændringen kan nå at træde i kraft i dispenseringen
+  * at den ønskede dato ligger i en dispenseringsperiode, som der muligvis allerede er pakket for
-<file xml AdjustDosageChangeRequest.xml>
+<file xml CalculateDosageAdjustmentRequest.xml>
-<AdjustDosageChangeRequest>
+<CalculateDosageAdjustmentRequest>
   <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
   <DrugMedicationIdentifier>234127183</DrugMedicationIdentifier>
   <Dosage>
+    <Precondition>
+        <ValidFrom>2026-01-17</ValidFrom>
+    </Precondition>
     <UnitTexts>
       <Singular>tablet</Singular>
       <Plural>tabletter</Plural>
     </UnitTexts>
-    <StructureFixed>
+    <DosagePeriod>
-      <DosagePeriod>
+      <Fixed>
-        <IterationInterval>1</IterationInterval>
         <Day>
           <Index>1</Index>
@@ Line 41: / Line 63: @@
           </Dose>
         </Day>
-      </DosagePeriod>
+      </Fixed>
-    </StructureFixed>
+    </DosagePeriod>
   </Dosage>
-  <AdjustToDate>2025-05-15</AdjustToDate>
+</CalculateDosageAdjustmentRequest>
-</AdjustDosageChangeRequest>
 </file>
 ===== Svar =====
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#adjustdosagechangeresponsetype|Response]]
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#calculatedosageadjustmentresponsetype|Response]]
-Svaret vil indeholde et ''DosageStructures'' element som svarer til en [[fmk:1.6.0:struktureret_dosering | struktureret dosering]], som så er justeret i forhold til den ''AdjustToDate'' angivet i forespørgslen.
+Svaret indeholder et ''Dosage'' element, som viser den beregnede samlede dosering ud fra den ønskede startdato for den nye dosering.
-**Bemærk:** bruges servicen med id'et på en nuværende ordination, kan svaret også indeholde dele af den nuværende dosering, fra den tidligste af de relevante doseringers startdato til den dato FMK finder frem til at den nye dosering kan træde i kraft.
+Hvis den eksisterende dosering overlapper den ønskede startdato, afkortes den eksisterende doseringsperiode, så den slutter dagen før den nye dosering starter.
-Herudover bør systemet være opmærksom på om der står noget i Warnings i FMK's [[fmk:1.6.0:xml-elementer:request_response_headers#warnings|responseheader]] da disse kan være relevant for lægen.
+Hvis den eksisterende dosering allerede slutter dagen før den nye dosering starter, returneres de to perioder blot efter hinanden.
+Hvis der er et hul mellem den eksisterende dosering og den nye dosering, indsættes en tom doseringsperiode imellem dem, derudover gives en advarsel i response-headeren.
-<file xml AdjustDosageChangeResponse.xml>
+Hvis der allerede findes fremtidige doseringsperioder efter den ønskede startdato, erstattes disse i svaret af den nye dosering fra den ønskede startdato.
-<AdjustDosageChangeResponse>
-    <DosageStructures>
+Herudover bør systemet være opmærksom på, om der står noget i ''Warnings'' i svarets [[fmk:1.6.0:xml-elementer:request_response_headers#warnings|responseheader]], da disse kan være relevante for lægen.
-        [[TODO]]
-    </DosageStructures>
+Eksemplet herunder viser, hvordan svaret kan se ud, når dags dato er 2025-12-01, og der allerede findes en aktuel struktureret dosering på lægemiddelordinationen.
-</AdjustDosageChangeResponse>
+Svaret omfatter den relevante eksisterende dosering frem til dagen før den nye dosering starter. Den eksisterende dosering overlapper den ønskede startdato 2026-01-17 og afkortes til dagen før. Den nye dosering med 2 tabletter morgen og aften vises herefter fra 2026-01-17.
+<file xml CalculateDosageAdjustmentResponse.xml>
+<CalculateDosageAdjustmentResponse>
+  <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
+  <DrugMedicationIdentifier>234127183</DrugMedicationIdentifier>
+  <Dosage>
+    <Precondition>
+      <ValidFrom>2025-11-01</ValidFrom>
+    </Precondition>
+    <UnitTexts>
+      <Singular>tablet</Singular>
+      <Plural>tabletter</Plural>
+    </UnitTexts>
+    <DosagePeriod>
+      <PeriodLength>77</PeriodLength>
+      <Fixed>
+        <Day>
+          <Index>1</Index>
+          <Dose>
+            <TimeOfDay>morning</TimeOfDay>
+            <Quantity>1</Quantity>
+          </Dose>
+          <Dose>
+            <TimeOfDay>evening</TimeOfDay>
+            <Quantity>1</Quantity>
+          </Dose>
+        </Day>
+        <Profile>
+          <ProfileCode>Detaljer udeladt for overskuelighed</ProfileCode>
+        </Profile>
+        <DosageTranslation>Detaljer udeladt for overskuelighed</DosageTranslation>
+      </Fixed>
+      <EndDate>
+        <CalculatedEndDate>2026-01-16</CalculatedEndDate>
+      </EndDate>
+    </DosagePeriod>
+    <DosagePeriod>
+      <Fixed>
+        <Day>
+          <Index>1</Index>
+          <Dose>
+            <TimeOfDay>morning</TimeOfDay>
+            <Quantity>2</Quantity>
+          </Dose>
+          <Dose>
+            <TimeOfDay>evening</TimeOfDay>
+            <Quantity>2</Quantity>
+          </Dose>
+        </Day>
+        <Profile>
+          <ProfileCode>Detaljer udeladt for overskuelighed</ProfileCode>
+        </Profile>
+        <DosageTranslation>Detaljer udeladt for overskuelighed</DosageTranslation>
+      </Fixed>
+      <EndDate>
+        <Unknown/>
+      </EndDate>
+    </DosagePeriod>
+  </Dosage>
+</CalculateDosageAdjustmentResponse>
 </file>