====== Annullér udlevering ======

Denne service gør det muligt for en organisation at tilbageføre en udlevering. Den kan bruges både af apoteker til tilbageførsel af en apoteksudlevering og af f.eks. læger til tilbageførsel af udleveringer ifm. behandling. 

OBS: Denne funktionalitet bestod i 1.4.6-snitfladen af to særskilte services ([[fmk:1.4.4:Slet effektuering|Slet effektuering på lægemiddelordination (1.4.6)]] og [[fmk:1.4.6:Tilbagefør effektuering på recept|Tilbagefør effektuering på recept (1.4.6)]]). I 1.6.0 er modellen for udleveringer udvidet og ændret og denne service indføres som erstatning for de to tidligere services.

Tilbageføres en apoteksudlevering opdateres den tilhørende bestilling med en tom udlevering. 

===== Forespørgsel =====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#undoHandoverRequestType|Request]] 

Først angives enten ''PersonIdentifier'' eller ''OrganisationIdentifier'' på den person/organisation, som der er udleveret til.

Herefter angives modifikator for organisationen og brugeren, som foretager annulleringen, se [[fmk:1.6.0:xml-elementer:modifikator|Modifikator]]. Foretages annulleringen af en anden aktør end personen, der foretager kaldet mod FMK, medsendes både et ReportedBy-element, og ModifiedBy.

Herefter angives op til flere ''Warrant''-elementer. Disse indeholder følgende:
  * ''Identifier'', ID på udleveringsgrundlaget
  * Et valg mellem et ''PharmacyHandover''-element eller en ''TreatmentHandoverIdentifier''. Forskellen ligger i, at der for apoteksudleveringer skal angives både ''HandoverIdentifier'' og ''OrderIdentifier'' på hhv. udlevering og bestilling. 
  * ''TerminateWarrent'', et flag som angiver, hvorvidt udleveringsgrundlaget skal lukkes

I nedenstående eksempel ønskes en udlevering på et udleveringsgrundlag samt en udlevering ifm. at behandling er annulleret.

<code xml UndoHandoverRequest.xml>
<UndoHandoverRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <ModifiedBy>
        <HealthcareProfessional>
            <Identifier source="CPR">1111111118</Identifier>
            <Name>Testrup Test Testesen</Name>
        </HealthcareProfessional>
        <Role>Apoteksansat</Role>
        <Organisation>
            <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
            <Type>Apotek</Type>
            <Name>Skanderborg Apotek</Name>
            <AddressLine>Adelgade 27</AddressLine>
            <AddressLine>8660 Skanderborg</AddressLine>
        </Organisation>
    </ModifiedBy>
    <Warrant>
        <WarrantIdentifier>1341404071655002003</WarrantIdentifier>
        <PharmacyHandover>
            <OrderIdentifier>1341404070747001001</OrderIdentifier>
            <HandoverIdentifier>1341404070982002002</HandoverIdentifier>
        </PharmacyHandover>
    </Warrant>
    <Warrant>
        <WarrantIdentifier>23142314129870234897</WarrantIdentifier>
        <TreatmentHandoverIdentifier>1314323241234123413</TreatmentHandoverIdentifier>
        <TerminateWarrant/>
    </Warrant>
</UndoHandoverRequest>

</code>

===== Svar =====

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

I svaret returneres ID'er på den annullerede udlevering og de overliggende strukturer  

<code xml UndoHandoverResponse.xml>
<UndoHandoverResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <Warrant>
        <WarrantIdentifier>1341404071655002003</WarrantIdentifier>
        <HandoverOnOrder>
            <OrderIdentifier>1341404070747001001</OrderIdentifier>
            <HandoverIdentifier>1341404070982002002</HandoverIdentifier>
        </HandoverOnOrder>
    </Warrant>
    <Warrant>
        <WarrantIdentifier>23142314129870234897</WarrantIdentifier>
        <HandoverIdentifier>1314323241234123413</HandoverIdentifier>
    </Warrant>
</UndoHandoverResponse>

</code>