Fælles Medicinkort - Dokumentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== Service: Beregn nødvendig doserings mængde ======
Denne service kan benyttes til at beregne hvor mange doserings-enheder der skal gives i en bestemt periode ud fra lægemiddelordinationens nuværende dosering. 

Servicen er tiltænkt som en ekstra sikkerhed/verifikation ved tvivl omkring de udleverede medicin. Hvis lægen ønsker at oprette en recept til hele eller dele af forløbet, vil denne service kunne informere omkring den krævede antal, således at lægen kan træffe det rigtig valg i forhold til paknings-størrelse og antal. 

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.
  * ''EndDate'': Datoen hvor beregningen skal stoppe.

**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 antallet af enheder servicen rapportere forblive 0.

==== Eksempel på request ====

<code xml CalculateRequiredDosageUnitsRequest.xml> 
<CalculateRequiredDosageUnitsRequest>
   <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
   <DrugMedicationIdentifier>46001</DrugMedicationIdentifier>
   <StartDate>2022-02-11+01:00</StartDate>
   <EndDate>2022-03-13+01:00</EndDate>
</CalculateRequiredDosageUnitsRequest>
</code>

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

De beregnede mængder:
''DosageUnits'' eller ''MinDosageUnits'' + ''MaxDosageUnits'' Forekommer såfremt der i beregningen er indgået doseringsperioder hvor der gives en fast daglig dosering. Min/Max anvendes såfremt der i beregningen har indgået dage hvor den faste doseringen er angivet som en Min/Max dosering. Hvis ikke der i beregningen har indgået en doseringsperiode hvor der gives en fast daglig dosering, vil ingen af elementerne forekomme i svaret.

''DosageUnitsWithPN'' & ''DosageUnitsOnlyPN'' Forekommer såfremt der i beregningen er indgået doseringsperioder hvor der gives en daglig dosering efter behov. ''DosageUnitsWithPN'' er en samlet angivelse både den faste dosering og PN doserignen, ved Min/Max doseringer er max anvendt i beregningen. ''DosageUnitsOnlyPN'' er det samlede antal enheder hvis der kun tages doseringer som er PN, hvis der i PN doseringer er angivet Min/Max, er max det benyttede antal i beregningen. Hvis der i beregningen ikke har indgået nogle doseringsperiode hvor der gives en dosering efter behov, vil ingen af disse 2 elementer forekomme i svaret



Herefter kan der forekomme en række ''Information'' elementer som er en liste af ekstra informationer, som har eller kan have indflydelse på resultatet af beregningen.

Eksempler på informationer der kan findes i ''Information'' elementerne:
  * "Beregningen er stoppet ved dato: [date] da antallet af enheder har nået 1 milliard" dette kan ske hvis der angives en meget tung dosering med en meget store tidsperiode, FMK kan ikke udtrykke flere doserings-enheder en 1 milliard.
  * "Beregning stoppet grundet manglende dosering" sker hvis der angives en periode hvor der ikke findes en egentlig dosering.
  * "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 CalculateRequiredDosageUnitsResponse.xml> 
<CalculateRequiredDosageUnitsResponse>
   <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
   <DrugMedicationIdentifier>46001</DrugMedicationIdentifier>
   <DosageUnits>26</DosageUnits>
   <Information>Ordinationen er pauseret fra den 12-02-2022, til og med den 14-02-2022</Information>
</CalculateRequiredDosageUnitsResponse>
</code>