Service til hentning af planlagt administration. Service kan anvendes enten direkte med identifier på planned administration om ønskes hentes, alternativt kan der hentes med DrugMedicationIdentifier for at få alle planlagte administrationer på en given lægemiddelordination.

I request-dokumentet skal der medsendes en PersonIdentifier på den patient, hvis planalgte administration ønskes fremsøgt. Alternativt, hvis der er tale om dispenseringskort til organisationer, skal dette angives i OrganisationIdentifier på den pågældende organisation.

Dernæst angives enten en række DrugMedicationIdentifier-elementer eller en række PlannedAdministrationIdentifier-elementer. Anvendes DrugMedicationIdentifier vil FMK finde samtlige planlagte administrationer tilknyttet den pågældne lægemiddelordination, dette inkluderer også planlagte administrationer som ikke er up-to-date med seneste version af lægemiddelordinationen. Når PlannedAdministrationIdentifier anvendes, returneres kun de planlagte administrationer som har de tilsvarende ID'er.

Servicen tillader at man angiver mere end én DrugMedicationIdentifier eller PlannedAdministrationIdentifier, men ikke at man benytter en blanding af de to.

GetPlannedAdministrationRequest.xml

<GetPlannedAdministrationRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <PlannedAdministrationIdentifier>21684351</PlannedAdministrationIdentifier>
    <PlannedAdministrationIdentifier>25438133</PlannedAdministrationIdentifier>
</GetPlannedAdministrationRequest>

GetPlannedAdministrationRequest2.xml

<GetPlannedAdministrationRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <DrugMedicationIdentifier>18864331484</DrugMedicationIdentifier>
</GetPlannedAdministrationRequest>

Svaret fra FMK indeholder det medsendte PersonIdentifier eller OrganisationIdentifier. Desuden returneres et eller flere PlannedAdministration elementer som indeholder følgende elementer:

• Identifier Unikt ID for den pågældende planlagte administration.
• Version Versions-nummer for den pågældende planlagte administration, denne service returnere altid seneste version
• Created, modifikatoren for personen som originalt oprettede den planlagte administration
• Optionelt: Modified, modifikatoren for personen som senest har opdateret den planlagte administration
• Optionelt: ReportedBy, modifikatoren for personen som indberettede seneste opdatering af den planlagte administration,
• DrugMedication-element, som indeholder Identifier og Version på den lægemiddelordination som den planlagte administration er tilknyttet, Version kan være en historisk version, såfremt seneste version af den planlagte administration er ude af sync med lægemiddelordinationen.
• Optionelt: DispensingCardIdentifier på dét dispenseringskort, som den planlagte administration er tilknyttet
• Optionelt: AdministrationInstruction, indtagelsesvejledning for den planlagte administration
• Optionelt: DosageUnit, doseringsenheden for den planlagte administration
• ValidFrom, markeringen af hvornår administrationsplanen er gyldig fra (effektivt en startdato)
• Optionelt: PlannedAdministrationFixed, administrationsplanen for den faste del.
• Optionelt: PlannedAdministrationPRN, administrationsplanen for PN-delen.

Såfremt man har valgt at hente mere end én planlagt administration i samme request, svarer PlannedAdministration elementerne i svaret til den rækkefølge som de planlagte administrationer blev angivet i forespørgslen. Blev DrugMedicationIdentifier anvendt i forespørgslen, bliver PlannedAdministration returneret i rækkefølge først efter den DrugMedicationIdentifier administrationen tilhører, administrationer indenfor samme lægemiddelordination returneres i en rækkefølge med de senest opdaterede først.

GetPlannedAdministrationResponse.xml

<GetPlannedAdministrationResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <PlannedAdministration>
        <Identifier>121818135</Identifier>
        <Version>215618138</Version>
        <Created>
            <By>
                <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>
            </By>
            <DateTime>2025-04-24T17:01:09Z</DateTime>
        </Created>
        <DrugMedication>
            <Identifier>8183183183</Identifier>
            <Version>7484358138</Version>
        </DrugMedication>
        <AdministrationInstruction>Efter måltid</AdministrationInstruction>
        <DosageUnit>
            <DosageUnitText>stk</DosageUnitText>
        </DosageUnit>
        <ValidFrom>2025-04-24</ValidFrom>
        <PlannedAdministrationFixed>
            <PlannedAdministrationStructure>
                <IterationInterval>1</IterationInterval>
                <StartDate>2024-05-01</StartDate>
                <Day>
                    <Number>1</Number>
                    <Dose>
                        <Time>noon</Time>
                        <SequenceNumber>1199999</SequenceNumber>
                        <Quantity>1</Quantity>
                    </Dose>
                    <Dose>
                        <Time>night</Time>
                        <SequenceNumber>299999</SequenceNumber>
                        <Quantity>1</Quantity>
                    </Dose>
                </Day>
            </PlannedAdministrationStructure>
        </PlannedAdministrationFixed>
    </PlannedAdministration>
    <PlannedAdministration>
        ...
    </PlannedAdministration>
</GetPlannedAdministrationResponse>