Differences

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

--- fmk:extensions:hent_bestillinger [2019-07-22 11:25] – created sas
+++ fmk:extensions:hent_bestillinger [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Hent bestillinger for patient ======
-Hent bestillinger for patient er en service som kan anvendes til at hente informationer omkring bestillinger på recepter til en given patient.
+Hent bestillinger anvendes til at hente detaljeret informationer om udleveringsanmodninger (apoteksbestillinger)  vedrørende en given patient.
 ==== Forespørgsel ====
-En forespørgsel til servicen foretages med følgende oplysninger.
+Servicen kaldes med følgende parametre:
-  - Et PersonId (''PersonIdentifier'')
+  * Et PersonId (''PersonIdentifier'')
-  - Enten 1. En list af bestillingsid'er (''Identifier''), 2.Tidspunkt for hvornår ældste bestilling blev lavet (''CreatedSince'').
+  * En liste af bestillingsid'er (''Identifier''). Alternativt en afgrænsning af hvor gamle bestillinger, der skal medtages i svaret.  (''CreatedSince'').
 ==== Eksempel på forespørgsel ====
-Nedenstående eksempler viser oplag på en Patient med CPR nummer 1111111118 (''PersonIdentifier ''). Eksempel 1 viser en hentning af bestillinger med ID 301483388005088 og 301483388013088 (''Identifier''). Eksempel 2 finder alle bestillinger lavet på og efter den angivene tidspunkt (''CreatedSince'')
+Nedenstående eksempler viser oplag på en Patient med CPR nummer 1111111118 (''PersonIdentifier '').
+Hentning af bestillinger med bestemte id'er (''Identifier'').
 <code xml 1: GetOrdersRequest-Identifiers.xml>
@@ Line 20: / Line 22: @@
 </GetOrdersRequest>
 </code>
+Hent alle bestillinger lavet på og efter det angivene tidspunkt (''CreatedSince'')
 <code xml 2: GetOrdersRequest-CreatedSince.xml>
@@ Line 31: / Line 35: @@
 Svaret vil indeholde:
-  - En række patient-elementer som derunder hver indholder de forskellige bestillinger sorteret under deres status.
+  - PersonId eks. CPR-nummer (''PersonIdentifier'').
-  - Her bestillings-status indeholder et tidspunkt for hvornår den ældste bestilling som blev returneret blev lavet, samt en list af bestillingsid'er.
+  - En række Bestillings-elementer (''Order'').
-Hvis der ikke er blevet ønsket fremsøg eller ikke var nogle bestillinger med den enkelte status, vil denne status ikke forekomme i svaret (Fx i eksemplet forekommer annullerede bestillinger ikke i svaret).
+Order elementer indeholder følgende informationer:
+  * OrdinationsId (''DrugMedicationIdentifier'')
+  * ReceptId (''PrescriptionMedicationIdentifier'')
+  * BestillingsId (''OrderIdentifier'')
+  * Modifikator for bestilleren og tidspunkt (''OrderedBy'')
+  * Organisationen (apoteket) som bestillingen er lavet til (''EffectuatingOrganisation'')
+  * Status for bestillingen (''Status'')
+  * Optionel: Op til 3 elementer med leverings-information (''DeliveryInformation'')
+  * Optionel: Op til 3 elementer med bestillings-information (''OrderInstruction'')
+  * Optionel: Et leverings-element med yderligere oplysninger (''Delivery'')
+  * Optionel: Et effektueringsId hvis bestillingen er blevet behandlet (''Effectuation'')
+**Bemærk:** Annullerede bestillinger bliver i øjeblikket IKKE returneret. Løse recepter + effektueringer på disse optræder heller ikke. Dette skyldes at annullerede bestilligner ikke hentes fra FMK's recept-modul.
 ==== Eksempel på Svar====
@@ Line 40: / Line 56: @@
 <code xml GetOrdersResponse.xml>
-<SearchOrdersResponse>
+<GetOrdersRequest>
-    <Patient>
+    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
-	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
+    <Order>
-	<UnhandledOrders>
+        <DrugMedicationIdentifier>701483388005088</Identifier>
-		<OldestCreatedDateTime>2019-07-18T18:45:00Z</OldestCreatedDateTime>
+        <PrescriptionMedicationIdentifier>601483388005088</Identifier>
-		<Identifier>301483388005088</Identifier>
+	<Identifier>301483388005088</Identifier>
-	</UnhandledOrders>
+        <EffectuatingOrganisation>
-	<CanceledOrders>
+            <Name>Århus Jernbane Apotek</Name>
-		<OldestCreatedDateTime>2019-06-01T12:00:00Z</OldestCreatedDateTime>
+            <AddressLine>Banegårdsplads 8</AddressLine>
-		<Identifier>301483388013088</Identifier>
+            <AddressLine>8000 Århus</AddressLine>
-	</CanceledOrders>
+            <Type>Apotek</Type>
-    </Patient>
+            <Identifier source="EAN-Lokationsnummer">5790000171323</Identifier>
-    <Patient>
+        </EffectuatingOrganisation>
+        <OrderedBy>
+            <By>
+                <AuthorisedHealthcareProfessional>
+                    <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier>
+                    <Name>Tess Christoffersen</Name>
+                    <SpecialityCode source="Medicinpriser" date="2013-09-18">PSYK</SpecialityCode>
+                </AuthorisedHealthcareProfessional>
+                <Organisation>
+                    <Name>Lægerne Vestergade</Name>
+                    <AddressLine>Vestergade 2</AddressLine>
+                    <AddressLine>8660 Skanderborg</AddressLine>
+                    <TelephoneNumber>86521348</TelephoneNumber>
+                    <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress>
+                    <Type>Yder</Type>
+                    <Identifier source="Yder">66974</Identifier>
+                </Organisation>
+            </By>
+            <DateTime>2019-06-30T12:00:00Z</DateTime>
+        </OrderedBy>
+        <Status>Udført</Status>
+        <DeliveryInformation>Tag første dør</DeliveryInformation>
+        <DeliveryInformation>Ring gerne på klokken</DeliveryInformation>
+        <OrderInstruction>Kom medicinen i afkølet pose</OrderInstruction>
+        <Delivery>
+            <Priority>send til patientadresse samme dag</Priority>
+        </Delivery>
+        <Effectuation>301483388005088</Effectuation>
+    </Order>
+    <Order>
     ...
-    </Patient
+    </Order>
-    <Patient>
+</GetOrdersRequest>
-    ...
-    </Patient
-    ...
-</SearchOrdersResponse>
 </code>