====== Hent lægemiddelordinationer ======

Servicen "Hent lægemiddelordinationer" henter en eller flere lægemiddelordinationer. Afhængigt af de medsendte parametre kan responset indeholde receptordinationer og udleveringer på lægemiddel­ordinationen. En lægemiddelordination har et unikt ID, lægemiddel­ordinations-ID eller ''Drug­Medication­Identifier'', som tildeles af FMK og som anvendes ved opslag direkte på lægemiddel­ordinationen.

Lægemiddelordinationen struktur er beskrevet dybdegående under xml-elementer: [[fmk:1.6.0:xml-elementer:laegemiddelordinationer|Lægemiddelordinationer]].

De mest komplekse dele er angivelsen af [[fmk:1.6.0:xml-elementer:laegemiddel:generelt|lægemiddel-struktur]]   og [[fmk:1.6.0:xml-elementer:dosering|dosering]].

===== Forespørgsel =====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#getdrugmedicationsrequesttype|Request]]

Kald til denne service starter enten med patientens ''PersonIdentifier'' eller ''OrganisationIdentifier''. Sidst nævnte er relevant i tilfælde hvor lægemiddelordinationen er tilknyttet et medicinkort, som benyttes til dosisdispensering til organisationer.

Herefter angives en eller flere ''Identifier'', ''IdentifierAndVersion'' og ''IdentifierAndDateTime'' alt efter hvad der ønskes hentet. ''Identifier'' anvendes når seneste version ønskes. ''IdentifierAndVersion'' anvendes, når en given version af lægemiddelordinationen ønskes, versionsnumre kan hentes med [[fmk:1.6.0:services:hent_laegemiddelordinations_versioner|hent LMO versioner]]. ''IdentifierAndDateTime'' anvendes, når man ønsker en given lægemiddelordination, som den så ud på det givne tidspunkt. De tre typer af forespørgsler kan kombineres i samme kald.

Elementet ''IncludeWarrants'' kan angives, såfremt man ønsker at svar fra servicen skal inkludere udleveringsgrundlag. I dette element kan et ''IncludeHandovers'' element også angives, såfremt man ønsker udleveringer på udleveringsgrundlag returneret.

Desuden kan man med elementet ''IncludeAdministrations'' angive at man ønsker eventuelle registrerede administrationer på lægemiddelordinationerne returneret.

I følgende eksempel hentes en enkelte lægemiddelordination, med både udleveringsgrundlag og udleveringer derpå samt administrationer

<file xml GetDrugMedicationsRequest.xml>

<GetDrugMedicationsRequest>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<Identifier>1221231331123</Identifier>
	<IncludeWarrants>
            <IncludeHandovers/>
        </IncludeWarrants>
        <IncludeAdministrations/>
</GetDrugMedicationsRequest>

</file>

Detaljer om hvad der returneres i historiske kald, findes på siden [[fmk:generel:historik|Historik]]

===== Svar =====

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#getdrugmedicationsresponsetype|Response]]

Svaret indeholder en eller flere lægemiddelordinationer, samt tilhørende data som angivet i forespørgslen. Dog kan PersonIdentifier være udskiftet med personens aktive CPR-nummer. (se evt. [[fmk:CPR skift]])

Herunder vises et svar med en lægemiddelordination. Elementerne er beskrevet i [[fmk:1.6.0:xml-elementer:laegemiddelordinationer| Lægemiddelordination]]

