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

Servicen "Hent lægemiddelordination" henter en eller flere lægemiddelordinationer. Afhængigt af de medsendte parametre kan responset indeholde receptordinationer 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 lægemiddelordinationer. For at sikre at alle lægemiddelordinationer hører til samme medicinkort medsendes patientens CPR-nummer. 

<code xml>

<GetDrugMedicationRequest>
	<PersonIdentifier>1111111118</PersonIdentifier>
	<Identifier>1221231331123</Identifier>
	<NegativeConsent>
		<ConsentGiven>
			<FromDate>2012-10-05</FromDate>
			<ToDate>2012-10-05</ToDate>
		</ConsentGiven>
	</NegativeConsent>
	<IncludePrescriptionMedications>false</IncludePrescriptionMedications>
	<IncludeEffectuations>false</IncludeEffectuations>
</GetDrugMedicationRequest>

</code>

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

=== Privatmarkering ===

Med det optionelle element NegativeConsent  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 XML-elementer: 

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

  * ConsentGiven 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. 

Det er muligt at angive samtykke ved anvendelse af [[fmk:1.4.6:soap_header_--_specifikt_omkring_samtykke|ConsentHeader]]. I dette tilfælde tilføjes en SOAP header til requesten med følgende indhold i ConsentType elementet:

  * <ConsentType>PrivateDataConsentOverridden</ConsentType>
  * <ConsentType>PrivateDataConsentGiven</ConsentType>

Benyttes ConsentHeader er det ikke muligt samtidigt at anvende NegativeConsent elementet (kaldet vil fejle).

Bemærk: For snitfladeversioner 1.4.6 og senere er det udelukkende muligt at gøre brug af ConsentHeader i forbindelse med angivelse af samtykke, idet NegativeConsent elementet er fjernet i skemaerne fra og med denne version.

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

  * IncludePrescriptionMedications: Såfremt elementet sættes til true vil svaret indeholde eventuelle receptordinationer 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>
	<PersonIdentifier>1111111118</PersonIdentifier>
	<IdentifierAndVersion>
		<Identifier>1221231331123</Identifier>
		<Version>1341404077658001001</Version>
	</IdentifierAndVersion>
	<IncludePrescriptionMedications>false</IncludePrescriptionMedications>
	<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>
    <PersonIdentifier>1111111118</PersonIdentifier>
    <IdentifierAndDateTime>
        <Identifier>1221231331123</Identifier>
        <DateTime>2012-07-04T08:34:44Z</DateTime>
    </IdentifierAndDateTime>
    <IncludePrescriptionMedications>false</IncludePrescriptionMedications>
    <IncludeEffectuations>false</IncludeEffectuations>
</GetDrugMedicationRequest>

</code>

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

==== Svar ====

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

Herunder vises et svar med en lægemiddelordination. 

<code xml GetDrugMedicationResponse.xml>

<GetDrugMedicationResponse>
    <PersonIdentifier>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="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>
        <ReportedBy>
            <Other>
                <Name>
                    <GivenName>Anne</GivenName>
                    <Surname>Andersen</Surname>
                </Name>
            </Other>
            <Role>Assistent for Læge</Role>
            <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>
        </ReportedBy>
        <Paused>
            <FromDate>2013-11-18</FromDate>
            <ToDate>2013-11-19</ToDate>
            <By>
                <AuthorisedHealthcareProfessional>
                    <AuthorisationIdentifier>VQDZR</AuthorisationIdentifier>
                    <Name>Godfred Damgård</Name>
                </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-18T15:51:12.0Z</DateTime>
        </Paused>
        <HasNegativeConsent/>
	<FollowUpDates>
		<Date>2014-05-15</Date>
		<Date>2014-05-29</Date>
		<Date>2014-06-12</Date>
	</FollowUpDates>
        <BeginEndDate>
            <TreatmentStartDate>2013-11-18</TreatmentStartDate>
            <TreatmentEndDate>2013-11-30</TreatmentEndDate>
        </BeginEndDate>
        <Indication>
            <Code source="Medicinpriser" date="2013-11-18">121</Code>
        </Indication>
        <RouteOfAdministration>
            <Code source="Medicinpriser" date="2013-11-18">OR</Code>
        </RouteOfAdministration>
        <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>
        <Dosage>
            <Structures>
                <UnitText source="Local">tablet</UnitText>
                <Structure>
                    <IterationInterval>1</IterationInterval>
                    <StartDate>2013-11-18</StartDate>
                    <EndDate>2013-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>
            </Structures>
            <Type>temporær</Type>
        </Dosage>
        <SubstitutionAllowed>true</SubstitutionAllowed>
        <ReimbursementClause>klausulbetingelse opfyldt</ReimbursementClause>
    </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-NegativeConsent.xml>

<GetDrugMedicationResponse>
    <PersonIdentifier>1111111118</PersonIdentifier>
    <DrugMedicationWithNegativeConsent>
        <Identifier>13143641280998</Identifier>
        <Version>1341404071666006001</Version>
    </DrugMedicationWithNegativeConsent>
</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>1111111118</PersonIdentifier>
    <InvalidDrugMedication>
        <Identifier>13143641280998</Identifier>
    </InvalidDrugMedication>
</GetDrugMedicationResponse>

</code>