====== Service: Beregn doserings længde ======

Denne service kan benyttes til at beregne hvor længde en given mængde af doseringsenheder kan udfylde den nuværende dosering af en lægemiddelordination. 

Det er tiltænkt til brug af lægen fx ved recept-udstedelse. Her kan lægen angive ordinationen og størrelsen på den tænkte pakning. FMK svarer herefter med en dato for den sidste dag hvor der kan gives den fulde dosering. Apoteket vil også kunne benytte servicen til at informere kunden omkring hvornår de skal forvente at hente medicin igen, såfremt de fx udleverer pakninger af anden størrelse end det som lægen har udskrevet.

 Servicen tager højde for eventuelle pauseringer som er aktive eller planlagt for ordinationen.

Servicen vil også give informationer omkring eventuelle situationer som kan give usikkerheder i forhold til virkeligheden, fx hvis patienten ser ud til at være indlagt, eller at medicinkortet ikke er ajourført.

===== Forespørgsel =====
En forespørgsel til servicen forgår ved at angive følgende:
  * ''PersonIdentifier'': Identifikatioen for patienten, fx CPR nummer
  * ''DrugMedicationIdentifier'': Id for den valgte ordination.
  * ''StartDate'': Datoen hvor beregningen skal startes fra.
  * ''DosageUnits'': Antallet af enheder der skal doseres.

**Bemærk:**
Servicen fungere kun hvor ordinationens nuværende dosering er angivet strukturelt i FMK. Fritekst-doseringer eller doseringer efter lokalt skema kan ikke understøttes. Forsøge på at beregne på disse former for doseringer vil resultere i en valideringsfejl.

Servicen vil også resultere i en valideringsfejl såfremt den indsendte ''DrugMedicationIdentifier'' ikke findes, eller ikke tilhører den person som er angivet i ''PersonIdentifier''

Doseringer som angives "efter behov" også kaldet PN, inkluderes __IKKE__ i beregningen. Beregningen foregår kun over faste doseringen. Angives der en ordination som udelukkende har en PN dosering, vil FMK rapportere en dato langt ude i fremtiden, men af ''Information'' elementet vil forekomme en linje omkring beregningen er stoppet med en restmængde svarende til den mængde man angav i sit request med tilføjelsen: grundet den store tidshorisont
==== Eksempel på request ====

<code xml CalculateDosageDurationRequest.xml> 
<CalculateDosageDurationRequest>
   <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
   <DrugMedicationIdentifier>45601</DrugMedicationIdentifier>
   <StartDate>2022-02-11+01:00</StartDate>
   <DosageUnits>500</DosageUnits>
</CalculateDosageDurationRequest>
</code>

===== Svar =====
Et svar fra servicen indeholder følgende detaljer.
  * ''PersonIdentifier'': Identifikatioen for patienten, fx CPR nummer
  * ''DrugMedicationIdentifier'': Id for den valgte ordination

Herefter forekommer muligheden for en række datoer:

''EndDate'' Forekommer såfremt der i beregningen har indgået fast doseringer, og ingen doseringer hvor der anvendes Min/Max.

''MinEndDate'' & ''MaxEndDate'' Forekommer såfremt der i beregningerne har indgået faster doseringer hvor der er angivet en perioder hvor der gives doseringer efter Min/Max.

**Bemærk** ''EndDate'' og ''Min/Max-EndDate'' kan ikke forekomme samtidig. Hvis der i beregningerne ikke er indgået nogen faste doseringer, optræder ingen af de 3 overnævnte elementer.

''EndDateWithPN'' & ''OnlyPN'' Forekommer såfremt der i beregningerne har indgået doseringer som tages efter behov.

''EndDateWithPN'' Er en beregning på både fast og PN sammen, hvis der indgår doseringer i beregningen som tages efter Min/Max, så er Max anvendt. 

''OnlyPN'' er en beregning hvor kun doseringer som tages efter behov er medtaget, hvis PN doseringen er angivet med Min/Max, er Max anvendt.

**Bemærk** Hvis der kun indgår PN doseringer i beregningen, vil både ''EndDateWithPN'' og ''OnlyPN'' forekomme i svaret, og vil være samme dato.

Til sidst kan der komme en række ''Information'' elementer, som oplyser der har været ting som kan have haft indflydelse på beregningen. Eller ting som muligvis har haft en indflydelse, men som FMK ikke kan beregne.

Eksempler på informationer der kan findes i ''Information'' elementerne:
  * "Beregningen er stoppet..." dette sker typisk ved at beregningen har nået til ordinationens doserings-slut, eller at beregningen har nået en dato som ligger rigtig mange år ude i fremtiden. Kan også være når der ikke er nogen dosering at beregne på.
  * "Ordinationen er pauseret fra den [Start], til og med den [End]" beregningen har set en periode hvor doseringen er pauseret, doseringen i den pauserede periode ses som værende 0.
  * "Medicinkortet er/var markeret ugyldigt i hele eller dele af perioden", dette påvirker ikke beregningen, man kan have indflydelse på en afvigelse fra virkeligheden.
  * "Medicinkortet er/var ikke ajourført i hele eller dele af perioden", dette påvirker ikke beregningen, man kan have indflydelse på en afvigelse fra virkeligheden.
  * "Patienten er/var indlagt i hele eller dele af perioden", dette påvirker ikke beregningen, man kan have indflydelse på en afvigelse fra virkeligheden.

==== Eksempel på response ====

<code xml CalculateDosageDurationResponse.xml> 
<CalculateDosageDurationResponse>
   <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
   <DrugMedicationIdentifier>45601</DrugMedicationIdentifier>
   <EndDate>2022-03-11</EndDate>
   <Information>Beregning er stoppet ved sidste doserings-slut, der er en restmængde på 471 enheder</Information>
</CalculateDosageDurationResponse>
</code>

<code xml CalculateDosageDurationResponse.xml> 
<CalculateDosageDurationResponse>
   <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
   <DrugMedicationIdentifier>45601</DrugMedicationIdentifier>
   <MinEndDate>2022-05-18</MinEndDate>
   <MaxEndDate>2022-03-11</MaxEndDate>
   <EndDateWithPN>2022-02-25</EndDateWithPN>
   <OnlyPN>2022-12-31</OnlyPN>
</CalculateDosageDurationResponse>
</code>