====== Hent udleveringer ======

I 1.6.0 er en [[fmk:1.6.0:xml-elementer:Udlevering|udlevering]] altid tilknyttet et udleveringsgrundlag. Når et apotek udleverer på baggrund af en recept (typisk via [[fmk:1.6.0:services:Effektuer bestilling]]), vil udleveringer blive knyttet til denne recept. Når der udleveres ifm. behandling (via [[fmk:1.6.0:services: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. 

==== Forespørgsel ====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetHandoversRequestType|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 [[fmk:1.6.0:xml-elementer:Sekundær udlevering|sekundære udleveringer]] foruden detaljerne om de egentlige udleveringer


<code xml>

<GetHandoversRequest>
	<PersonIdentifier>1111111118</PersonIdentifier>
	<FromDateTime>2026-01-01T00:00:00Z</FromDateTime>
	<ToDateTime>2026-04-10T09:30:00Z</ToDateTime>
	<IncludeHandoversOnLoosePrescriptions/>
	<IncludeSecondaryHandovers/>
</GetHandoversRequest>

</code>

==== Svar ====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetHandoversResponseType|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 [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#HandoversType|Handovers]]-elementer indeholdende:

  * ''WarrantIdentifier'', identifier på udleveringsgrundlaget
  * En række ''Handover''-elementer, som beskrevet på: [[fmk:1.6.0:xml-elementer:Udlevering]]
  * Evt. en række ''InvalidHandover''-elementer, som hver indeholder en ''HandoverIdentifier'' på en ugyldig udlevering

''HandoversOnLoosePrescription'' og ''HandoversOnLoosePrescription'' følger samme struktur som [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#HandoversType|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å [[fmk:1.6.0:xml-elementer:Request/response headers|Request/response headers]].

<code xml>

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

</code>