I 1.6.0 er en udlevering altid tilknyttet et 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 ifm. 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 hente udleveringer, der er oprettet siden sidste kald på et CPR-nummer.

Request

Forespørgsel 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å bestilling til brug i praksis.

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

Response

Svaret fra FMK indeholder først den PersonIdentifier eller OrganisationIdentifier, som var angivet i forespørgsel. 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 en HandoverIdentifier på 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>