====== Hent lægemiddelordination ======

Servicen "Hent lægemiddelordination" henter en eller flere lægemiddelordinationer. Afhængigt af de medsendte parametre kan responset indeholde recepter, bestillinger og effektueringer 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.

==== Forespørgsel ====

Eksemplet viser en forespørgsel efter seneste version af en lægemiddelordination (forespørgslen kan alternativt udpege en liste af lægemiddelordinations-ID'er). For at sikre at alle lægemiddelordinationer hører til samme medicinkort medsendes patientens CPR-nummer. 

<code xml GetDrugMedicationRequest-minimal.xml>
<GetDrugMedicationRequest>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<Identifier>1221231331123</Identifier>
	<IncludePrescriptions>false</IncludePrescriptions>
	<IncludeEffectuations>false</IncludeEffectuations>
</GetDrugMedicationRequest>

</code>

=== Privatmarkering ===

Via ConsentHeader angives, at såfremt en eller flere af læge­middel­ordinationerne er markeret med privatmarkering sker forespørgselen af en af to årsager, disse angives ved anvendelse af en af de to ConsentType elementer:

  * PrivateDataConsentOverridden såfremt opslaget sker for nødvendig til varetagelse af en åbenbar almen interesse eller af væsentlige hensyn til patienten. 

  * PrivateDataConsentGiven såfremt opslaget sker efter mundtlig eller skriftlig samtykke. 

Disse to typer af forespørgsler vil blive logget specielt. Såfremt opslaget sker efter patientens samtykke, skal der i kaldet angives i hvilket datointerval dette samtykke sker. Værdien kan evt. anvendes i forbindelse med opfølgning på logdata. 

=== Valg af indhold i response ===

Request-dokumentet indeholder to felter til angivelse af, hvad der ønskes returneret i responset, ud over data direkte på lægemiddelordinationen:

  * IncludePrescriptions: Såfremt elementet sættes til true vil svaret indeholde eventuelle recepter knyttet til lægemiddelordinationen.  

  * IncludeEffectuations: Såfremt elementet sættes til true vil svaret indeholde eventuelle effektueringer på lægemiddelordinationen.

=== Forespørgsel på tidligere versioner ===

Ønskes der en tidligere version af lægemiddelordinationen kan der forespørges ud fra versionsnummer.

<code xml GetDrugMedicationRequest-IdAndVersion.xml>
<GetDrugMedicationRequest>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<IdentifierAndVersion>
		<Identifier>1221231331123</Identifier>
		<Version>1341404077658001001</Version>
	</IdentifierAndVersion>
	<IncludePrescriptions>false</IncludePrescriptions>
	<IncludeEffectuations>false</IncludeEffectuations>
</GetDrugMedicationRequest>

</code>

Endeligt kan der forespørges efter lægemiddelordinationen som det så ud på et givent tidspunkt, dvs. med et tidsstempel.

<code xml GetDrugMedicationRequest-IdAndDate.xml>
<GetDrugMedicationRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <IdentifierAndDateTime>
        <Identifier>1221231331123</Identifier>
        <DateTime>2012-07-04T08:34:44Z</DateTime>
    </IdentifierAndDateTime>
    <IncludePrescriptions>false</IncludePrescriptions>
    <IncludeEffectuations>false</IncludeEffectuations>
</GetDrugMedicationRequest>

</code>

De tre typer af forespørgsler kan kombineres i samme kald.

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

Der returneres et eller flere lægemiddelordinationer, samt tilhørende data som angivet i forespørgslen.

Herunder vises et svar med en lægemiddelordination, se [[Lægemiddelordination]] for flere detaljer. 

<code xml GetDrugMedicationResponse.xml>
<GetDrugMedicationResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <DrugMedication>
        <Identifier>13143641280998</Identifier>
        <Version>1341404071666006001</Version>
        <PreviousVersion>1341404070012003001</PreviousVersion>
        <Created>
            <By>
                <AuthorisedHealthcareProfessional>
                    <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier>
                    <Name>Tess Christoffersen</Name>
                    <SpecialityCode source="Medicinpriser" date="2014-11-18">PSYK</SpecialityCode>
                </AuthorisedHealthcareProfessional>
                <Organisation>
                    <Name>Lægerne Vestergade</Name>
                    <AddressLine>Vestergade 2</AddressLine>
                    <AddressLine>8660 Skanderborg</AddressLine>
                    <TelephoneNumber>86521348</TelephoneNumber>
                    <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress>
                    <Type>Yder</Type>
                    <Identifier source="Yder">66974</Identifier>
                </Organisation>
            </By>
            <DateTime>2014-11-19T09:30:47.0Z</DateTime>
        </Created>
        <FollowUpDates>
            <Date>2014-05-15</Date>
            <Date>2014-05-29</Date>
            <Date>2014-06-12</Date>
        </FollowUpDates>
        <BeginEndDate>
            <TreatmentStartDate>2014-11-18</TreatmentStartDate>
            <TreatmentEndDate>2014-11-30</TreatmentEndDate>
        </BeginEndDate>
        <Indication>
            <Code source="Medicinpriser" date="2014-11-18">121</Code>
            <Text>mod mellemørebetændelse</Text>
        </Indication>
        <RouteOfAdministration>
            <Code source="Medicinpriser" date="2014-11-18">OR</Code>
            <Text>oral anvendelse</Text>
        </RouteOfAdministration>
        <Drug>
            <ATC>
                <Code source="Medicinpriser" date="2014-11-18">J01CE02</Code>
                <Text>Phenoxymethylpenicillin</Text>
            </ATC>
            <Identifier source="Medicinpriser" date="2014-11-18">28100902676</Identifier>
            <Name>Primcillin</Name>
            <Form>
                <Code source="Medicinpriser" date="2014-11-18">TABFILM</Code>
                <Text>filmovertrukne tabletter</Text>
            </Form>
            <Strength>
                <Value>250.0</Value>
                <UnitCode source="Medicinpriser" date="2014-11-18">MG</UnitCode>
                <UnitText>mg</UnitText>
                <Text source="Medicinpriser" date="2014-11-18">250 mg</Text>
            </Strength>
            <Substances>
                <ActiveSubstance>
                    <SubstanceText source="Medicinpriser" date="2014-11-18">Phenoxymethylpenicillinkalium</SubstanceText>
                </ActiveSubstance>
            </Substances>
        </Drug>
        <Dosage>
            <!-- Bemærk fra og med Extension E2 vil UnitText(s) elementer ikke have en source attribut -->
            <UnitTexts source="Local">
                <Singular>tablet</Singular>
                <Plural>tabletter</Plural>
            </UnitTexts>
            <StructuresFixed>
                <Structure>
                    <IterationInterval>1</IterationInterval>
                    <StartDate>2014-11-18</StartDate>
                    <EndDate>2014-11-30</EndDate>
                    <Day>
                        <Number>1</Number>
                        <Dose>
                            <Time>morning</Time>
                            <Quantity>2</Quantity>
                        </Dose>
                        <Dose>
                            <Time>evening</Time>
                            <Quantity>2</Quantity>
                        </Dose>
                    </Day>
                    <DosageTranslation>
                        <ShortText>1 tablet morgen og aften</ShortText>
                        <LongText>Doseringsforløbet starter mandag den 18. november 2013 og gentages hver dag:
                            Doseringsforløb:
                            1 tablet morgen og aften</LongText>
                        <AverageDailyDosage>2</AverageDailyDosage>
                    </DosageTranslation>
                </Structure>
            </StructuresFixed>
            <Type>fast</Type>
        </Dosage>
        <Prescription>
            <Identifier>21298478</Identifier>
            <AttachedToDrugMedicationIdentifier>13143641280998</AttachedToDrugMedicationIdentifier>
            <CreatedFromDrugMedicationVersion>1341404071666006001</CreatedFromDrugMedicationVersion>
            <OrderedEffectuationIdentifier>21297322</OrderedEffectuationIdentifier>
            <AuthorisationDateTime>2012-03-29T09:30:47.0Z</AuthorisationDateTime>
            <Created>
                <By>
                    <AuthorisedHealthcareProfessional>
                        <AuthorisationIdentifier>2Q5TK</AuthorisationIdentifier>
                        <Name>Tess Christoffersen</Name>
                        <SpecialityCode source="Medicinpriser" date="2013-11-18">PSYK</SpecialityCode>
                    </AuthorisedHealthcareProfessional>
                    <Organisation>
                        <Name>Lægerne Vestergade</Name>
                        <AddressLine>Vestergade 2</AddressLine>
                        <AddressLine>8660 Skanderborg</AddressLine>
                        <TelephoneNumber>86521348</TelephoneNumber>
                        <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress>
                        <Type>Yder</Type>
                        <Identifier source="Yder">66974</Identifier>
                    </Organisation>
                </By>
                <DateTime>2013-11-19T09:30:47.0Z</DateTime>
            </Created>
            <LatestEffectuationDateTime>2013-11-20T15:59:12.0Z</LatestEffectuationDateTime>
            <TerminatedDateTime>2013-11-20T15:59:12.0Z</TerminatedDateTime>
            <ReimbursementClause>klausulbetingelse opfyldt</ReimbursementClause>
            <ValidFromDate>2013-11-19Z</ValidFromDate>
            <ValidToDate>2015-11-19Z</ValidToDate>
            <PackageRestriction>
                <PackageNumber source="Medicinpriser" date="2012-02-06">84194</PackageNumber>
                <PackageQuantity>1</PackageQuantity>
            </PackageRestriction>
            <Indication>
                <Code source="Medicinpriser" date="2011-04-09">122</Code>
                <Text>mod halsbetændelse</Text>
            </Indication>
            <Drug>
                <ATC>
                    <Code source="Medicinpriser" date="2012-08-06">J01CE02</Code>
                    <Text>Phenoxymethylpenicillin</Text>
                </ATC>
                <Identifier source="Medicinpriser" date="2012-08-06">28100902676</Identifier>
                <Name>Primcillin</Name>
                <Form>
                    <Code source="Medicinpriser" date="2012-08-06">TABFILM</Code>
                    <Text>filmovertrukne tabletter</Text>
                </Form>
                <Strength>
                    <Value>250.0</Value>
                    <UnitCode source="Medicinpriser" date="2012-08-06">MG</UnitCode>
                    <UnitText>mg</UnitText>
                    <Text source="Medicinpriser" date="2012-08-06">250 mg</Text>
                </Strength>
                <Substances>
                    <ActiveSubstance>
                        <SubstanceText source="Medicinpriser" date="2012-08-06">Phenoxymethylpenicillinkalium
                        </SubstanceText>
                    </ActiveSubstance>
                </Substances>
            </Drug>
            <DosageText>1 tablet morgen og aften ved måltid</DosageText>
            <SubstitutionAllowed>true</SubstitutionAllowed>
            <Status>åben</Status>
        </Prescription>
    </DrugMedication>
</GetDrugMedicationResponse>

</code>

=== Privatmarkering ===

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

<code xml GetDrugMedicationResponse-PrivateDrugMedication.xml>
<GetDrugMedicationResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <PrivateDrugMedication>
        <Identifier>13143641280998</Identifier>
        <Version>1341404071666006001</Version>
    </PrivateDrugMedication>
</GetDrugMedicationResponse> 

</code>

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

<code xml GetDrugMedicationResponse-Invalid.xml>
<GetDrugMedicationResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <InvalidDrugMedication>
        <Identifier>13143641280998</Identifier>
    </InvalidDrugMedication>
</GetDrugMedicationResponse>

</code>