Lægemiddelordination

Herunder beskrives XML-skemaet for lægemiddelordinationen, som det anvendes når en lægemiddelordination (LMO) returneres ved opslag på FMK. Skemaet, der anvendes ved oprettelse eller opdatering, adskiller sig en smule og er beskrevet under Lægemiddelordination ved oprettelse og opdatering.

Lægemiddelordinationen indeholder først en identifikation af lægemiddelordinationen, lægemiddelordination-ID (Identifier) og versionsnummer (Version). Bemærk, at versionsnumrene ikke kan antages at være fortløbende.

Lægemiddelordinationen indeholder relation til den forrige version af medicinkortet (PreviousVersion, første version har dog ikke en tidligere version), og tidligere versioner indeholder også en relation til den efterfølgende version (NextVersion). Idet der kan forekomme samtidige opdateringer, kan der i sjældne tilfælde forekomme flere samtidige versioner for både forrige og næste version.

Se i øvrigt Versionsnummerering for en generel beskrivelse af versionering i FMK.

En lægemiddelordination kan indgå i en eller flere relationer med andre lægemiddelordinationer. Relationen kan p.t. kun være af typen substitutionsrelation. Der henvises til særskilt beskrivelse af lægemiddelordinations-relationer: Relationer mellem lægemiddelordinationer.

Created-elementet indeholder information omkring aktøren, der har oprettet lægemiddelordinationen. Dette element er obligatorisk. Bemærk, at lægemiddelordinationen kan være oprettet af en person, der ikke er autoriseret sundhedsperson, såfremt personens rolle giver rettighed hertil, og denne arbejder på vegne af en autoriseret sundhedsperson. Dvs. at elementet under Created/By ikke nødvendigvis indeholder en HealthcareProfessional. Se Modifikator.

Created/DateTime-elementet indeholder tidspunktet for lægemiddelordinationens oprettelse, som det er registreret af FMK.

“Oprettet af” registreres ved oprettelse af lægemiddelordinationen, og information omkring “oprettet af” person, organisation og tidspunkt returneres på samtlige efterfølgende versioner af lægemiddelordinationen.

Elementet ReportedBy indeholder information omkring personen, der har indrapporteret versionen af lægemiddelordinationen til FMK, dvs. certifikatejer.

Elementet vil ikke altid forekomme, se Modifikator. ReportedBy vil, såfremt det findes, kun være knyttet til versionen af lægemiddelordinationen.

Elementet Modified indeholder information omkring personen, der har oprettet versionen af lægemiddelordinationen, samt tidspunkt.

Er lægemiddelordinationen ændret siden oprettelsen, vil der i Modified-elementet blive returneret information omkring personen, der har foretaget ændringen, se Modifikator.

Modified/DateTime indeholder tidspunktet for seneste ændring, som det er registreret af FMK.

Der returneres “ændret af” for seneste ændring. Er der sket ændringer mellem oprettelsen og seneste ændring, vil disse ikke blive returneret, men skal søges i de tidligere versioner. Modified vil kun være knyttet til versionen af lægemiddelordinationen.

I tidligere snitflader blev det angivet i ModifiedNonclinical, om seneste ændring var lavet af en ikke-kliniker, dvs. en borger, eller en borgers værge eller forælder, f.eks. hvis der blev lavet ændringer i privatmarkeringen.

Fra 1.6.0 findes dette element ikke længere. Til gengæld er NegativeConsent-elementet udvidet med information om hvem, der har privatmarkeret lægemiddelordinationen.

Et Type-element angiver, om lægemiddelordinationen er lægeordineret eller borgervalgt.

Der indføres mulighed for at påføre kontroldatoer på lægemiddelordinationer, som vedrører AK-behandling med Vitamin K-antagonister, de såkaldte VKA lægemidler. P.t. er det kun tilladt på lægemidler med følgende ATC-koder: B01AA03, B01AA04.

