===== Hent eksplicit dosisdispenseringskort =====

Dette er en variant af servicen [[Hent dosisdispenseringskort]] der er målrettet dosisdispenseringskort, der håndteres via FMK. Det vil sige der findes et eksplicit dosisdispenseringskort oprettet med [[Opret dosisdispenseringskort]]. 

Det betyder at modsætning til [[Hent dosisdispenseringskort]] at denne service vil fejle hvis ikke patienten har et eksplicit dosisdispenseringskort.

==== Forespørgsel ====

Servicen kan kaldes med de samme parametre som [[Hent dosisdispenseringskort]]

**E6** I 1.4.6.E6 er requesten udvidet således: Der kan hentes for en specifik periode ved brug af ''Identifier'' parameter i ''RequestedPeriod''. ''IgnorePeriods'' er udvidet med mulighed for at angive underelementet ''DosageFilterDateTime'' som benyttes til at filterer doseringer før denne dato fra i responset.

eksempelvis:

<code xml>
<GetExplicitDoseDispensingCardRequest>
    <PersonIdentifier source="CPR">1403837853</PersonIdentifier>
    <RequestedPeriod>
        <PendingPeriods/>
    </RequestedPeriod>
    <IncludeDetailedSpecification/>
</GetExplicitDoseDispensingCardRequest>
</code>

==== Response ====

Svaret fra denne service adskiller sig fra [[Hent Dosisdispenseringskort]] på følgende områder:
  * Hvis der ikke findes et eksplicit dosisdispenseringskort for patienten, returneres en fejl 
  * Kaldet vil også fejle hvis det forsøges hentning af en specifik periode (Current, Pending, CurrentAndPending), men sådan en periode ikke findes.
  * DoseDispensedMedication omnavngives til PlannedDispensing, så det er allignet med navngivning i eksplicitte dosisdispenseringskort
  * Hvis der kaldes med IgnorePeriods returneres en ‘AnyPeriod’ struktur i stedet for en periode uden datoer.
  * Pakningstidspunktet returneres sammen med dosisdispenseringsperioden for pakkede perioder.
  * Er en dosisperiode kasseret, returneres en dato for hvornår rullen skal kasseres fra.
  * Der returneres ingen recepter under DrugMedication
  * PlannedDispensing indeholder et element ValidPrescription, der angiver om der findes en gyldig recept, og i givet fald dens gyldighedsperiode
  * Delivery på dosisdispenseringskortet ændres fra den eksisterende struktur til et fritekstfelt.

**Bemærk** Hvis der anvendes E5 version af hent eksplicit dosiskort, er forespørgslen den samme, men i svaret vil der også være et ''IsDoseDispensed'' på hvert DrugMedication element, og samtidig vil elementet ''MoreEffectuationsAvailable'' ikke forekomme.

I E6 er der tilføjet en markering af om kortet er nedlagt. Det vil sige hvis der vises perioder for et DD-kort som efterfølgende er nedlagt af apoteket vil DoseDispensingCard elementet indeholde et ''IsClosed'' flag. 

