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 som skal have tilføjet et dosisdispenseringskort. Såfremt det pågældnede dispenseringskort skal anvendes som dosisdispenseringskort til organiastioner, skal dette angives i OrganiastionIdentifier på den pågældende organisation.

Når der hentes vælger der mellem en række DrugMedicationIdentifier eller en række PlannedAdministrationIdentifier, alt efter hvor meget kontrol man ønsker omkring hvad FMK skal finde af resultater. Anvendes DrugMedicationIdentifier vil FMK finde samtlige planlagte administrationer tilknyttet den pågældne lægemiddelordination, dette inkludere 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 en DrugMedicationIdentifier eller PlannedAdministrationIdentifier, men ikke er 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 [fmk:1.6.0:xml-elementer:modifikator| modifikatoren] for personen som originalt oprettede den planlagte administration
• Optionelt: Modified [fmk:1.6.0:xml-elementer:modifikator| modifikatoren] for personen som seneste har opdateret den planlagte administration
• Optionelt: ReportedBy [fmk:1.6.0:xml-elementer:modifikator| 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: AdministrationInstruction Indtagelsesvejledning for den planlagte administration.
• Optionelt: DosageUnit doseringsenheden for den planlagte administration.
• Optionelt: PlannedAdministrationFixed den planlagte administration for den faste del.
• Optionelt: PlannedAdministrationAccordingToNeed den planlagte administration for PN-delen.

Såfremt man har valgte at hente 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. 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 opdateredere 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>
                    <Name>Aarhus Kobbergade Apotek</Name>
                    <AddressLine>Kobbergade 17, 8000 Aarhus</AddressLine>
                    <TelephoneNumber>00000000</TelephoneNumber>
                    <EmailAddress>ABC@XYZ.com</EmailAddress>
                    <Type>Apotek</Type>
                    <Identifier source="EAN-Lokationsnummer">123456789</Identifier>
                </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>
        <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>
</GetPlannedAdministrationResponse>