Differences

This shows you the differences between two versions of the page.

--- fmk:1.6.0:services:hent_udleveringer [2025-10-24 09:49] – created lbdo
+++ fmk:1.6.0:services:hent_udleveringer [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Hent udleveringer ======
-I 1.6.0 er en udleveringer altid tilknyttet 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 ifbm. behandling (via [[fmk:1.6.0:services:Registrer udlevering]]) knyttes udleveringen til et udleveringsgrundlag af typen "Udleveret ved behandling".
+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 hentes udleveringer der er oprettet siden sidste kald på et CPR-nummer.
+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|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.
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetHandoversRequestType|Request]]
-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.
+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.
-Der er hernæst mulighed for at angive følgende flag:
+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
+  * Angives IncludeSecondaryHandovers, vil svaret indeholde [[fmk:1.6.0:xml-elementer:Sekundær udlevering|sekundære udleveringer]] foruden detaljerne om de egentlige udleveringer
@@ Line 21: / Line 23: @@
 <GetHandoversRequest>
 	<PersonIdentifier>1111111118</PersonIdentifier>
-	<FromDateTime>2012-01-01T00:00:00Z</FromDateTime>
+	<FromDateTime>2026-01-01T00:00:00Z</FromDateTime>
-	<ToDateTime>2012-04-10T09:30:00Z</ToDateTime>
+	<ToDateTime>2026-04-10T09:30:00Z</ToDateTime>
 	<IncludeHandoversOnLoosePrescriptions/>
 	<IncludeSecondaryHandovers/>
@@ Line 31: / Line 33: @@
 ==== Svar ====
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetHandoversResponseType|Forespørgslen]] 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.
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetHandoversResponseType|Response]]
-I ''HandoversOnDrugMedication'' grupperes udleveringsgrundlag og tilhørende udleveringer under lægemiddelordinationens ''DrugMedicationIdentifier''. Disse grupperinger består af ''Handovers''-elementer indeholdende:
+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
@@ Line 39: / Line 43: @@
   * Evt. en række ''InvalidHandover''-elementer, som hver indeholder en ''HandoverIdentifier'' på en ugyldig udlevering
-''HandoversOnLoosePrescription'' og ''HandoversOnLoosePrescription'' følger ovenstående struktur, blot uden grupperingen under lægemiddelordination.
+''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. I så fald markeres dette i responset med MoreAvailable-elementet. Der kan efterfølgende spørges med tidspunktet for oprettelsen af den ældste udlevering i responset, dvs. med tidsintervallet [oprindelig fradato – ældste dato i responset]
-=== Eksempel ===
-	Første Request udføres på tidspunktet 2009-12-25 14:43:51
-		Request: 	CPR = 1111111118; tidsinterval = [2007-02-25 14:43:51; 2009-02-25 14:43:51]
-		Response: 	Effektuering oprettet 2009-01-12 11:52:32
-						Effektuering oprettet 2009-01-09 14:13:21
-								...
-						Effektuering oprettet 2008-06-29 09:11:44
-						MoreAvailable
-	Næste request udføres umiddelbart herefter, idet der er modtaget et MoreAvailable-flag
-		Request: 	CPR = 1111111118; tidsinterval = [2007-02-25 14:43:51; 2008-06-29 09:11:44]
-		Response: 	Effektuering oprettet 2008-04-12 15:55:01
-						Effektuering oprettet 2008-03-24 14:31:13
-	Der foretages herefter ikke flere forespørgsler, idet der her ikke er modtaget et MoreAvailable-flag.
+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>
@@ Line 67: / Line 52: @@
 	<PersonIdentifier>1111111118</PersonIdentifier>
 	<HandoversOnDrugMedication>
-		<Identifier>1332830239001</Identifier>
+		<DrugMedicationIdentifier>1332830239001</DrugMedicationIdentifier>
 		<Handovers>
 			<WarrantIdentifier>2132131</WarrantIdentifier>
@@ Line 76: / Line 61: @@
 	</DrugMedication>
 	<HandoversOnDrugMedication>
-		<Identifier>1332830239001</Identifier>
+		<DrugMedicationIdentifier>1332830239001</DrugMedicationIdentifier>
 		<Handovers>
 			<WarrantIdentifier>12321233</WarrantIdentifier>