This is an old revision of the document!
Table of Contents
Hent udleveringer
I 1.6.0 er en udleveringer altid tilknyttet udleveringsgrundlag. Når et apotek udleverer på baggrund af en recept (typisk via Effektuer bestilling), vil udleveringer blive knyttet til denne recept. Når der udleveres ifbm. behandling (via Registrer udlevering) knyttes udleveringen til et udleveringsgrundlag af typen “Udleveret ved behandling”.
Servicen til at hente udleveringer gør det muligt at hente i et tidsinterval, der f.eks. kan hentes udleveringer der er oprettet siden sidste kald på et CPR-nummer.
Forespørgsel
Forespørgslen indeholder først patientens CPR-nummer i et PersonIdentifier-element. Det er muligt i stedet at angive en OrganisationIdentifier, hvis udleveringer til en organisation ønskes fremsøgt – eksempelvis ved udleveringer på praksisrecepter.
Herefter to felter til angivelse af et dato- og tidsinterval. Udelades et eller begge dato- og tidsfelterne anvendes i stedet ”uendeligt” i begge retninger. Dvs. en forespørgsel hvor både FromDateTime og ToDateTime er udeladt vil returnere samtlige udleveringer kendt af FMK, dog kan FMK begrænse antallet af udleveringer der returneres, som senere beskrevet.
Der er hernæst mulighed for at angive følgende flag:
- Angives IncludeHandoversOnLoosePrescriptions, vil udleveringer på løse recepter fremsøges.
- Angives IncludeSecondaryHandovers, vil svaret indeholde sekundære udleveringer foruden detaljerne om de egentlige udleveringer
<GetHandoversRequest> <PersonIdentifier>1111111118</PersonIdentifier> <FromDateTime>2026-01-01T00:00:00Z</FromDateTime> <ToDateTime>2026-04-10T09:30:00Z</ToDateTime> <IncludeHandoversOnLoosePrescriptions/> <IncludeSecondaryHandovers/> </GetHandoversRequest>
Svar
Svaret fra FMK indeholder først den PersonIdentifier eller OrganisationIdentifier, som var angivet i forespørgslsen. Herefter returneres udleveringerne i en struktur der afspejler deres sammenhæng med en lægemiddelordination (i HandoversOnDrugMedication-elementet) eller som en løs recept (i HandoversOnLoosePrescription-elementet). Er der tale om en lægepraksis, vil udleveringerne i stedet returneres i HandoversOnPracticePrescription-elementer.
I HandoversOnDrugMedication grupperes udleveringsgrundlag og tilhørende udleveringer under lægemiddelordinationens DrugMedicationIdentifier. Disse grupperinger består af Handovers-elementer indeholdende:
WarrantIdentifier, identifier på udleveringsgrundlaget- En række
Handover-elementer, som beskrevet på: Udlevering - Evt. en række
InvalidHandover-elementer, som hver indeholder enHandoverIdentifierpå en ugyldig udlevering
HandoversOnLoosePrescription og HandoversOnLoosePrescription følger samme struktur som Handovers-elementet.
Nyeste udleveringer returneres først. Om nødvendigt kan FMK begrænse antallet af returnerede udleveringer i et enkelt response, se beskrivelse af paginering på Request/response headers.
<GetHandoversResponse> <PersonIdentifier>1111111118</PersonIdentifier> <HandoversOnDrugMedication> <DrugMedicationIdentifier>1332830239001</DrugMedicationIdentifier> <Handovers> <WarrantIdentifier>2132131</WarrantIdentifier> <Handover> ... </Handover> </Handovers> </DrugMedication> <HandoversOnDrugMedication> <DrugMedicationIdentifier>1332830239001</DrugMedicationIdentifier> <Handovers> <WarrantIdentifier>12321233</WarrantIdentifier> <Handover> ... </Handover> <Handover> ... </Handover> </Handovers> </HandoversOnDrugMedication> <HandoversOnLoosePrescription> <WarrantIdentifier>12321233</WarrantIdentifier> <Handover> ... </Handover> </HandoversOnLoosePrescription> </GetHandoversResponse>