Kontroldatoer følger de generelle principper for opdateringer på lægemiddelordinationen. Dvs. at opdateres en lægemiddelordination med en eller flere kontroldatoer, er det lægen, der opdaterer, der har ansvar for at vurdere, om kontroldatoerne skal med på den nye version. Det kan ikke forventes, at f.eks. en vagtlæge, der substituerer lægemidlet for at lave en ny receptordination, kan foretage en opfølgning. Derfor skal det være muligt at opdatere med kontroldatoer, der er overskredne.

Bemærk: Det er kun tilladt, at have op til 2 kontroldatoer på lægemiddelordinationen. Den første af disse skal altid ligge i fortiden, og opdateres/sættes. Den anden kontroldato skal ligge i fremtiden.

Hvis UpdateDrugMedicationRequest xml'en indeholder et tomt <FollowUpDates>-element, slettes eksisterende kontroldatoer på lægemiddelordinationen. Hvis man ikke ønsker at opdatere kontroldatoerne, kan man enten returnere de oprindelige kontroldatoer eller helt udelade <FollowUpDates>-elementet. Bemærk derfor, at der er forskellig betydning af, om <FollowUpDates> elementet er udeladt eller tomt.

“Bulk”-servicen til opdatering af medicinkortet kan i <CreateDrugMedication>- og <UpdateDrugMedication>-elementerne have tilsvarende <FollowUpdates>-elementer angivet. Der gælder samme regler om undladelse/tomt element.

Såfremt lægemiddelordinationen er pauseret, vil Paused-elementet angive dette. Heri kan ses, hvilken person, der har foretaget pauseringen, og hvornår det er sket.

Paused/DateTime indeholder tidspunktet for pauseringen, som det er registreret af FMK.

Det er muligt at opdatere på en pauseret lægemiddelordination. Paused-elementet vil blive returneret så længe lægemiddelordinationen er pauseret, dvs. muligvis på flere efterfølgende versioner, indtil pauseringen er ophævet.

Se i øvrigt Lægemiddelordinationens gyldighedsinterval.

Ved læsning af lægemiddelordinationer kan der også returneres lægemiddelordinationer, der er seponerede. Der anvendes samme skema, så disse er også defineret i medicinkortet, men seponerede lægemiddelordinationer vil ikke blive returneret ved oplag på det aktuelle medicinkort. Det samme gælder lægemiddelordinationer, der er udløbne.

Withdrawn-elementet er ikke vist i eksemplet herunder.

Ved opslag på den aktuelle version, returneres kun aktuelle lægemiddelordinationer. Ved opslag på tidligere versioner, returneres lægemiddelordinationerne kun, hvis de på dette tidspunkt er aktuelle, og i den form de da havde. Se i øvrigt Hent lægemiddelordinationer og Søg efter afsluttede lægemiddelordinationer. Se evt. Lægemiddelordinationens gyldighedsinterval.

Såfremt lægemiddelordinationen er privatmarkeret, og aktøren har fået adgang til at se denne via samtykke eller værdispring, vil lægemiddelordinationen indeholde et NegativeConsent-element.

Såfremt aktøren ikke har fået adgang til at se lægemiddelordinationen, returneres blot en markering i response-headeren, at der findes skjult data, ikke yderligere information. Tidligere snitfladeversioner returnerede ID og versionsnumre på de privatmarkerede lægemiddelordinationer.

Lægemiddelordinationens gyldighedsinterval findes i ActivePeriod-elementet. Der angives lægemiddelordinationens startdato og behandlingsslutdato. Alternativt kan det angives, at slutdato er ukendt, og at startdato er tidligere end oprettelsestidspunktet, uden at specificere det yderligere.

