Differences

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

--- fmk:1.6.0:services:hent_dispenseringskort [2025-10-29 20:40] – [Svar] rgm
+++ fmk:1.6.0:services:hent_dispenseringskort [2026-03-27 08:01] (current) – Made it with two examples mrt
@@ Line 1: / Line 1: @@
 ====== Hent dispenseringskort ======
 Service anvendes af parter som arbejder med, eller ønsker indsigt i, patientens dispensering.
 ==== Forespørgsel ====
-I [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetDispensingCardRequestType|request-dokumentet]] skal der medsendes en [[fmk:1.4.6:medicinkortets_nogle|PersonIdentifier]] på den patient som  dosisdispenseringskortet tilhører. Såfremt det pågældnede dispenseringskort skal anvendes som dosisdispenseringskort til organiastioner, skal dette angives i ''OrganiastionIdentifier'' på den pågældende organisation.
+I [[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetDispensingCardRequestType|request-dokumentet]] skal der medsendes en [[fmk:1.6.0:xml-elementer:medicinkortets_nogle|PersonIdentifier]] på den patient som dispenseringskortet tilhører. Såfremt dispenseringskort skal anvendes i organisationskontekst, angives dette i ''OrganisationIdentifier''.
-Herefter skal en af følgende elementer vælges:
+Herefter skal ét af følgende elementer vælges i ''RequestedPeriod'':
-  * ''CurrentPeriod'' indikere at man ønsker den nuværende aktive periode på dispenseringskortet returneres
+  * ''CurrentPeriod'' indikerer, at man ønsker den nuværende aktive periode returneret
-  * ''CurrentAndPendingPeriods'' indikere at man ønsker den nuværende aktive og næstkommende periode på dispenseringskortet returneres
+  * ''CurrentAndPendingPeriods'' indikerer, at man ønsker den nuværende aktive og næstkommende periode returneret
-  * ''PendingPeriods'' indikere at man ønsker de næstkommende perioder på dispenseringskortet returneres
+  * ''PendingPeriods'' indikerer, at man ønsker næstkommende perioder returneret
-  * ''AdministrationOverview'' indikere at man ikke ønsker en periode, men en oversigt over alle planlagte administration som er tilknyttet dispenseringskortet
+  * ''AdministrationOverview'' indikerer, at man ikke ønsker perioder, men en oversigt over planlagte administrationer
-  * ''PeriodIdentifier'' indikere at man ønsker den specifikke periode på dispenseringskortet, med den pågældende identifier, returneres
+  * ''PeriodIdentifier'' indikerer, at man ønsker en specifik periode via identifier
-  * ''RequestedDate'' indikere at man ønsker den de(n) periode(r) som var aktivt på det pågældende tidspunkt returneres
+  * ''RequestedDate'' indikerer, at man ønsker perioder, som var aktive på det angivne tidspunkt
-<file xml GetDispensingCardRequestType.xml>
+Til sidst kan ''FillSubstitutionTemplates'' angives. Dette betyder at aktuelle substitutionskladder ønskes returneret. Dette har kun effekt for dispenseringskort fra apotek og for perioder som endnu ikke er sat til "Klar til pakning", eller når ''AdministrationOverview'' anvendes.
+===== Generisk request-skabelon =====
+Brug samme skabelon og udskift kun indholdet af ''RequestedPeriod''.
+<file xml GetDispensingCardRequestType_template.xml>
 <GetDispensingCardRequestType>
-	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
+  <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
-	<CurrentPeriod>
-                <CurrentPeriod/>
+  <RequestedPeriod>
-        </RequestedPeriod>
+    <!-- Vælg præcis ét af følgende:
+         <CurrentPeriod/>
+         <CurrentAndPendingPeriods/>
+         <PendingPeriods/>
+         <AdministrationOverview/>
+         <PeriodIdentifier>9841685168</PeriodIdentifier>
+         <RequestedDate>2025-04-20</RequestedDate>
+    -->
+    <CurrentAndPendingPeriods/>
+  </RequestedPeriod>
+  <!-- Optional -->
+  <FillSubstitutionTemplates/>
 </GetDispensingCardRequestType>
 </file>