<file xml GetDrugMedicationsResponse.xml>
<GetDrugMedicationsResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <DrugMedication>
        <Identifier>13143641280998</Identifier>
        <Version>1341404071666006001</Version>
        <PreviousVersion>1341404070012003001</PreviousVersion>
        <NextVersion>134140408122001001</NextVersion>
        <Created>
            <By>
                <HealthcareProfessional>
                    <Identifier source="Autorisation">2Q5TK</Identifier>
                    <Name>Tess Christoffersen</Name>
                </HealthcareProfessional>
                <Role>Læge</Role>
                <Organisation>
                    <Identifier source="Yder">66974</Identifier>
                    <Type>Yder</Type>
                    <Name>Lægerne Vestergade</Name>
                    <AddressLine>Vestergade 2</AddressLine>
                    <AddressLine>8660 Skanderborg</AddressLine>
                    <TelephoneNumber>86521348</TelephoneNumber>
                    <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress>
                </Organisation>
            </By>
            <DateTime>2013-11-19T09:30:47.0Z</DateTime>
        </Created>
        <Type>Lægeordineret</Type>
        <Paused>
            <FromDate>2013-11-18</FromDate>
            <ToDate>2013-11-19</ToDate>
            <By>
                <HealthcareProfessional>
                    <Identifier source="Autorisation">VQDZR</Identifier>
                    <Name>Godfred Damgård</Name>
                </HealthcareProfessional>
                <Role>Læge</Role>
                <Organisation>
                    <Identifier source="Yder">1234</Identifier>
                    <Type>Yder</Type>
                    <Name>Læge Knud Holst</Name>
                    <AddressLine>Skanderborgvej 163</AddressLine>
                    <AddressLine>8260 Viby J</AddressLine>
                    <TelephoneNumber>44332211</TelephoneNumber>
                </Organisation>
            </By>
            <DateTime>2013-11-18T15:51:12.0Z</DateTime>
        </Paused>
        <ActivePeriod>
            <TreatmentStartDate>2013-11-18</TreatmentStartDate>
            <TreatmentEndDate>2013-11-30</TreatmentEndDate>
            <EndedReason>Expired</EndedReason>
        </ActivePeriod>
        <Indication>
            <Code date="2013-11-18" source="Medicinpriser">121</Code>
        </Indication>
        <RouteOfAdministration>
            <Code date="2013-11-18" source="Medicinpriser">OR</Code>
        </RouteOfAdministration>
        <Drug>
            <Identifier date="2012-08-06" source="Medicinpriser">28100902676</Identifier>
            <Name>Primcillin</Name>
            <ATC>
                <Code date="2012-08-06" source="Medicinpriser">J01CE02</Code>
                <Text>Phenoxymethylpenicillin</Text>
            </ATC>
            <Form>
                <Code date="2012-08-06" source="Medicinpriser">TABFILM</Code>
                <Text>filmovertrukne tabletter</Text>
            </Form>
            <Strength>
                <StrengthItem>
                    <Value>250.0</Value>
                    <UnitCode date="2012-08-06" source="Medicinpriser">MG</UnitCode>
                    <UnitText>mg</UnitText>
                </StrengthItem>
                <Text date="2012-08-06" source="Medicinpriser">250 mg</Text>
            </Strength>
        </Drug>
        <Dosage>
            <Precondition>
                <StartDate>2023-12-22</StartDate>
            </Precondition>
            <UnitTexts>
                <Singular>tablet</Singular>
                <Plural>tabletter</Plural>
            </UnitTexts>
            <StructureFixed>
                <DosagePeriod>
                    <IterationInterval>1</IterationInterval>
                    <Day>
                        <Index>1</Index>
                        <Dose>
                            <TimeOfDay>morning</TimeOfDay>
                            <Quantity>2</Quantity>
                        </Dose>
                        <Dose>
                            <TimeOfDay>evening</TimeOfDay>
                            <Quantity>2</Quantity>
                        </Dose>
                    </Day>
                    <Profile>
                        <ProfileCode>
                            <DosageType>Fast</DosageType>
                            <PeriodType>Repeating</PeriodType>
                            <Schedule>Non-specific weekdays</Schedule>
                            <Frequency>Morning, noon, evening, night</Frequency>
                        </ProfileCode>
                        <ProfileDescription>Fast daglig gentaget dosering med en eller flere doser morgen/middag/aften/nat</ProfileDescription>
                    </Profile>
                    <EndDate>
                        <Unknown/>
                    </EndDate>
                    <DosageTranslation>
                        <ShortText>2 tabletter morgen og aften</ShortText>
                        <LongText>Doseringsforløbet starter lørdag den 22. december 2023 og gentages hver dag:
                            Doseringsforløb:
                            2 tabletter morgen og aften</LongText>
                        <AverageDailyDosage>4</AverageDailyDosage>
                    </DosageTranslation>
                </DosagePeriod>
             </StructureFixed>
             <DosageTranslationCombined>
                <ShortText>2 tabletter morgen og aften</ShortText>
                <LongText>Doseringsforløbet starter fredag den lørdag den 22. december 2023 og gentages hver dag:
                   Doseringsforløb:
                   2 tabletter morgen og aften</LongText>
                <AverageDailyDosage>4</AverageDailyDosage>
             </DosageTranslationCombined>
        </Dosage>
        <SubstitutionAllowed/>
        <HandoverPreference>Prescription</HandoverPreference>
        <ReimbursementApprovedCode>PREFS</ReimbursementApprovedCode>
    </DrugMedication>
</GetDrugMedicationsResponse>
</file>

=== Privatmarkering ===

:!: Flyttes til ResponseHeader

Såfremt lægemiddelordinationen er privatmarkeret, og der ikke er angivet ...[[fmk:generel:privatmarkering|Privatmarkering]], returneres kun id og versionsid i ''PrivateDrugMedication'':

<file xml GetDrugMedicationsResponse-NegativeConsent.xml>

<GetDrugMedicationsResponse>
    <PersonIdentifier>1111111118</PersonIdentifier>
    <PrivateDrugMedication>
        <Identifier>13143641280998</Identifier>
        <Version>1341404071666006001</Version>
    </PrivateDrugMedication>
</GetDrugMedicationsResponse>

</file>

=== Administrativt slettet lægemiddelordination ===

Endelig kan lægemiddelordinationen være [[fmk:generel:ugyldig-markering_af_data|administrativt slettet]], i så fald returneres kun id i ''InvalidDrugMedication''.

<file xml GetDrugMedicationsResponse-Invalid.xml>
<GetDrugMedicationsResponse>
    <PersonIdentifier>1111111118</PersonIdentifier>
    <InvalidDrugMedication>
        <Identifier>13143641280998</Identifier>
    </InvalidDrugMedication>
</GetDrugMedicationsResponse>
</file>