Differences

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

--- fmk:1.6.0:services:hent_dispenseringskort [2025-10-15 12:32] – sas
+++ fmk:1.6.0:services:hent_dispenseringskort [2026-03-27 08:01] (current) – Made it with two examples mrt
@@ Line 1: / Line 1: @@
-====== TODO ======
-  * SDSTB-160: Opdater beskrivelse, skal beskrive at hjemmeplejen o.lign kan have udpeget de udleveringer deres dispesering er taget fra, er dermed hvilket lægemiddel der er anvendt
 ====== Hent dispenseringskort ======
 Service anvendes af parter som arbejder med, eller ønsker indsigt i, patientens dispensering.
 ==== Forespørgsel ====
-I 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>
-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>
-            <Name>Lægerne Blikkersgade</Name>
+                  <Quantity>1</Quantity>
-            <AddressLine>Tusindfrydvej 17</AddressLine>
+                </Dose>
-            <TelephoneNumber>99999999</TelephoneNumber>
+              </Day>
-            <EmailAddress>LMO@PLO.com</EmailAddress>
+            </PlannedAdministrationStructure>
-            <Type>kommune</Type>
+          </PlannedAdministrationFixed>
-            <Identifier source="Yder">12345</Identifier>
+        </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>Leveres til Jernbrogade 5, sættes foran døren og ring på klokken</Delivery>
-      <PackingGroupIdentifier>43186145</PackingGroupIdentifier>
-      <PackingGroupName>Borgere på Jernbrogade og Bakkegaarden</PackingGroupName>
-      <OrderedAtPharmacy>
-            <Name>Haderslev Løve Apotek</Name>
-            <AddressLine>Gravene 1</AddressLine>
-            <AddressLine>6100 Haderslev</AddressLine>
-            <TelephoneNumber>74522443</TelephoneNumber>
-            <Type>Apotek</Type>
-            <Identifier source="EAN-Lokationsnummer">5790000172924</Identifier>
-        </OrderedAtPharmacy>
-        <PackedAtOrganisation>
-            <Name>Humlebæk Apotek</Name>
-            <AddressLine>Humlebæk Center 23</AddressLine>
-            <AddressLine>3050 Humlebæk</AddressLine>
-            <TelephoneNumber>49191979</TelephoneNumber>
-            <Type>Apotek</Type>
-            <Identifier source="EAN-Lokationsnummer">5790000171545</Identifier>
-        </PackedAtOrganisation>
-      <DispensingNotes></DispensingNotes>
-      <DeliveryNotes></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>