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 (Slet effektuering på lægemiddelordination (1.4.6) og 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.

Request

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

Herefter angives modifikator for 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 HandoverIdentifier og OrderIdentifier 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>