====== 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.6.0:xml-elementer:medicinkortets_nogle|PersonIdentifier]] på den patient som  dosisdispenseringskortet tilhører. Såfremt det pågældnede dispenseringskort skal anvendes som dosisdispenseringskort til organisationer, skal dette angives i ''OrganisationIdentifier'' på den pågældende organisation.

Herefter skal ét af følgende elementer vælges i et ''RequestedPeriod'' element:
  * ''CurrentPeriod'' indikerer, at man ønsker den nuværende aktive periode på dispenseringskortet returneret
  * ''CurrentAndPendingPeriods'' indikerer, at man ønsker den nuværende aktive og næstkommende periode på dispenseringskortet returneret
  * ''PendingPeriods'' indikerer, at man ønsker de næstkommende perioder på dispenseringskortet returneret
  * ''AdministrationOverview'' indikerer, at man ikke ønsker en periode, men en oversigt over alle planlagte administration som er tilknyttet dispenseringskortet
  * ''PeriodIdentifier'' indikerer, at man ønsker den specifikke periode på dispenseringskortet, med den pågældende identifier, returneret
  * ''RequestedDate'' indikerer at man ønsker, at de perioder, som var aktive på det pågældende tidspunkt, returneres

Til sidst kan elementet ''FillSubstitutionTemplates'' angives. Denne betyder at de nuværende substitutionskladder ønskes returneret. Dette har dog kun indflydelse for dispenseringskort fra apoteket, og for perioder som endnu ikke er sat "Klar til pakning" eller hvis der angives ''AdministrationOverview'' i sin ''RequestedPeriod''

<file xml GetDispensingCardRequestType.xml>
<GetDispensingCardRequestType>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<RequestedPeriod>
                <CurrentPeriod/>
        </RequestedPeriod>
</GetDispensingCardRequestType>
</file>

<file xml GetDispensingCardRequestType.xml>
<GetDispensingCardRequestType>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<RequestedPeriod>
                <AdministrationOverview/>
        </RequestedPeriod>
</GetDispensingCardRequestType>
</file>

<file xml GetDispensingCardRequestType.xml>
<GetDispensingCardRequestType>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<RequestedPeriod>
                <PeriodIdentifier>9841685168</PeriodIdentifier>
        </RequestedPeriod>
</GetDispensingCardRequestType>
</file>

<file xml GetDispensingCardRequestType.xml>
<GetDispensingCardRequestType>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<RequestedPeriod>
                <RequestedDate>2025-04-20</RequestedDate>
        </RequestedPeriod>
</GetDispensingCardRequestType>
</file>


==== Svar ====

[[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.

En ''RequestDateTime'' returneres som er det tidspunkt FMK modtog det pågældende request.

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.

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]].
 
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.


<file xml GetDispensingCardResponse.xml>
<GetDispensingCardResponse>
   <Patient>
      <Person>
         <Name>
            <GivenName>Hans</GivenName>
            <Surname>Jensen</Surname>
         </Name>
         <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
         <Gender>male</Gender>
      </Person>
   </Patient>
   <RequestDateTime>2025-04-26T12:39:25Z</RequestDateTime>
   <PatientRegistration>
      <Identifier>1538864468</Identifier>
      <Created>
         <By>
            <HealthcareProfessional>
            <Indentifier source="Autorisation">8AH23</Indentifier>
            <Name>Niels Madsen</Name>
         </HealthcareProfessional>
         <Role>Læge</Role>
         <Organisation>
            <Identifier source="Yder">12345</Identifier>
            <Type>kommune</Type>
            <Name>Lægerne Blikkersgade</Name>
            <AddressLine>Tusindfrydvej 17</AddressLine>
            <TelephoneNumber>99999999</TelephoneNumber>
            <EmailAddress>LMO@PLO.com</EmailAddress>
         </Organisation>
         </By>
         <DateTime>2025-03-017T09:38:12Z</DateTime>
      </Created>
      <Type>SetDoseDispensingOnHold</Type>
      <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>
               <ValidWarrant>
                  <Identifer>135153834689</Identifer>
                  <ValidFromDate>2024-01-01</ValidFromDate>
                  <ValidToDate>2026-01-01</ValidToDate>
               </ValidWarrant>
               <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>