====== Registrer udlevering ved behandling ======

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.


==== Forespørgsel ====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#RegisterHandoverRequestType|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 [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#CreateHandoverOfDrugMedicationType|CreateHandoverOfDrugMedication]]-elementer. Hver af disse indeholder en ''DrugMedicationIdentifier'' på den relevante lægemiddelordination samt et eller flere [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#CreateTreatmentHandoverType|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 [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#packagehandovertype|Package]]-   eller et [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#singleunitshandovertype|SingleUnits]]-element. Desuden er det muligt optionelt at angive op til flere [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#createdrugadministrationonhandovertype|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

=== Eksempel 1 ===

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

<code xml "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/>
            <Handover>
                 <DateTime>2026-03-29T12:48:03.0Z</DateTime>
                 <SingleUnits>
                      <DoseQuantity>4</DoseQuantity>
                      <DosageQuantityUnitText">stk</DosageQuantityUnitText>
                 </SingleUnits>
            </Handover>
        </CreateTreatmentHandover>
    </CreateHandoverOfDrugMedication>
</RegisterHandoverRequest>

</code>



=== Eksempel 2 ===

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.

<code xml "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>

</code>



==== Svar ====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#registerhandoverresponsetype|Response]]

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

<code xml "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>
</code>