-<file xml GetDispensingCardRequestType.xml>
+==== Svar ====
+[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetDispensingCardResponseType|Svaret]] fra FMK indeholder detaljer om ''Patient'' eller ''Organisation'' alt efter om der blev anvendt ''PersonIdentifier'' eller ''OrganisationIdentifier'' i forespørgslen.
+En ''RequestDateTime'' returneres som tidspunktet FMK modtog requestet.
+Potentielt returneres en række ''PatientRegistration'' elementer (aktive registreringer med mulig indflydelse på dispensering, fx "DD i bero" og "Ikke egnet til DD"). Historik hentes via dedikeret service.
+Herefter kan følge en række ''DispensingCard'' elementer, som beskriver aktive dispenseringskort på patienten/organisationen. Se også [[fmk:1.6.0:xml-elementer:dispenseringskort|Dispenseringskort]].
+Bemærk at ''DispensingCard'' er optionelt. Hvis patienten ikke har et aktivt dispenseringskort, vil elementet ikke optræde i svaret. Dette adskiller sig fra 1.4.6-snitfladen, hvor FMK gav valideringsfejl hvis intet DD-kort fandtes.
+===== Choice i DispensingCard =====
+I ''DispensingCard'' gælder følgende choice:
+  * enten ''Period'' (0..*)
+  * eller ''AdministrationOverview'' (1)
+Det betyder:
+  * hvis ''RequestedPeriod/AdministrationOverview'' bruges i request, returneres ''AdministrationOverview'' i ''DispensingCard'' (ikke ''Period'')
+  * hvis en periode-baseret forespørgsel bruges (fx ''CurrentPeriod'', ''CurrentAndPendingPeriods'', ''PendingPeriods'', ''PeriodIdentifier'', ''RequestedDate''), returneres ''Period'' (ikke ''AdministrationOverview'')
+===== Case A: RequestedPeriod = AdministrationOverview =====
+<file xml GetDispensingCardRequestType_administrationOverview.xml>
 <GetDispensingCardRequestType>
-	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
+  <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
-	<CurrentPeriod>
+  <RequestedPeriod>
-                <AdministrationOverview/>
+    <AdministrationOverview/>
-        </RequestedPeriod>
+  </RequestedPeriod>
+  <FillSubstitutionTemplates/>
 </GetDispensingCardRequestType>
 </file>
-<file xml GetDispensingCardRequestType.xml>
+<file xml GetDispensingCardResponse_administrationOverview.xml>
-<GetDispensingCardRequestType>
+<GetDispensingCardResponse>
-	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
+  <Patient>
-	<RequestedPeriod>
+    <Person>
-                <PeriodIdentifier>9841685168</PeriodIdentifier>
+      <Name>
-        </RequestedPeriod>
+        <GivenName>Hans</GivenName>
-</GetDispensingCardRequestType>
+        <Surname>Jensen</Surname>
+      </Name>
+      <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
+    </Person>
+  </Patient>
+  <RequestDateTime>2025-04-26T12:39:25Z</RequestDateTime>
+  <DispensingCard>
+    <Identifier>386168168</Identifier>
+    <Version>1</Version>
+    <Description>Et dispenseringskort</Description>
+    <OrderedAtPharmacy>
+      <Identifier source="EAN-Lokationsnummer">5790000172924</Identifier>
+      <Type>Apotek</Type>
+      <Name>Haderslev Løve Apotek</Name>
+    </OrderedAtPharmacy>
+    <PackedAtOrganisation>
+      <Identifier source="EAN-Lokationsnummer">5790000171545</Identifier>
+      <Type>Apotek</Type>
+      <Name>Humlebæk Apotek</Name>
+    </PackedAtOrganisation>
+    <AdministrationOverview>
+      <PlannedAdministration>
+        <Identifier>891353188</Identifier>
+        <Version>8978641385</Version>
+        <DrugMedication>...</DrugMedication>
+        <SubstitutionTemplate>...</SubstitutionTemplate>
+      </PlannedAdministration>
+    </AdministrationOverview>
+  </DispensingCard>
+</GetDispensingCardResponse>
 </file>
