Oprettelse af en planlagt administration for en given lægemiddelordination. En planlagt administration beskriver hvordan medicinen forventes administreret af en given organisation, men organisationen behøver ikke nødvendigvis stå for den generelle dispensering af lægemidlet.

En planlagt administration vil altid være knyttet til en given lægemiddelordination, og kan samtidig være tilknyttet til et dispenseringskort såfremt en given organisation faktisk forventer at stå for en fysisk dispensering af ordinationen.

I request-dokumentet skal der medsendes en PersonIdentifier på den patient som forespørgslen omhandler. Såfremt det pågældnede planlagte administration skal anvendes på et dosisdispenseringskort til organiastioner, skal dette angives i OrganiastionIdentifier på den pågældende organisation.

I elementet CreatedBy medsendes information omkring organisationen (udleverings eller pakkeapoteket) og brugeren som har foretaget oprettelsen, Modifikator. Er elementet oprettet af en anden aktør end personen der foretager kaldet mod FMK medsendes både et ReportedBy-element, og CreatedBy. Se evt. Aktører på FMK.

I et CreatePlannedAdministration element medsendes detaljer omkring den planlagte administration, i hvert request kan der angives flere CreatePlannedAdministration, såfremt man ønsker at oprette flere på en gang. Elementet indeholder følgende:

• Optionelt: DispensingCardIdentifier, ID på det dispenseringskort som den planlagte administration skal tilknyttes. Angives denne ikke bliver administration kun tilknyttet ordinationen.
• DrugMedication, element som indeholder Identifier og Version på den lægemiddelordination som administrationen skal tilknyttes.
• AdministrationInstruction, værdi som beskriver hvor administrationen indgives.
• Valg mellem kombinationen af et PlannedAdministrationAccordingToDrugMedication element + Optionelt DosageUnit element eller et PlannedAdministration element.

PlannedAdministrationAccordingToDrugMedication elementet angiver at administrationen ønsker oprettet med en administration magen til lægemiddelordinationens dosering. Dette er en mulighed som kan anvendes såfremt lægens dosering på ordinationen er tilstrækkelig struktureret at den kan oversættes direkte til en planlagt administration. I tilfælde hvor dette ikke kan lade sig gøre, vil forespørgslen blive besvaret med en valideringsfejl.

Sammen med PlannedAdministrationAccordingToDrugMedication kan også angives et DosageUnit element, hvor indmelder kan få påsat sin egen doseringsenhed, såfremt den fra lægemiddelordinationen ikke er passende, eller indmelder benytter sig af andre standardenheder. Dette ses ofte ved dosisdispensering, hvor apoteket altid antager deres enheder er i “stk”

PlannedAdministration elementet beskriver en administration som defineres af brugeren, dette vil ofte være en præcisering af lægens dosering, fx i tilfælde hvor lægen ikke angiver et doseringstidspunkt, hvor administrationen så angiver doseringen tages hver morgen.

Elementet indeholder følgende:

• Optionelt: DosageUnit element, beskriver hvilken enhed administrationen foregår i. Såfremt den ikke angives ved oprettelse, vil enheden blive overført fra lægemiddelordinationen.
• ValidFrom element, beskriver når administrationsplanen er gyldig fra.
• Optionelt: PlannedAdministrationFixed element, beskriver administrationen i detaljer for den faste del. Har form som en struktureret dosering.
• Optionelt: PlannedAdministrationPRN element, beskriver administrationen i detaljer for PN-delen. Har form som en struktureret dosering.

Se evt. denne side for yderligere detaljer om administrationsplan.

Det kan bemærkes at alle elementer faktisk er optionelle, og det er derfor helt tilladt at der oprettes en planlagt administration uden faktisk at angive en administration.

CreatePlannedAdministration.xml

<CreatePlannedAdministrationRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <CreatedBy>
        <HealthcareProfessional>
            <Indentifier source="CPR">2012850101</Indentifier>
            <Name>Hanne Jensen</Name>
        </HealthcareProfessional>
        <Role>Apoteksansat</Role>
        <Organisation>
            <Identifier source="EAN-Lokationsnummer">123456789</Identifier>
            <Type>Apotek</Type>
            <Name>Aarhus Kobbergade Apotek</Name>
            <AddressLine>Kobbergade 17, 8000 Aarhus</AddressLine>
            <TelephoneNumber>00000000</TelephoneNumber>
            <EmailAddress>ABC@XYZ.com</EmailAddress>
        </Organisation>
    </CreatedBy>
    <CreatePlannedAdministration>
        <DispensingCardIdentifier>4684681358</DispensingCardIdentifier>
        <DrugMedication>
            <Identifier>468138135138</Identifier>
            <Version>6684311385</Version>
        </DrugMedication>
        <AdministrationInstruction>Tygges</AdministrationInstruction>
        <PlannedAdministration>
            <DosageUnit>
                <SingularDosageUnitText>tablet</SingularDosageUnitText>
                <PluralDosageUnitText>tabletter</PluralDosageUnitText>
            </DosageUnit>
            <ValidFrom>2025-04-24</ValidFrom>
            <PlannedAdministrationFixed>
                <PlannedAdministrationStructure>
                    <IterationInterval>1</IterationInterval>
                    <StartDate>2024-05-01</StartDate>
                    <Day>
                        <Number>1</Number>
                        <Dose>
                            <Time>morning</Time>
                            <SequenceNumber>699999</SequenceNumber>
                            <Quantity>1</Quantity>
                        </Dose>
                        <Dose>
                            <Time>evening</Time>
                            <SequenceNumber>1899999</SequenceNumber>
                            <Quantity>1</Quantity>
                        </Dose>
                    </Day>
                </PlannedAdministrationStructure>
            </PlannedAdministrationFixed>
        </PlannedAdministration>
    </CreatePlannedAdministration>
</CreatePlannedAdministrationRequest>

Svaret fra FMK indeholder det medsendte PersonIdentifier eller OrganisationIdentifier. Desuden returneres et eller flere PlannedAdministration elementer som indeholder Identifier, Version og Warning elementer. Såfremt man har valgte at oprette mere end en planlagt administration i samme request, svarer PlannedAdministration-elementerne i svaret til den rækkefølge som de planlagte administration blev angivet i forespørgslen.

CreatePlannedAdministrationResponse.xml

<CreatePlannedAdministrationResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <PlannedAdministration>
        <Identifier>7813338143413</Identifier>
        <Version>135513481358</Version>
        <Warning>
            <WarningCode>2511</WarningCode>
            <WarningText>Lægemidlet er pauseret</WarningText>
            <Severity>low</Severity>
        </Warning>
    </PlannedAdministration>
</CreatePlannedAdministrationResponse>