Hvis lægemiddelordinationen er seponeret, eller hvis behandlingsslutdatoen er overskredet, vil der også være et Ended-element. Dette fortæller om lægemiddelordinationen er seponeret (aktiv handling ved kald til Seponer lægemiddelordination), eller om behandlingsslutdato er overskredet, og lægemiddelordinationen derfor ikke længere er aktiv. Bemærk, dette element indeholder ikke information om pausering af lægemiddelordinationen.

Se en beskrivelse heraf i afsnittet Lægemiddelordinationens gyldighedsinterval.

Ud fra ActivePeriod og en eventuel forekomst af Paused kan lægemiddelordinationens aktuelle status udledes. Idet status kan være aktiv, f.eks. ved afsendelse fra FMK, men få øjeblikke senere ved modtagelsen f.eks. i et EPJ-system være seponeret, idet datoen er ændret, indeholder Lægemiddelordination-elementet ingen direkte angivelse af status.

Lægemiddelordinationens indikation beskrives i Indication-elementet, se en beskrivelse under Klassifikationer, standarder og kildeangivelse.

Administrationsvejen er i de fleste tilfælde givet ud fra lægemidlet og beskrives i RouteOfAdministration-elementet. Se afsnittet Klassifikationer, standarder og kildeangivelse.

Lægemiddelordinationen indeholder et lægemiddel. Lægemidlet kan være angivet på flere former, se afsnittet Lægemiddel-struktur.

For lægemidler, der kan slås op i stamdata, vil der blive returneret så meget data som haves, dvs. ATC, drugid, navn, form, styrke og aktive substanser. For lægemidler, der ikke findes i stamdata, returneres den information, der blev sendt med på oprettelses-/opdateringstidspunktet.

Der angives en dosering på lægemiddelordinationen. I eksemplet er angivet en struktureret dosering, hvor lægemidlet skal tages dagligt som “1 tablet morgen og aften ved måltid”. Elementet gennemgås separat under Dosering. Ved opslag returneres desuden en doseringsoversættelse i elementet DosageTranslation. Se evt. Doseringsoversættelse og -forslag.

I forbindelse med PN-kur behandlinger ønskes det i visse tilfælde, at der registreres, hvornår en PN-kur behandling er påbegyndt eller påbegyndes. Selve registreringen af påbegyndelse af en PN-kur behandling sker med Aktiver PN-kur-servicen.

Hvis en PN-kur er aktiveret, og kurens beregnede slutdato ikke er nået endnu, vil enten ActiveSince- eller ActiveFrom-elementerne fremgå. ActiveSince indeholder seneste aktiveringsdato, hvis den beregnede slutdato ikke er overskredet. ActiveFrom indeholder seneste aktiveringsdato, hvis denne dato endnu ikke er overskredet, altså hvis PN-kuren forventes startet på en kendt og registreret dato i fremtiden.

PlannedAdministration-elementet indeholder en eller flere planlagte administrationsforløb knyttet til den aktuelle version af lægemiddelordinationen. Strukturen følger de almindelige doseringsstrukturer med perioder, dage og doser.

Såfremt der ikke eksisterer en planlagt administration tilknyttet den nuværende version af lægemiddelordinationen, kan der forekomme et PlannedAdministrationExistForPreviousVersion-element. Dette element signalerer, at der eksisterer planlagte administrationer, som er tilknyttet en tidligere version af lægemiddelordinationen. Disse kan så hentes igennem andre services eller ved hentning af historiske versioner af lægemiddelordinationen og/eller medicinkortet.

Bemærk: PlannedAdministrationExistForPreviousVersion forekommer ikke, såfremt der findes mindst en PlannedAdministration. Det vil ofte ske, at når lægen opdaterer en LMO, så forsvinder samtlige PlannedAdministration, fordi dem, som varetager den planlagte administration, først skal opdatere, før den planlagte administration igen er knyttet sammen med den nye version af lægemiddelordinationen.

På lægemiddelordinationen kan angives, om lægemidlet må substitueres. Dette er specielt relevant, når der skal oprettes udleveringsgrundlag ud fra lægemiddelordinationen.

