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

CalculateDosageDurationRequest.xml

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

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

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>