Table of Contents

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: Lægemiddelordinationer.

De mest komplekse dele er angivelsen af lægemiddel-struktur og dosering.

Forespørgsel

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

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

Detaljer om hvad der returneres i historiske kald, findes på siden Historik

Svar

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. CPR skift)

Herunder vises et svar med en lægemiddelordination. Elementerne er beskrevet i Lægemiddelordination

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>

Privatmarkering

:!: Flyttes til ResponseHeader

Såfremt lægemiddelordinationen er privatmarkeret, og der ikke er angivet …Privatmarkering, returneres kun id og versionsid i PrivateDrugMedication:

GetDrugMedicationsResponse-NegativeConsent.xml
<GetDrugMedicationsResponse>
    <PersonIdentifier>1111111118</PersonIdentifier>
    <PrivateDrugMedication>
        <Identifier>13143641280998</Identifier>
        <Version>1341404071666006001</Version>
    </PrivateDrugMedication>
</GetDrugMedicationsResponse>

Administrativt slettet lægemiddelordination

Endelig kan lægemiddelordinationen være administrativt slettet, i så fald returneres kun id i InvalidDrugMedication.

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