Feltet beskriver, hvordan udleveringer bør (lægens hensigt) foregå. Feltet må ikke bruges til at begrænse udleveringer. Dette felt skal tolkes som en forventning og ikke en regel.

Alle udleveringsgrundlag tilknyttet lægemiddelordinationen returneres i Warrant-elementer, et for hvert udleveringsgrundlag. Se Udleveringsgrundlag for yderligere detaljer.

Ugyldige udleveringsgrundlag inkluderes i responset mhp. at klienten kan slette evt. lokal kopi. De vil blive inkluderet som flere “WarrantIdentifier”-værdier, hvert indeholdt i et InvalidWarrant-element.

I FMK 1.6.0 er det muligt at registrere administration af lægemiddelordinationer. Dette erstatter de tidligere effektueringer af typen “indgivet” fra FMK 1.4.x.

En administration knyttes direkte til en lægemiddelordination og kan optionelt også være tilknyttet en specifik udlevering.

DrugAdministration-elementet indeholder:

• Identifier: ID på den enkelte administration.
• DrugMedicationIdentifier: ID på lægemiddelordinationen.
• Optionelt HandoverIdentifier: ID på den udlevering, som administrationen er foregået ud fra.
• Created: Modifikator for personen, som oprettede administrationen.
• Optionelt ReportedBy, modifikator for personen, som indrapporterede administrationen på FMK.
• Optionelt: Modified: Modifikator for personen, som senest ændrede i den registrerede administration.
• AdministrationDateTime: Tidspunkt og dato for administrationen.
• DoseQuantity: Doseringsmængden, som blevet administreret.
• DosageQuantityUnitText: Doseringsmængdens enhed (f.eks. 'stk.').

Er patienten og lægemiddelordinationen berettiget til tilskud, angives dette på lægemiddelordinationen. Tilskudsklausulkoden skal angives i ReimbursementApprovedCode.

Markere at den enkelte ordinationer har en relation af specifik type til en anden lægemiddelordinationer.

Beskrivelse af dette findes her: XML forklaring og Relationer generelt

Det er muligt på lægemiddelordinationen at angive, at administration af medicin ønskes registreret på FMK. Dette vil typisk være interessant ved medicin, der gives med større intervaller, f.eks. depottabletter. For disse kan det være vigtigt at vide, om medicinen er givet f.eks. i forbindelse med sektorovergange.

Angivelse af, at medicinen ikke må udleveres direkte til patienten, men i stedet håndteres via sekundære udleveringer; f.eks. misbrugsmedicin, hvor pakningen ikke udleveres til patienten, men i stedet opbevares af apoteket, bosted eller misbrugscenter, der så udleverer den doserede mængde til patienten på doseringstidspunktet.

På lægemiddelordinationen kan det også angives, at lægemidlet på ordinationen ikke må dosisdispenseres. Dette er en information til apoteket om, at de ikke må konvertere receptudleveringsgrundlag til dosisdispenseringsgrundlag og dosisdispensere medicinen.

Nedenstående eksempel viser en gyldig, men forsimplet lægemiddelordination.

DrugMedication.xml

<DrugMedication xmlns="http://fmk-teknik.dk/160">
    <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:47Z</DateTime>
    </Created>
    <Type>Lægeordineret</Type>
    <FollowUpDates>
        <Date>2013-11-26</Date>
    </FollowUpDates>
    <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:12Z</DateTime>
    </Paused>
    <ActivePeriod>
        <DrugMedicationStartDate>2013-11-18</DrugMedicationStartDate>
        <TreatmentEndDate>2013-11-30</TreatmentEndDate>
    </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>
            <Value>250.0</Value>
            <UnitCode date="2012-08-06" source="Medicinpriser">MG</UnitCode>
            <UnitText>mg</UnitText>
            <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>
    <RequireSecondaryHandover/>
</DrugMedication>