====== 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 dispenseringskortet tilhører. Såfremt dispenseringskort skal anvendes i organisationskontekst, angives dette i ''OrganisationIdentifier''.

Herefter er der to muligheder hvis man ønsker at hente en eller flere periode skal der angives en ''RequestedPeriod'' som udfyldes med en af følgende elementer:
  * ''CurrentPeriod'' indikerer, at man ønsker den nuværende aktive periode returneret
  * ''CurrentAndPendingPeriods'' indikerer, at man ønsker den nuværende aktive og næstkommende periode returneret
  * ''PendingPeriods'' indikerer, at man ønsker næstkommende perioder returneret
  * ''PeriodIdentifier'' indikerer, at man ønsker en specifik periode via identifier
  * ''RequestedDate'' indikerer, at man ønsker perioder, som var aktive på det angivne tidspunkt

Alternativt til ''RequestedPeriod'' kan der angives ''AdministrationOverview'' som indikerer, at man ikke ønsker perioder, men en oversigt over planlagte administrationer. Når man arbejder med medicinen på dispenseringskortet bør dette være den normale tilstand man står i.

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>

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

==== 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>
  <RequestedPeriod>
    <AdministrationOverview/>
  </RequestedPeriod>
  <FillSubstitutionTemplates/>
</GetDispensingCardRequestType>
</file>

<file xml GetDispensingCardResponse_administrationOverview.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>

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

===== Case B: RequestedPeriod = periode-baseret (fx CurrentAndPendingPeriods) =====
<file xml GetDispensingCardRequestType_currentAndPending.xml>
<GetDispensingCardRequestType>
  <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
  <RequestedPeriod>
    <CurrentAndPendingPeriods/>
  </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>

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

    <Period>
      <Identifier>79816138</Identifier>
      <Version>12</Version>
      <Status>Pakning afsluttet</Status>
      <StartDate>2025-04-29</StartDate>
      <EndDate>2025-05-12</EndDate>

      <Dispensing>
        <Identifier>988413138</Identifier>
        <Version>787848468</Version>
        <ShortName>Panodil</ShortName>
        <Description>Hvid med lige kærv</Description>
        <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>

        <SubstitutionTemplate>...</SubstitutionTemplate>

        <PlannedAdministration>
          <Identifier>891353188</Identifier>
          <Version>8978641385</Version>
          <DrugMedication>...</DrugMedication>
          <ValidWarrant>
            <Identifier>135153834689</Identifier>
            <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>
              </Day>
            </PlannedAdministrationStructure>
          </PlannedAdministrationFixed>
        </PlannedAdministration>

        <TotalDispensedQuantity>24</TotalDispensedQuantity>
      </Dispensing>
    </Period>
  </DispensingCard>
</GetDispensingCardResponse>
</file>