Denne service tillader registrering af en eller flere nye udleveringer på en eksisterende lægemiddelordination. Udleveringen foretages af lægen eller dennes medhjælp, ved at medicinen udleveres til patienten. Servicen opretter et eller flere udleveringsgrundlag af typen “Udleveret ved behandling”, som udleveringerne tilknyttes. Det er også muligt at angive WarrantIdentifier på allerede eksisterende udleveringsgrundlag, hvis udleveringerne i stedet ønskes tilknyttet til denne.

Request

I forespørgsel skal det sikres, at der arbejdes på den seneste version af medicinkortet og dermed også på seneste version af lægemiddelordinationen. Der skal medsendes information omkring lægens organisation (sygehus, praksis mm) og lægen, begge informationer skal være for lægen, der foretager opdateringen af medicinkortet.

Dernæst angives en række CreateHandoverOfDrugMedication-elementer. Hver af disse indeholder en DrugMedicationIdentifier på den relevante lægemiddelordination samt et eller flere CreateTreatmentHandover-elementer. Disse indeholder hver følgende oplysninger:

• Et valg mellem et flag at typen CreateNewWarrant eller ID på et udleveringsgrundlag ExistingWarrantIdentifier. Herved er det muligt at angive, hvorvidt servicen skal oprette et nyt udleveringsgrundlag af typen “Udleveret ved behandling”, eller udleveringen skal tilknyttes et allerede eksisterende udleveringsgrundlag af denne type.
• Optionelt: TerminateWarrant – angives , hvis udleveringsgrundlaget skal lukkes, angives ikke hvis udleveringsgrundlaget skal forblive åbent efter service-kald.
• En sekvens af Handover-elementer. Disse indeholder hver en DateTime for udleveringstidpunktet, optionelt en CreatedBy-modifikator, og enten et Package- eller et SingleUnits-element. Desuden er det muligt optionelt at angive op til flere RegisterDrugAdministration-elementer, hvor faktisk medicinadministration kan registreres på udleveringen.

I Package angives oplysninger om udleverede pakker, herunder pakkens varenummer (PackageNumber) og evt. pakningsstørrelse (PackageSize) samt antallet af pakker (PackageQuantity). I SingleUnits angives i stedet en DoseQuantity og tilhørende DoseQuantityUnitText for mængden af medicin. Valget mellem disse to elementer afspejler, hvorvidt lægen har udleveret medicin til borgeren i pakker eller enkelte doser.

I begge elementer er det muligt at angive lægemiddelsubstitution i SubstitutedDrug-elementet, hvis der er blevet foretaget substitution ved udleveringen

Dette eksempel viser registration af en udlevering ved behandling, hvor der er blevet udleveret 4 stk af et lægemiddel.

"RegisterHandoverRequest.xml"

<RegisterHandoverRequest>
    <PersonIdentifier>1111111118</PersonIdentifier>
    <MedicineCardVersion>1341404079919002002</MedicineCardVersion>
    <CreatedBy>
        <HealthcareProfessional>
            <Identifier source="Autorisation">2Q5TK</Identifier>
            <Name>Tess Christoffersen</Name>
            <Information type="SpecialityCode">7170</Information>
        </HealthcareProfessional>
        <Role>Læge</Role>
        <Organisation>
            <Identifier source="Yder">66974</Identifier>
            <Type>Yder</Type>
            <Name>Lægerne Vestergade</Name>
            <AddressLine>Vestergade 2</AddressLine>
            <AddressLine>8660 Skanderborg</AddressLine>
            <TelephoneNumber>86521348</TelephoneNumber>
            <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress>
        </Organisation>
    </CreatedBy>
    <CreateHandoverOfDrugMedication>
        <DrugMedicationIdentifier>1332830239001</DrugMedicationIdentifier>
        <CreateTreatmentHandover>
            <CreateNewWarrant/>
            <TerminateWarrant>true</TerminateWarrant>
            <Handover>
                 <DateTime>2026-03-29T12:48:03.0Z</DateTime>
                 <SingleUnits>
                      <DoseQuantity>4</DoseQuantity>
                      <DosageQuantityUnitText">stk</DosageQuantityUnitText>
                 </SingleUnits>
            </Handover>
        </CreateTreatmentHandover>
    </CreateHandoverOfDrugMedication>
</RegisterHandoverRequest>

Dette eksempel viser registrering af en udlevering ved behandling på et eksisterende udleveringsgrundlag. Der er blevet udleveret en pakke af et lægemiddel, og der er desuden registreret administration af medicinen.

"RegisterHandoverRequest-existsingwarrant.xml"

<RegisterHandoverRequest>
    <PersonIdentifier>1111111118</PersonIdentifier>
    <MedicineCardVersion>1341404079919002002</MedicineCardVersion>
    <CreatedBy>
        <HealthcareProfessional>
            <Identifier source="Autorisation">2Q5TK</Identifier>
            <Name>Tess Christoffersen</Name>
            <Information type="SpecialityCode">7170</Information>
        </HealthcareProfessional>
        <Role>Læge</Role>
        <Organisation>
            <Identifier source="Yder">66974</Identifier>
            <Type>Yder</Type>
            <Name>Lægerne Vestergade</Name>
            <AddressLine>Vestergade 2</AddressLine>
            <AddressLine>8660 Skanderborg</AddressLine>
            <TelephoneNumber>86521348</TelephoneNumber>
            <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress>
        </Organisation>
    </CreatedBy>
    <CreateHandoverOfDrugMedication>
        <DrugMedicationIdentifier>123412789734</DrugMedicationIdentifier>
        <CreateTreatmentHandover>
            <ExistingWarrantIdentifier>134321374128937</ExistingWarrantIdentifier>
            <TerminateWarrant/>
            <Handover>
                 <DateTime>2026-03-29T12:48:03.0Z</DateTime>
                 <Package>
                      <PackageQuantity>1</PackageQuantity>
                      <PackageNumber source="Medicinpriser" date="2025-10-03">416636</PackageNumber>
                      <PackageSize>
                          <Value>100</Value>
                          <UnitText>stk</UnitText>
                      </PackageSize>
                 </Package>
                 <RegisterDrugAdministration>
                      <AdministrationDateTime>2026-03-29T12:39:23.0Z</AdministrationDateTime>
                      <DoseQuantity>2</DoseQuantity>
                      <DosageQuantityUnitText>stk</DosageQuantityUnitText>
                 </RegisterDrugAdministration>
            </Handover>
        </CreateTreatmentHandover>
    </CreateHandoverOfDrugMedication>
</RegisterHandoverRequest>

Response

I svaret returneres ID’er på de oprettede udleveringer og tilknyttede udleveringsgrundlag. Rækkefølgen er bevaret ligesom i forespørgsel.

"RegisterHandoverResponse.xml"

<RegisterHandoverResponse>
    <PersonIdentifier>1111111118</PersonIdentifier>
    <MedicineCardVersion>1341404077657004001</MedicineCardVersion>
    <CreatedTreatmentHandovers>
        <DrugMedicationIdentifier>123412789734</DrugMedicationIdentifier>
        <WarrantAndHandovers>
             <WarrantIdentifier>134321374128937</WarrantIdentifier>
             <RegisteredHandover>
                  <HandoverIdentifier>13328324670209</HandoverIdentifier>
                  <DrugAdministrationIdentifier>3412438013489</DrugAdministrationIdentifier>
             </RegisteredHandover
        </WarrantAndHandovers>
    </CreatedTreatmentHandovers>
</RegisterHandoverResponse>