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

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

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

Request

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

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

Hernæst 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 OrderIdentifier og HandoverIdentifier på hhv. udlevering og bestilling.
• Terminate, en boolean som angiver, hvorvidt udleveringsgrundlaget skal lukkes

I nedenstående eksempel ønskes en udlevering på en recept samt en udlevering ifbm. behandling annulleret.

UndoHandoverRequest.xml

<UndoHandoverRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <ModifiedBy>
        <Other>
            <Name>
                <GivenName>Anne</GivenName>
                <Surname>Andersen</Surname>
            </Name>
        </Other>
        <Role>Apoteksansat</Role>
        <Organisation>
            <Name>Skanderborg Apotek</Name>
            <AddressLine>Adelgade 27</AddressLine>
            <AddressLine>8660 Skanderborg</AddressLine>
            <Type>Apotek</Type>
            <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
        </Organisation>
    </ModifiedBy>
    <Warrant>
        <WarrantIdentifier>1341404071655002003</WarrantIdentifier>
        <PharmacyHandover>
            <OrderIdentifier>1341404070747001001</OrderIdentifier>
            <HandoverIdentifier>1341404070982002002</HandoverIdentifier>
        </PharmacyHandover>
        <Terminate>false</Terminate>
    </Warrant>
    <Warrant>
        <WarrantIdentifier>23142314129870234897</WarrantIdentifier>
        <TreatmentHandoverIdentifier>1314323241234123413</TreatmentHandoverIdentifier>
        <Terminate>true</Terminate>
    </Warrant>
</UndoHandoverRequest>

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

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>