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

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.

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>
        <Terminate>false</Terminate>
    </Warrant>
    <Warrant>
        <WarrantIdentifier>23142314129870234897</WarrantIdentifier>
        <TreatmentHandoverIdentifier>1314323241234123413</TreatmentHandoverIdentifier>
        <Terminate>true</Terminate>
    </Warrant>
</UndoHandoverRequest>

Response

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>