-<file xml GetDispensingCardRequestType.xml>
+===== Case B: RequestedPeriod = periode-baseret (fx CurrentAndPendingPeriods) =====
+<file xml GetDispensingCardRequestType_currentAndPending.xml>
 <GetDispensingCardRequestType>
-	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
+  <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
-	<RequestedPeriod>
+  <RequestedPeriod>
-                <RequestedDate>2025-04-20</RequestedDate>
+    <CurrentAndPendingPeriods/>
-        </RequestedPeriod>
+  </RequestedPeriod>
+  <FillSubstitutionTemplates/>
 </GetDispensingCardRequestType>
 </file>
+<file xml GetDispensingCardResponse_currentAndPending.xml>
+<GetDispensingCardResponse>
+  <Patient>
+    <Person>
+      <Name>
+        <GivenName>Hans</GivenName>
+        <Surname>Jensen</Surname>
+      </Name>
+      <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
+    </Person>
+  </Patient>
+  <RequestDateTime>2025-04-26T12:39:25Z</RequestDateTime>
-==== Svar ====
+  <DispensingCard>
+    <Identifier>386168168</Identifier>
+    <Version>1</Version>
+    <Description>Et dispenseringskort</Description>
+    <PackingGroupIdentifier>43186145</PackingGroupIdentifier>
+    <PackingGroupName>Borgere på Jernbrogade og Bakkegaarden</PackingGroupName>
+    <OrderedAtPharmacy>
+      <Identifier source="EAN-Lokationsnummer">5790000172924</Identifier>
+      <Type>Apotek</Type>
+      <Name>Haderslev Løve Apotek</Name>
+    </OrderedAtPharmacy>
+    <PackedAtOrganisation>
+      <Identifier source="EAN-Lokationsnummer">5790000171545</Identifier>
+      <Type>Apotek</Type>
+      <Name>Humlebæk Apotek</Name>
+    </PackedAtOrganisation>
-[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetDispensingCardResponseType|Svaret ]]fra FMK indeholder detaljerne omkring ''Patient'' eller ''Organisation'' alt efter om der var anvendt ''PersonIdentifier'' eller ''OrganisationIdentifier'' i forespørgslen.
+    <Period>
+      <Identifier>79816138</Identifier>
+      <Version>12</Version>
+      <Status>Pakning afsluttet</Status>
+      <StartDate>2025-04-29</StartDate>
+      <EndDate>2025-05-12</EndDate>
-En ''RequestDateTime'' returneres som er det tidspunkt FMK modtog det pågældende request.
+      <Dispensing>
+        <Identifier>988413138</Identifier>
+        <Version>787848468</Version>
+        <ShortName>Panodil</ShortName>
+        <Description>Hvid med lige kærv</Description>
+        <Warning>...</Warning>
-Potentielt returneres der en række ''PatientRegistration'' elementer, disse er registreringer på patienten som potientelt har indflydelse på dispenseringen. Eksempler herpå er "DD i bero" markeringen, og den nye "Ikke egnet til DD" som indføres i 1.6.0. Det vil her kun være tale om Aktive registreringer, skal der hentes historiske registreringer, skal dedikeret service benyttes.
+        <Substitution>
+          <SubstitutionChosenByPatient/>
+          <Drug>
+            <Identifier source="Medicinpriser" sourceDate="2025-04-09">28101317587</Identifier>
+            <Name>Pamol</Name>
+            ...
+          </Drug>
+        </Substitution>
-Herefter kan følge en række ''DispensingCard'' elementer, som beskriver de enkelte aktive dispenseringskort på patienten/organisationen. Disse indeholder en række elementer som gennemgås nærmere her: [[fmk:1.6.0:xml-elementer:dispenseringskort|Dispenseringskort]].
+        <SubstitutionAtPacking>
+          <Drug>
-Bemærk at ''DispensingCard'' elementet er optionelt, altså hvis ikke patienten har et aktivt dispenseringkort, vil elementet ikke optræde i svaret. Dette er til forskel fra 1.4.6 snitfladen, hvor FMK gav en valideringsfejl såfremt der ikke fandtes et DD-kort for den pågældende patient.
+            <Identifier source="Medicinpriser" sourceDate="2025-04-09">28100636073</Identifier>
+            <Name>Panodil</Name>
+            ...
+          </Drug>
+        </SubstitutionAtPacking>
+        <SubstitutionTemplate>...</SubstitutionTemplate>
-<file xml GetDispensingCardResponse.xml>
+        <PlannedAdministration>
-<GetDispensingCardResponse>
+          <Identifier>891353188</Identifier>
-   <Patient>
+          <Version>8978641385</Version>
-      <Person>
+          <DrugMedication>...</DrugMedication>
-         <Name>
+          <ValidWarrant>
-            <GivenName>Hans</GivenName>
+            <Identifier>135153834689</Identifier>
-            <Surname>Jensen</Surname>
+            <ValidFromDate>2024-01-01</ValidFromDate>
-         </Name>
+            <ValidToDate>2026-01-01</ValidToDate>
-         <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
+          </ValidWarrant>
-         <Gender>male</Gender>
+          <Warning>...</Warning>
-      </Person>
+          <DosageUnit>
-   </Patient>
+            <DosageUnitText>stk</DosageUnitText>
-   <RequestDateTime>2025-04-26T12:39:25Z</RequestDateTime>
+          </DosageUnit>
-   <PatientRegistration>
+          <AdministrationInstruction>Synkes hele</AdministrationInstruction>
-      <Identifier>1538864468</Identifier>
+          <PlannedAdministrationFixed>
-      <Created>
+            <PlannedAdministrationStructure>
-         <By>
+              <IterationInterval>1</IterationInterval>
-            <HealthcareProfessional>
+              <StartDate>2024-05-01</StartDate>
-            <Indentifier source="Autorisation">8AH23</Indentifier>
+              <Day>
-            <Name>Niels Madsen</Name>
+                <Number>1</Number>
-         </HealthcareProfessional>
+                <Dose>
-         <Role>Læge</Role>
+                  <Time>morning</Time>
-         <Organisation>
+                  <SequenceNumber>699999</SequenceNumber>
-            <Identifier source="Yder">12345</Identifier>
+                  <Quantity>1</Quantity>
-            <Type>kommune</Type>
+                </Dose>
-            <Name>Lægerne Blikkersgade</Name>
+              </Day>
-            <AddressLine>Tusindfrydvej 17</AddressLine>
+            </PlannedAdministrationStructure>
-            <TelephoneNumber>99999999</TelephoneNumber>
+          </PlannedAdministrationFixed>
-            <EmailAddress>LMO@PLO.com</EmailAddress>
+        </PlannedAdministration>
-         </Organisation>
-         </By>
+        <TotalDispensedQuantity>24</TotalDispensedQuantity>
-         <DateTime>2025-03-017T09:38:12Z</DateTime>
+      </Dispensing>
-      </Created>
+    </Period>
-      <Type>SetDoseDispensingOnHold</Type>
+  </DispensingCard>
-      <ValidityPeriod>
-         <From>2025-03-017T09:38:12Z</From>
-         <To>2025-05-017T12:00:00Z</To>
-      </ValidityPeriod>
-      <Reason>Patienten er indlagt</Reason>
-   </PatientRegistration>
-   <DispensingCard>
-      <Identifier>386168168</Identifier>
-      <Description>Et lille dispenseringskort</Description>
-      <Delivery>
-         <DeliveryPriority>send til anden adresse samme dag</DeliveryPriority>
-         <AddressLine>Jernbrogade 5</AddressLine>
-         <AddressLine>8382 Hinnerup</AddressLine>
-      </Delivery>
-      <PackingGroupIdentifier>43186145</PackingGroupIdentifier>
-      <PackingGroupName>Borgere på Jernbrogade og Bakkegaarden</PackingGroupName>
-      <OrderedAtPharmacy>
-            <Identifier source="EAN-Lokationsnummer">5790000172924</Identifier>
-            <Type>Apotek</Type>
-            <Name>Haderslev Løve Apotek</Name>
-            <AddressLine>Gravene 1</AddressLine>
-            <AddressLine>6100 Haderslev</AddressLine>
-            <TelephoneNumber>74522443</TelephoneNumber>
-        </OrderedAtPharmacy>
-        <PackedAtOrganisation>
-            <Identifier source="EAN-Lokationsnummer">5790000171545</Identifier>
-            <Type>Apotek</Type>
-            <Name>Humlebæk Apotek</Name>
-            <AddressLine>Humlebæk Center 23</AddressLine>
-            <AddressLine>3050 Humlebæk</AddressLine>
-            <TelephoneNumber>49191979</TelephoneNumber>
-        </PackedAtOrganisation>
-      <DispensingNotes>Pakkes i så få poser som muligt</DispensingNotes>
-      <DeliveryNotes>Sendes i ulige uger</DeliveryNotes>
-      <Period>
-         <Identifier>79816138</Identifier>
-         <Status>Pakning afsluttet</Status>
-         <StartDate>2025-04-29</StartDate>
-         <EndDate>2025-05-12</EndDate>
-         <PackagedDateTime>2025-04-24T17:01:09Z</PackagedDateTime>
-         <Dispensing>
-            <Identifier>988413138</Identifier>
-            <Version>787848468</Version>
-            <ShortName>Panodil</ShortName>
-            <Description>Hvid med lige kærv</Description>
-            <Warning>...</Warning>
-            <Warning>...</Warning>
-            <Substitution>
-               <SubstitutionChosenByPatient/>
-               <Drug>
-                  <Identifier source="Medicinpriser" sourceDate="2025-04-09">28101317587</Identifier>
-                  <Name>Pamol</Name>
-                  ...
-               </Drug>
-            </Substitution>
-            <SubstitutionAtPacking>
-               <Drug>
-                  <Identifier source="Medicinpriser" sourceDate="2025-04-09">28100636073</Identifier>
-                  <Name>Panodil</Name>
-                  ...
-               </Drug>
-            </SubstitutionAtPacking>
-            <PlannedAdministration>
-               <Identifier>891353188</Identifier>
-               <Version>8978641385</Version>
-               <DrugMedication>...</DrugMedication>
-               <ValidWarrent>
-                  <Identifer>135153834689</Identifer>
-                  <ValidFromDate>2024-01-01</ValidFromDate>
-                  <ValidToDate>2026-01-01</ValidToDate>
-               </ValidWarrent>
-               <Warning>...</Warning>
-               <DosageUnit>
-                  <DosageUnitText>stk</DosageUnitText>
-               </DosageUnit>
-               <AdministrationInstruction>Synkes hele</AdministrationInstruction>
-               <PlannedAdministrationFixed>
-                  <PlannedAdministrationStructure>
-                     <IterationInterval>1</IterationInterval>
-                     <StartDate>2024-05-01</StartDate>
-                     <Day>
-                        <Number>1</Number>
-                        <Dose>
-                           <Time>morning</Time>
-                           <SequenceNumber>699999</SequenceNumber>
-                           <Quantity>1</Quantity>
-                        </Dose>
-                        <Dose>
-                           <Time>evening</Time>
-                           <SequenceNumber>1899999</SequenceNumber>
-                           <Quantity>1</Quantity>
-                        </Dose>
-                     </Day>
-                  </PlannedAdministrationStructure>
-               </PlannedAdministrationFixed>
-            </PlannedAdministration>
-            <TotalDispensedQuantity>24</TotalDispensedQuantity>
-         </Dispensing>
-         <Dispensing>
-            ...
-         </Dispensing>
-         <Dispensing>
-            ...
-         </Dispensing>
-      </Period>
-   </DispensingCard>
 </GetDispensingCardResponse>
 </file>