Eksempel hvor der er bedt om en bestemt periode, og der er bedt om pakningsgrundlag med "IncludeDetailedSpecification":
<code xml>
<GetExplicitDoseDispensingCardResponse>
    <Patient>
        ...
    </Patient>
    <RequestDateTime>2019-12-13T14:25:31Z</RequestDateTime>
    <DoseDispensingCard>
        <Identifier>1576247131093003717</Identifier>
        <Description>Standard dosisdispenseringskort</Description>
        <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>
        <Period>
            <Identifier>1576247131093005717</Identifier>
            <Status>Planlagt</Status>
            <StartDate>2019-12-20</StartDate>
            <EndDate>2020-01-03</EndDate>
            <Deadline>2019-12-13T14:25:31Z</Deadline>
            <ProductionIdentifier>1234</ProductionIdentifier>
            <PlannedDispensing>
                <Identifier>1576247131093007717</Identifier>
                <Version>1576247131093008717</Version>
                <DrugMedication>
                    <Identifier>23801</Identifier>
                    <Version>1576247131093002717</Version>
                    <Created>
                        ...
                    </Created>
                    <Modified>
                       ...
                    </Modified>
                    <Type>Lægeordineret</Type>
                    <BeginEndDate>
                        <CreatedDateTime>2019-12-13T14:25:31Z</CreatedDateTime>
                        <TreatmentStartDate>2019-11-13</TreatmentStartDate>
                        <TreatmentEndDate>2020-01-13</TreatmentEndDate>
                    </BeginEndDate>
                    <Indication>
                        <Code date="2009-02-16" source="Medicinpriser">2</Code>
                        <Text>mod for meget mavesyre</Text>
                    </Indication>
                    <RouteOfAdministration>
                        <Code date="2019-10-04" source="Medicinpriser">OF</Code>
                        <Text>Oftalmisk anvendelse</Text>
                    </RouteOfAdministration>
                    <Drug>
                        <ATC>
                            <Code date="2019-10-04" source="Medicinpriser">N06DA03</Code>
                            <Text>Rivastigmin</Text>
                        </ATC>
                        <Identifier date="2019-10-04" source="Medicinpriser">28103033598</Identifier>
                        <Name>Prometax</Name>
                        <Form>
                            <Code date="2019-10-04" source="Medicinpriser">KAPH</Code>
                            <Text>kapsler, hårde</Text>
                        </Form>
                        <Strength>
                            <Value>4.5</Value>
                            <UnitCode date="2019-10-04" source="Medicinpriser">MG</UnitCode>
                            <UnitText>mg</UnitText>
                            <Text date="2019-10-04" source="Medicinpriser">4,5 mg</Text>
                        </Strength>
                    </Drug>
                    <Dosage>
                        <UnitTexts>
                            <Singular>stk</Singular>
                            <Plural>stk</Plural>
                        </UnitTexts>
                        <StructuresAccordingToNeed>
                            <Structure>
                                <IterationInterval>1</IterationInterval>
                                <StartDate>2019-11-13</StartDate>
                                <EndDate>2020-01-13</EndDate>
                                <SupplementaryText>Mod smerter</SupplementaryText>
                                <Day>
                                    <Number>1</Number>
                                    <Dose>
                                        <Quantity>1</Quantity>
                                    </Dose>
                                </Day>
                                <DosageTranslation>
                                   ...
                                </DosageTranslation>
                            </Structure>
                            <DosageTranslationCombined>
                                ...
                            </DosageTranslationCombined>
                        </StructuresAccordingToNeed>
                        <Type>efter behov</Type>
                    </Dosage>
                    <SubstitutionAllowed>false</SubstitutionAllowed>
                </DrugMedication>
                <ValidPrescription>
                    <Identifier>313946733413088</Identifier>
                    <ValidFromDate>2019-12-13</ValidFromDate>
                    <ValidToDate>2020-02-12</ValidToDate>
                </ValidPrescription>
                <Warning>
                    <WarningCode>4302</WarningCode>
                    <WarningText>Der er ikke overensstemmelse mellem den ordinerede mængde og den pakkede mængde. Doseringen afviger på følgende dage: 20-12-2019 - 03-01-2020</WarningText>
                    <Severity>high</Severity>
                </Warning>
                <Warning>
                    <WarningCode>4141</WarningCode>
                    <WarningText>Lægemidlet må ikke substitueres</WarningText>
                    <Severity>high</Severity>
                </Warning>
                <Substitution>
                    <Drug>
                        <ATC>
                            <Code date="2011-02-19" source="Medicinpriser">V08AB05</Code>
                            <Text>Iopromid</Text>
                        </ATC>
                        <Identifier date="2011-02-19" source="Medicinpriser">28101201084</Identifier>
                        <Name>Ultravist</Name>
                        <Form>
                            <Code date="2011-02-19" source="Medicinpriser">INVSKO</Code>
                            <Text>injektions-/infusionsvæske, opløsning</Text>
                        </Form>
                        <Strength>
                            <Value>240.0</Value>
                            <UnitCode date="2011-02-19" source="Medicinpriser">MJM</UnitCode>
                            <UnitText>mg jod/ml</UnitText>
                            <Text date="2011-02-19" source="Medicinpriser">240 mg iod/ml</Text>
                        </Strength>
                        <Substances>
                            <ActiveSubstance>
                                <SubstanceText date="2011-02-19" source="Medicinpriser">Iopromid</SubstanceText>
                            </ActiveSubstance>
                        </Substances>
                    </Drug>
                </Substitution>
                <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                <PlannedAdministration>
                    <UnitTexts>
                        <Singular>tablet</Singular>
                        <Plural>tabletter</Plural>
                    </UnitTexts>
                    <PlannedAdministrationFixed>
                        <PlannedAdministrationStructure>
                            <IterationInterval>1</IterationInterval>
                            <StartDate>2019-12-13</StartDate>
                            <EndDate>2020-06-13</EndDate>
                            <Day>
                                <Number>1</Number>
                                <Dose>
                                    <Time>morning</Time>
                                    <SequenceNumber>79902</SequenceNumber>
                                    <Quantity>1</Quantity>
                                </Dose>
                            </Day>
                        </PlannedAdministrationStructure>
                    </PlannedAdministrationFixed>
                </PlannedAdministration>
                <TotalNumberOfDoseDispensedQuantity>15</TotalNumberOfDoseDispensedQuantity>
                <DoseDispensingEndDate>2020-01-13</DoseDispensingEndDate>
            </PlannedDispensing>
            <DetailedSpecification>
                <DispensableUnit>
                    <Date>2019-12-20</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576247131093007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-21</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576247131093007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-22</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576247131093007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-23</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576247131093007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-24</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576247131093007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-25</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576247131093007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-26</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576247131093007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-27</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576247131093007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-28</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576247131093007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-29</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576247131093007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-30</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576247131093007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2019-12-31</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576247131093007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2020-01-01</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576247131093007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2020-01-02</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576247131093007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
                <DispensableUnit>
                    <Date>2020-01-03</Date>
                    <Time>morning</Time>
                    <SequenceNumber>79902</SequenceNumber>
                    <AdministrationInstruction>Synkes hele</AdministrationInstruction>
                    <MedicationRef>
                        <MedicationIdentifier>1576247131093007717</MedicationIdentifier>
                        <Quantity>1</Quantity>
                    </MedicationRef>
                </DispensableUnit>
            </DetailedSpecification>
        </Period>
    </DoseDispensingCard>
