Service til hentning af planlagt administration. Servicen kan anvendes enten direkte med identifier på PlannedAdministration, som ønskes hentet, eller den kan hentes med DrugMedicationIdentifier, for at få alle planlagte administrationer på en given lægemiddelordination.

Request

I forespørgsel skal der medsendes en PersonIdentifier på den patient, hvis planlagte 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ældende 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 returnerer altid seneste version.
• Created, modifikatoren: For personen, som oprindeligt 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: 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å det 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 (effektiv 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>