Differences

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

--- fmk:1.6.0:services:beregn_doseringsperiode [2025-10-28 15:45] – created sas
+++ fmk:1.6.0:services:beregn_doseringsperiode [2026-07-31 11:52] (current) – adta
@@ Line 1: / Line 1: @@
 ====== Beregn doseringsperiode ======
-Service udstilles bl.a. til compliance-beregning. Anvendes til at udregne for lang en periode af doseringen en given mængde doseringsenheder vil kunne dække.
+Denne service udstilles bl.a. til compliance-beregning. Servicen anvendes til at udregne, hvor lang en periode af doseringen en given mængde doseringsenheder vil kunne dække.
 ===== Forespørgsel =====
-I [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#CalculateDosageDurationRequestType|forespørgsel]] til service angives først ''PatientIdentifier'' for patienten, efterfulgte af ID'et på lægemiddelordinationen i ''DrugMedicationIdentifier''
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#CalculateDosageDurationRequestType|Request]]
-Herefter angives ''StartDate'' som værende den dato beregningen skal starte fra, efterfulgt af mængden af doseringsenheder i ''DosageUnits''. Bemærk at der kun er tale om en mængde, det er systemet/brugerens ansvar at mængden er tilpasset den doseringsenhed som ordinationen er angivet med, dvs man bør ikke foretage en udregning på antal milligram, hvis doseringen er angivet i tablettet.
+I forespørgsel til denne service angives først ''PersonIdentifier'' for patienten, efterfulgt af ID'et på lægemiddelordinationen i ''DrugMedicationIdentifier''
+Herefter angives ''StartDate'' som værende den dato, beregningen skal starte fra, efterfulgt af mængden af doseringsenheder i ''DosageUnits''. Bemærk at der kun er tale om en mængde, det er systemets/brugerens ansvar, at mængden er tilpasset den doseringsenhed, som ordinationen er angivet med. Dvs. man bør ikke foretage en udregning på antal milligram, hvis doseringen er angivet i tabletter.
 <file xml CalculateDosageDurationRequest.xml>
@@ Line 17: / Line 19: @@
 ===== Svar =====
-I [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#CalculateDosageDurationResponseType|svar]] fra service kommer igen først ''PatientIdentifier'' for patienten, efterfulgte af ID'et på lægemiddelordinationen i ''DrugMedicationIdentifier''.
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#CalculateDosageDurationResponseType|Response]]
-Alt efter om ordinationen har Min/Max doseringen indenfor den givne periode, vil der enten være et ''EndDate'' eller kombinationen af ''MinEndDate'' og ''MaxEndDate'' i svaret fra servicen. Dog er ''EndDate'' optionelt, dvs faktisk kan en egentlig slutdato mangle. Dette sker typisk kun i situationer hvor mængden af enheder er så stor at det vil dække doseringen i flere år, men der kan være andre årsager. I så fald beskrives dette i et af ''Information'' elementerne.
+I svaret fra denne service kommer først ''PersonIdentifier'' for patienten, efterfulgt af ID'et på lægemiddelordinationen i ''DrugMedicationIdentifier''.
-Herefter kan ''EndDateWithPRN'' og ''OnlyPRN'' indgå, såfremt doseringen i perioden indeholder noget som skal tages efter behov. Hvis efter behov også er en Min/Max, antages det Max er anvendt.
+Afhængigt af om ordinationen indenfor den givne periode indeholder en Min/Max-dosering, vil svaret enten indeholde ''EndDate'' eller kombinationen af ''MinEndDate'' og ''MaxEndDate''. ''EndDate'' er optionel og kan derfor mangle. Det sker eksempelvis hvis resultatet alene kan beskrives via Min/Max eller PN-relaterede felter, eller hvis den angivne mængde rækker længere end den tilgængelige dosering. I så fald vil dette være beskrevet i et eller flere ''Information''-elementer.
-Til sidst kommer en række ''Information'' elementer, som indeholder eventuelle bemærkninger fra FMK omkring beregningen, og ting som kan have indflydelse her.
+Hvis doseringen i perioden indeholder noget, som skal tages efter behov, kan ''EndDateWithPRN'' og ''OnlyPRN'' indgå i svaret. ''EndDateWithPRN'' angiver slutdatoen, når efter behov-dosering medregnes sammen med den faste dosering. ''OnlyPRN'' angiver slutdatoen, hvis der alene regnes på efter behov-dosering. Hvis efter behov også er en Min/Max, antages det, at Max er anvendt. Ved ubegrænset PN-dosering kan beregningen kun foretages, hvis der er angivet ''MaximumDailyDose''. Denne værdi anvendes som grundlag for det daglige forbrug i beregningen. Hvis ''MaximumDailyDose'' ikke er angivet, returneres en fejl.
-TODO, skriv eksempel.
+Til sidst kommer en række ''Information''-elementer, som indeholder eventuelle bemærkninger fra FMK omkring beregningen, og information som kan være relevant for resultatet. Eksempler kan være pausering af ordinationen, manglende ajourføring af medicinkortet eller at uspecificerede doseringsperioder er ignoreret i beregningen.
+<file xml CalculateDosageDurationResponse.xml>
+<CalculateDosageDurationResponse>
+    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
+    <DrugMedicationIdentifier>3138518613</DrugMedicationIdentifier>
+    <EndDate>2025-08-01</EndDate>
+    <EndDateWithPRN>2025-07-01</EndDateWithPRN>
+    <OnlyPRN>2025-11-01</OnlyPRN>
+    <Information>Medicinkortet er/var ikke ajourført i hele eller dele af perioden</Information>
+</CalculateDosageDurationResponse>
+</file>