Differences

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

--- fmk:extensions:sog_planlagt_dispensering [2017-11-24 12:05] – [Forespørgsel] bbk
+++ fmk:extensions:sog_planlagt_dispensering [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
 ====== Søg planlagt dispensering ======
-Denne service anvendes til at fremsøge planlagte dispenseringer på tværs af patienter ud fra et drugid.
+Denne service anvendes til at fremsøge planlagte dispenseringer på tværs af borgere ud fra et drugid.
-Dette kan eksempelvis anvendes i forbindelse med takstændringer eller sortimentsændringer, der gør at et givet lægemiddel skal udskiftes på en hel række patienter.
+Dette kan eksempelvis anvendes i forbindelse med takst- eller sortimentsændringer, der nødvendiggør udskiftning af et lægemiddel for et antal patienter.
 ===== Forespørgsel =====
-I request-dokumentet skal der medsendes id på enten udleveringsapotektet eller pakkeapoteket. Desuden medsendes det DrugID, der søges efter.
+I request-dokumentet skal der medsendes id på enten udleveringsapotektet eller pakkeapoteket. Desuden medsendes det DrugID, der søges efter og der kan også medsende elementet IncludePatientDetails, hvilket vil gøre at svaret på requesten vil indeholde flere detailjer omkring patienten.
-Her er et eksempel, hvor der fremsøges ud fra udleveringsapoteket:
+**1.4.6.E6** forespøgslen er udvidet således der kan søges på flere lokationsnumre og lægemidler på samme tid.
+**Bemærk** Skemaet har indtil videre ingen begrænsning på hvor mange af de enkelte man kan angive på en gang. Det kan dog vise sig nødvendigt i fremtiden at sætte en begrænsning hvis det viser sig at der søges på så store mængder data at det giver problemer med performance.
+Her er et eksempel, hvor der fremsøges ud fra udleveringsapoteket og beder om patient detaljer:
 <file xml SearchPlannedDispensingRequest.xml>
@@ Line 15: / Line 18: @@
     <OrderedAtPharmacyIdentifier source="EAN-Lokationsnummer">5790000170609</OrderedAtPharmacyIdentifier>
     <DrugIdentifier source="Medicinpriser" date="2017-11-18">28100902676</DrugIdentifier>
+    <IncludePatientDetails />
 </SearchPlannedDispensingRequest>
 </file>
@@ Line 27: / Line 31: @@
 </file>
 ===== Svar =====
-I svaret returneres patientens CPR-nummer, og ID på alle de  planlagte dispenseringer af det angivne drug, der er tilknyttet patienter, hvis medicin håndteres dosisdipsenseret af det angivne udleveringsapotek eller pakkeapotek.
+I svaret returneres et antal patienter hvis medicin håndteres af det angivne udleverings- eller pakkeapotek. For hver patient returneres en liste af planlagte dispenseringer, der henviser til pågældende lægemiddel via en reference til lægemiddelordinationen, eller via en substitution foretaget af apoteket. Det fremgår endvidere om lægemidlet må substitueres, og om substitutionen sker efter borgerens eget ønske.
-<code xml SearchPlannedDispensingResponse.xml>
+**Bemærk**
+Når der søges ud fra udleveringsapotek, så vil der i svaret blive returneret de planned dispensings, tilhørende dosiskort hvor apoteket står som udleveringsapotek, hvori drugget indgår på lægemiddelordinatione, eller evt. som det substituerede drug.
+Hvis der bliver søgt ud fra pakkeapotek, vil der i svaret være identifiers på de planned dispensings tilhørende dosiskort hvor apoteket står som pakkeapotek, hvor planned dispensing indgår i en aktiv periode med status 'Klar til pakning', og hvor det pågældne drug er det der i øjeblikket er valgt til pakning, dvs. enten det som stod på ordinationen eller planned dispensing da den blev sat 'Klar til pakning' eller det som pakkeapoteket har valgt med servicen [[Subtitution ved den pakkende organisation]].
+Her ses et eksempel på et svar hvor IncludePatientDetails ikke er sat.
+<code xml SearchPlannedDispensingResponse.xml>
 <SearchPlannedDispensingResponse>
-    <PlannedDispensing>
+    <PersonWithPlannedDispensing>
 	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
-	<PlannedDispensingIdentifier>121814002</PlannedDispensingIdentifier>
+        <PlannedDispensingSummary>
-    </PlannedDispensing>
+            <Identifier>121814002</Identifier>
-    <PlannedDispensing>
+            <Version>32415221</Version>
-	<PersonIdentifier source="CPR">1010101010</PersonIdentifier>
+            <DoseDispensingCardIdentifier>7231715378</DoseDispensingCardIdentifier>
-	<PlannedDispensingIdentifier>134814017</PlannedDispensingIdentifier>
+            <DrugMedication>
-	<PlannedDispensingIdentifier>144517798</PlannedDispensingIdentifier>
+                <Identifier>2141521</Identifier>
-    </PlannedDispensing>
+                <Version>1234123</Version>
-    <PlannedDispensing>
+            </DrugMedication>
-	<PersonIdentifier source="CPR">2512484916</PersonIdentifier>
+            <AdministrationInstruction>Synkes hele</AdministrationInstruction>
-	<PlannedDispensingIdentifier>343443433</PlannedDispensingIdentifier>
+            <Substitution>
-    </PlannedDispensing>
+                <SubstitutionChosenByPatient />
-    <PlannedDispensing>
+                <Drug>
-	<PersonIdentifier source="CPR">1212121212</PersonIdentifier>
+                    <Identifier source="Medicinpriser">915378089</Identifier>
-	<PlannedDispensingIdentifier>123456789</PlannedDispensingIdentifier>
+                    <Name>Panodil</Name>
-    </PlannedDispensing>
+                </Drug>
+            </Substitution>
+            <SubstitutionAllowed>false</SubstitutionAllowed>
+        </PlannedDispensingSummary>
+    </PersonWithPlannedDispensing>
+    <PersonWithPlannedDispensing>
+        .....
+    </PersonWithPlannedDispensing>
 </SearchPlannedDispensingResponse>
+</code>
-</code>
+Her ses et eksempel på et svar hvor IncludePatientDetails er sat.
+<code xml SearchPlannedDispensingResponse.xml>
+<SearchPlannedDispensingResponse>
+    <PersonWithPlannedDispensing>
+	<Patient>
+            <Person>
+                <Name>
+                    <GivenName>Mads</GivenName>
+                    <MiddleName>Gudendahl</MiddleName>
+                    <Surname>Larsen</Surname>
+                </Name>
+                <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
+                <BirthDate>1996-18-05</BirthDate>
+                <Gender>male</Gender>
+            </Person>
+            <Address>
+                <StreetName>Stjerneplads</StreetName>
+                <StreetBuildingIdentifier>15B</StreetBuildingIdentifier>
+                <PostCodeIdentifier>8550</PostCodeIdentifier>
+                <DistrictName>Ryomgård</DistrictName>
+            </Address>
+        </Patient>
+        <PlannedDispensingSummary>
+            <Identifier>121814002</Identifier>
+            <Version>32415221</Version>
+            <DoseDispensingCardIdentifier>7231715378</DoseDispensingCardIdentifier>
+            <DrugMedication>
+                <Identifier>2141521</Identifier>
+                <Version>1234123</Version>
+            </DrugMedication>
+            <AdministrationInstruction>Synkes hele</AdministrationInstruction>
+            <Substitution>
+                <SubstitutionChosenByPatient />
+                <Drug>
+                    <Identifier source="Medicinpriser">915378089</Identifier>
+                    <Name>Panodil</Name>
+                </Drug>
+            </Substitution>
+            <SubstitutionAllowed>false</SubstitutionAllowed>
+        </PlannedDispensingSummary>
+    </PersonWithPlannedDispensing>
+    <PersonWithPlannedDispensing>
+        .....
+    </PersonWithPlannedDispensing>
+</SearchPlannedDispensingResponse>
+</code>