====== Hent planlagt administration ======
Service til hentning af [[fmk:1.6.0:xml-elementer:planlagtadministration|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.

====== Forespørgsel ======

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetPlannedAdministrationRequestType|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.

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


<file xml GetPlannedAdministrationRequest2.xml>
<GetPlannedAdministrationRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <DrugMedicationIdentifier>18864331484</DrugMedicationIdentifier>
</GetPlannedAdministrationRequest>
</file>

====== Svar ======

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetPlannedAdministrationResponseType|Response]]

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'', [[fmk:1.6.0:xml-elementer:modifikator| modifikatoren]]: For personen, som oprindeligt oprettede den planlagte administration.
  * Optionelt: ''Modified'', [[fmk:1.6.0:xml-elementer:modifikator| modifikatoren]]: For personen, som senest 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: 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'', [[fmk:1.6.0:xml-elementer:planlagtadministration#administrationsplanen|administrationsplanen]]: For den faste del.
  * Optionelt: ''PlannedAdministrationPRN'', [[fmk:1.6.0:xml-elementer:planlagtadministration#administrationsplanen|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.

<file xml 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>
</file>