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.

Request

I forespørgslen skal patientens PersonIdentifier angives, samt DrugMedicationIdentifier på lægemiddelordinationen der ønskes justeret dosering på.

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.

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 servicen indebærer validering af blandt andet:

• at lægemidlet er håndteret dispenseret
• at både nuværende og ny dosering er strukturerede
• at den ønskede startdato ikke ligger i fortiden

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

CalculateDosageAdjustmentRequest.xml

<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>
    <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>
    </DosagePeriod>
  </Dosage>
</CalculateDosageAdjustmentRequest>

Response

Svaret indeholder et Dosage element, som viser den beregnede samlede dosering ud fra den ønskede startdato for den nye dosering.

Hvis den eksisterende dosering overlapper den ønskede startdato, afkortes den eksisterende doseringsperiode, så den slutter dagen før den nye dosering starter.

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 efterfulgt af en advarsel i response-headeren.

Hvis der allerede findes fremtidige doseringsperioder efter den ønskede startdato, erstattes disse i svaret af den nye dosering fra den ønskede startdato.

Herudover bør systemet være opmærksom på, om der står noget i Warnings i svarets responseheader, da disse kan være relevante for lægen.

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. 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.

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>