</GetExplicitDoseDispensingCardResponse>
</code>

Eksempel hvor der er brugt ignorePeriod:
<code xml>
<GetExplicitDoseDispensingCardResponse>
    <Patient>
        <Person>
            <Name>
                <GivenName>Rob</GivenName>
                <Surname>Müller</Surname>
            </Name>
            <PersonIdentifier source="CPR">1403837853</PersonIdentifier>
            <BirthDate>1983-03-14</BirthDate>
            <Gender>male</Gender>
        </Person>
        <Address>
            <StreetName>Magnolievej</StreetName>
            <StreetBuildingIdentifier>842</StreetBuildingIdentifier>
            <FloorIdentifier>4</FloorIdentifier>
            <PostCodeIdentifier>8653</PostCodeIdentifier>
            <DistrictName>Them</DistrictName>
        </Address>
    </Patient>
    <RequestDateTime>2016-06-10T12:00:00Z</RequestDateTime>
    <DoseDispensingCard>
        <Identifier>154523914057284</Identifier>
        <Description>Et lille eksplicit dosiskort</Description>
        <Delivery>Leveres til patientens dør dagen efter pakning</Delivery>
        <PackingGroupIdentifier>17</PackingGroupIdentifier>
        <PackingGroupName>Bjørneklo center</PackingGroupName>
        <OrderedAtPharmacy>
            <Name>Århus Jernbane Apotek</Name>
            <AddressLine>Banegårdsplads 8</AddressLine>
            <AddressLine>8000 Århus</AddressLine>
            <Type>Apotek</Type>
            <Identifier source="EAN-Lokationsnummer">5790000171323</Identifier>
        </OrderedAtPharmacy>
        <PackedAtOrganisation>
            <Name>Århus Stjerne Apotek</Name>
            <AddressLine>Funch Thomsensgade 3</AddressLine>
            <AddressLine>8200 Århus N</AddressLine>
            <Type>Apotek</Type>
            <Identifier source="EAN-Lokationsnummer">5790000173525</Identifier>
        </PackedAtOrganisation>
        <NormalPeriodDuration>14</NormalPeriodDuration>
        <DoseDispensableUnitLabel>Til grøn dør</DoseDispensableUnitLabel>
        <AnyPeriod>
            <PlannedDispensing>
                <Identifier>978915</Identifier>
                <Version>785138</Version>
                <DrugMedication>
                    <Identifier>1280118</Identifier>
                    <Version>1341404071666005</Version>
                    <PreviousVersion>1341404088742003001</PreviousVersion>
                    <Created>
                        <By>
                            <AuthorisedHealthcareProfessional>
                                <AuthorisationIdentifier>J0184</AuthorisationIdentifier>
                                <Name>Lars Larsen</Name>
                            </AuthorisedHealthcareProfessional>
                            <Organisation>
                                <Name>Lægerne Strandvejen 83</Name>
                                <AddressLine>Strandvejen 83</AddressLine>
                                <AddressLine>3390 Hundested</AddressLine>
                                <TelephoneNumber>47982525</TelephoneNumber>
                                <Type>Yder</Type>
                                <Identifier source="Yder">18244</Identifier>
                            </Organisation>
                        </By>
                        <DateTime>2016-03-04T12:31:06Z</DateTime>
                    </Created>
                    <Type>Lægeordineret</Type>
                    <BeginEndDate>
                        <TreatmentStartDate>2015-03-07</TreatmentStartDate>
                        <TreatmentEndDate>2045-03-07</TreatmentEndDate>
                    </BeginEndDate>
                    <Indication>
                        <Code source="Medicinpriser" date="2016-02-22">121</Code>
                    </Indication>
                    <RouteOfAdministration>
                        <Code source="Medicinpriser" date="2016-02-22">OR</Code>
                    </RouteOfAdministration>
                    <Drug>
                        <Identifier source="Medicinpriser" date="2016-02-22">28103848705</Identifier>
                        <Name>Lamotrigin "Merck NM"</Name>
                        <Form>
                            <Code source="Medicinpriser" date="2016-02-22">TAB</Code>
                            <Text>tabletter</Text>
                        </Form>
                        <Strength>
                            <Value>100</Value>
                            <UnitCode source="Medicinpriser" date="2016-02-22">MG</UnitCode>
                            <UnitText>mg</UnitText>
                            <Text source="Medicinpriser" date="2016-02-22">100 mg</Text>
                        </Strength>
                    </Drug>
                    <Dosage>
                        <UnitTexts>
                            <Singular>tablet</Singular>
                            <Plural>tabletter</Plural>
                        </UnitTexts>
                        <StructuresFixed>
                            <Structure>
                                <IterationInterval>1</IterationInterval>
                                <StartDate>2016-03-07</StartDate>
                                <EndDate>2023-03-07</EndDate>
                                <SupplementaryText>Synkes hele</SupplementaryText>
                                <Day>
                                    <Number>1</Number>
                                    <Dose>
                                        <Time>morning</Time>
                                        <Quantity>3</Quantity>
                                    </Dose>
                                </Day>
                                <DosageTranslation>
                                    <ShortText>3 tablet morgen</ShortText>
                                    <LongText>Doseringsforløbet starter lørdag den 7. marts 2015 og gentages hver dag:
                                    Doseringsforløb:
                                    3 tablet morgen</LongText>
                                    <AverageDailyDosage>3</AverageDailyDosage>
                                </DosageTranslation>
                            </Structure>
                        </StructuresFixed>
                        <Type>fast</Type>
                    </Dosage>
                    <SubstitutionAllowed>true</SubstitutionAllowed>
                    <ReimbursementClause>klausulbetingelse opfyldt</ReimbursementClause>
                </DrugMedication>
                <ValidPrescription>
                    <Identifier>3505913</Identifier>
                    <ValidFromDate>2019-01-01</ValidFromDate>
                    <ValidToDate>2020-01-01</ValidToDate>
                </ValidPrescription>
                <ShortName>...</ShortName>
                <Description>...</Description>
                <AdministrationInstruction>Knuses</AdministrationInstruction>
                <PlannedAdministration>
                    <UnitTexts>
                        <Singular>tablet</Singular>
                        <Plural>tabletter</Plural>
                    </UnitTexts>
                    <PlannedAdministrationFixed>
                        <PlannedAdministrationStructure>
                            <IterationInterval>1</IterationInterval>
                            <StartDate>2019-01-23</StartDate>
                            <EndDate>2019-02-05</EndDate>
                            <Day>
                                <Number>1</Number>
                                <Dose>
                                    <Time>morning</Time>
                                    <Quantity>3</Quantity>
                                </Dose>
                            </Day>
                        </PlannedAdministrationStructure>
                    </PlannedAdministrationFixed>
                </PlannedAdministration>
                <TotalNumberOfDoseDispensedQuantity>42</TotalNumberOfDoseDispensedQuantity>
                <DoseDispensingEndDate>2045-03-07</DoseDispensingEndDate>
            </PlannedDispensing>
            <PlannedDispensing>
                <Identifier>11808901</Identifier>
                ...
            </PlannedDispensing>
            <PlannedDispensing>
                <Identifier>11298719</Identifier>
                ...
            </PlannedDispensing>
        </AnyPeriod>
    </DoseDispensingCard>
</GetExplicitDoseDispensingCardResponse>
</code>

Hvis Der i requested er angivet IncludeDetailedSpecification returneres detaljer om hvad der skal pakkes i de enkelte poser i en dosisdispenseringsperiode. Dette er primært tiltænkt pakkeapotekets, hentning af [[pakkegrundlaget]] for dosisrullen.

==== Advarsler ====

En liste af advarsler for det eksplicitte dosisdispenseringskort kan findes her: [[Advarsler til Dosisdispensering]]