Differences

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

--- fmk:1.6.0:services:list_dosisdispenseringspatienter [2025-10-17 09:55] – [Forespørgsel] sas
+++ fmk:1.6.0:services:list_dosisdispenseringspatienter [2026-03-06 08:53] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== TODO ======
-Skema rettelser gør at beskrivelser skal gennemgås
-  * Generelt er alt i "Svar" sektionen skrives om, da der har været en større ændringer her, og XML eksempler er havde fejl.
-====== List Dosisdispenseringspatienter ======
+====== List Dispenseringspatienter ======
 Denne service anvendes til at fremsøge alle de patienter der er tilknyttet et givet lægehus (jvf. sygesikringen) og som har et aktivt dispenseringskort.
@@ Line 12: / Line 9: @@
 ====== Forespørgsel ======
 [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#ListDispensingPatientsRequestType|Request]]
-Servicen kaldes med
+I en forespørgsel til servicen angives først hvilke information man ønsker at inkludere i sit svar fra FMK, herefter hvilke organisationer som skal søges på.
-  * En angivelse af om man ønsker detaljer om patienten eller blot CPR-numre.
-  * Angivelse af, om man ønsker oplysninger om patienter med dispenseringskort tiltænkt dosisdispensering og/eller manuel dispensering
-  * Det ydernummer man ønsker at liste DD patienter for. Det er muligt at angive flere ydernumre, hvis eksempelvis et lægehus har flere ydernumre.
-<code xml>
+Følgende muligheder findes for at specificere sine resultater:
-<ListDoseDispensingPatientsRequest>
+  * ''IncludePatientDetails'' markere at der ønskes detaljer omkring patienten (navn og adresse)
+  * ''IncludeDoseDispensingPatients'' markere at man ønsker at fremsøger dispenseringskort fra apoteket (Dosisdispensering)
+  * ''IncludeManualDispensingPatients'' markere man ønsker at fremsøger dispenseringskort fra hjemmeplejen o.lign
+Herefter angiver man hvilke(n) organisation(er) man ønsker at søge på i en række ''OrganisationIdentifier'' elementer.
+<file xml ListDispensingPatientsRequest.xml>
+<ListDispensingPatientsRequest>
     <IncludePatientDetails/>
     <IncludeDoseDispensingPatients/>
     <IncludeManualDispensingPatients/>
     <OrganisationIdentifier source="Yder">987441</OrganisationIdentifier>
-</ListDoseDispensingPatientsRequest>
+</ListDispensingPatientsRequest>
-</code>
+</file>
 ===== Svar =====
 [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#ListDispensingPatientsResponseType|Response]]
-Svaret fra servicen indeholder følgende for hvert ydernummer der er kaldt med:
+Svaret fra servicen indeholder en række ''Organisation'' elementer, en for hver der blev angivet i forespørgslen.
-  * Ydernummeret
-  * Hvis der er anfordret IncludePatientDetails: en liste af patienter med oplysninger om deres dispenseringskort -- ellers blot en liste af CPR-numre.
-Listen af patienter indeholder for hver patient følgende oplysninger:
+''Organisation'' elementerne indeholder hver en ''Identifier'' på den organisation der blev søgt på samt muligheden for en række ''PersonWithDispensingCard'' (elementerne forekommer ikke såfremt der ingen dispenseringspatienter er).
-  * Identifier for patientens dispenseringskort
-  * Dispenseringskortets ansvarlige organisation (f.eks. udleveringsapotek eller hjemmepleje)
-  * Tidspunkt for dispenseringskortets oprettelse
-I tilfælde, hvor en patient har flere aktive dispenseringskort, indeholder svaret oplysninger om hvert af patientens dispenseringskort, sorteret efter oprettelsesdato.
+Hvert ''PersonWithDispensingCard'' element indeholder følgende:
+  * et ''Patient'' eller ''PersonIdentifier'' element. ''Patient'' kommer såfremt man anvendte ''IncludePatientDetails'' i forespørgslen, eller kommer kun ''PersonIdentifier''.
+  * En række ''DispensingCardSummary'' elementer, et for hvert aktivt dispenseringskort som patienten har.
+''DispensingCardSummary'' elementerne indeholder følgende:
+  * ''DispensingCardIdentifier'' Unikt id for det enkelte dispenseringskort.
+  * ''DispensingCardOwner'' den nuværender "ejer" af dispenseringskortet.
+  * ''DispensingCardOwnerName'' navnet på den nuværende ejer.
+  * ''CreatedDateTime'' hvornår kortet originalt er blevet oprettet.
+  * Optionelt: en række ''DispensedMedication'' elementer, disse indeholder ''DrugMedicationIdentifier'' og optionelt også ''DrugName'' på de lægemiddelordinationer som dispenseres fra det pågældende dispenseringskort.
 Eksempel med patient detaljer:
-<code xml>
+<file xml ListDispensingPatientsResponse.xml>
-<ListDoseDispensingPatientsResponse>
+<ListDispensingPatientsResponse>
     <Organisation>
         <Identifier source="Yder">987441</Identifier>
-        <Patient>
+        <PersonWithDispensingCard>
-            <Person>
+            <Patient>
-                <Name>
+                <Person>
-                    <GivenName>Sonja</GivenName>
+                    <Name>
-                    <Surname>Kristensen</Surname>
+                        <GivenName>Sonja</GivenName>
-                </Name>
+                        <Surname>Kristensen</Surname>
-                <PersonIdentifier source="CPR">2006230004
+                    </Name>
-                </PersonIdentifier>
+                    <PersonIdentifier source="CPR">2006230004
-            </Person>
-            <AddressLine>Sumatravej 142</AddressLine>
-            <AddressLine>4840 Nørre Alslev</AddressLine>
-        </Patient>
-        <DispensingCardIdentifier>1751533926204027088</DispensingCardIdentifier>
-        <DispensingCardOwner source="SOR">987654321</DispensingCardOwner>
-        <CreatedDateTime>2025-11-29T12:00:00Z</CreatedDateTime>
-        <Patient>
-            <Person>
-                <Name>
-                    <GivenName>Lone</GivenName>
-                    <MiddleName>Jørgensen</MiddleName>
-                    <Surname>Bach</Surname>
-                </Name>
-                <PersonIdentifier source="CPR">1212205790
                 </PersonIdentifier>
-            </Person>
+                </Person>
-            <AddressLine>Niels Bohrs Vej 15</AddressLine>
+                <AddressLine>Sumatravej 142</AddressLine>
-            <AddressLine>6 th</AddressLine>
+                <AddressLine>4840 Nørre Alslev</AddressLine>
-            <AddressLine>8882 Fårvang</AddressLine>
+            </Patient>
-        </Patient>
+            <DispensingCardSummary>
-        <DispensingCardIdentifier>1751533926204003088</DispensingCardIdentifier>
+                <DispensingCardIdentifier>1751533926204027088</DispensingCardIdentifier>
-        <DispensingCardOwner source="EAN-Lokationsnummer">5790001381615</DispensingCardOwner>
+                <DispensingCardOwner source="SOR">987654321</DispensingCardOwner>
-        <CreatedDateTime>2025-12-01T08:00:00Z</CreatedDateTime>
+                <DispensingCardOwnerName>Plejehjemmet hedegaarden</DispensingCardOwnerName>
+                <CreatedDateTime>2025-11-29T12:00:00Z</CreatedDateTime>
+                <DispensedMedication>
+                    <DrugMedicationIdentifier>3216813135813</DrugMedicationIdentifier>
+                    <DrugName>Panodil</DrugName>
+                </DispensedMedication>
+                <DispensedMedication>...</DispensedMedication>
+                <DispensedMedication>...</DispensedMedication>
+                <DispensedMedication>...</DispensedMedication>
+                <DispensedMedication>...</DispensedMedication>
+                <DispensedMedication>...</DispensedMedication>
+            </DispensingCardSummary>
+        </PersonWithDispensingCard>
+        <PersonWithDispensingCard>...</PersonWithDispensingCard>
+        <PersonWithDispensingCard>...</PersonWithDispensingCard>
     </Organisation>
-</ListDoseDispensingPatientsResponse>
+</ListDispensingPatientsResponse>
-</code>
+</file>
-Hvis der ikke er anfordret PatientDetails kan svaret se sådan ud:
+Hvis der ikke er anmodet PatientDetails kan svaret se sådan ud:
-<code xml>
+<file xml ListDispensingPatientsResponse2.xml>
-<ListDoseDispensingPatientsResponse>
+<ListDispensingPatientsResponse>
     <Organisation>
         <Identifier source="Yder">987441</Identifier>
-        <PersonIdentifier source="CPR">1212205790</PersonIdentifier>
+        <PersonWithDispensingCard>
-        <PersonIdentifier source="CPR">2006230004</PersonIdentifier>
+            <PersonIdentifier source="CPR">1212205790</PersonIdentifier>
+            <DispensingCardSummary>
+                <DispensingCardIdentifier>1751533926204027088</DispensingCardIdentifier>
+                <DispensingCardOwner source="SOR">987654321</DispensingCardOwner>
+                <DispensingCardOwnerName>Plejehjemmet hedegaarden</DispensingCardOwnerName>
+                <CreatedDateTime>2025-11-29T12:00:00Z</CreatedDateTime>
+                <DispensedMedication>
+                    <DrugMedicationIdentifier>3216813135813</DrugMedicationIdentifier>
+                    <DrugName>Panodil</DrugName>
+                </DispensedMedication>
+                <DispensedMedication>...</DispensedMedication>
+                <DispensedMedication>...</DispensedMedication>
+                <DispensedMedication>...</DispensedMedication>
+                <DispensedMedication>...</DispensedMedication>
+                <DispensedMedication>...</DispensedMedication>
+            </DispensingCardSummary>
+        </PersonWithDispensingCard>
+        <PersonWithDispensingCard>...</PersonWithDispensingCard>
+        <PersonWithDispensingCard>...</PersonWithDispensingCard>
     </Organisation>
-</ListDoseDispensingPatientsResponse>
+</ListDispensingPatientsResponse>
-</code>
+</file>