Servicen anvendes til at hente historiske versioner af en planlagt administration. Historikken kan være vigtig i situationer, hvor der er spørgsmål til, hvordan administration så ud på et givent tidspunkt, eller hvis der er spørgsmål til hvem der stod bag en historisk opdatering.

I request til servicen skal patientens PersonIdentifier angives, alternativt kan OrganisationIdentifier angives, såfremt man arbejder med dosisdispensering til organisationer.

Herefter angives PlannedAdministrationIdentifier, som udpeger den administration, der ønskes historik over. Hertil kan HistorySince anvendes, såfremt man ikke ønsker den fulde historik.

GetPlannedAdministrationHistoryRequest.xml

<GetPlannedAdministrationHistoryRequest>
    <PersonIdentifier source="CRP">1111111118</PersonIdentifier>
    <PlannedAdministrationIdentifier>213138138</PlannedAdministrationIdentifier>
    <HistorySince>2024-05-01</HistorySince>
</GetPlannedAdministrationHistoryRequest>

Svar fra servicen indeholder en række historiske versioner af den pågældende planlagte administration.

I starten af svaret kommer patientens PersonIdentifier eller organisationens OrganisationIdentifier alt efter hvad der blev angivet i forespørgslen. Herefter kommer en række PlannedAdministration elementer med den historiske version, versionerne er sorteret med den seneste version først.

PlannedAdministation elementerne indeholder følgende:

• Identifier, ID på den pågældende planlagte administration
• Version, Versions-nummeret for den pågældende version af den planlagte administration
• Created, modifikatoren for personen som originalt oprettede den planlagte administration
• Optionelt: Modified, modifikatoren for personen som senest opdaterede den planlagte administration på den denne version
• Optionelt: ReportedBy, modifikatoren for personen som indrapportede opdateringen til denne version
• Optionelt: DrugMedication, Identifier og Version på den lægemiddelordination som er tilknyttet denne version
• 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.

GetPlannedAdministrationHistoryReponse.xml

<GetPlannedAdministrationHistoryResponse>
    <PersonIdentifier source="CRP">1111111118</PersonIdentifier>
    <PlannedAdministration>
        <Identifier>321181313</Identifier>
        <Version>5131358514315351</Version>
        <Created>
            <By>
                <HealthcareProfessional>
                    <Identifier source="CPR">2401010001</Identifier>
                    <Name>Karl Karlsen</Name>
                </HealthcareProfessional>
                <Role>Apoteksansat</Role>
                <Organisation>
                    <Identifier source="EAN-lokationsnummer">5790001381615</Identifier>
                    <Type>Apotek</Type>
                    <Name>Kolind Apotek</Name>
                    <AddressLine>...</AddressLine>
                    <TelephoneNumber>...</TelephoneNumber>
                    <EmailAddress>...</EmailAddress>
                </Organisation>
            </By>
            <DateTime>2019-10-01T00:00:00Z</DateTime>
        </Created>
        <Modified>
            <By>
                <HealthcareProfessional>
                    <Identifier source="CPR">2401010001</Identifier>
                    <Name>Karl Karlsen</Name>
                </HealthcareProfessional>
                <Role>Apoteksansat</Role>
                <Organisation>
                    <Identifier source="EAN-lokationsnummer">5790001381615</Identifier>
                    <Type>Apotek</Type>
                    <Name>Kolind Apotek</Name>
                    <AddressLine>...</AddressLine>
                    <TelephoneNumber>...</TelephoneNumber>
                    <EmailAddress>...</EmailAddress>
                </Organisation>
            </By>
            <DateTime>2025-05-15T12:31:00Z</DateTime>
        </Modified>
        <DrugMedication>
            <Identifier>12313513851</Identifier>
            <Version>32168486135138</Version>
        </DrugMedication>
        <AdministrationInstruction>Tygges</AdministrationInstruction>
        <DosageUnit>
            <DosageUnitText>Stk.</DosageUnitText>
        </DosageUnit>
        <ValidFrom>2025-04-24</ValidFrom>
        <PlannedAdministrationFixed>
            <PlannedAdministrationStructure>
                <IterationInterval>2</IterationInterval>
                <StartDate>2019-10-01</StartDate>
                <Day>
                    <Numer>1</Numer>
                    <Dose>
                        <Time>morning</Time>
                        <SequenceNumber>0799999</SequenceNumber>
                        <Quantity>2</Quantity>
                    </Dose>
                </Day>
                <Day>
                    <Numer>2</Numer>
                    <Dose>
                        <Time>morning</Time>
                        <SequenceNumber>0799999</SequenceNumber>
                        <Quantity>1</Quantity>
                    </Dose>
                </Day>
            </PlannedAdministrationStructure>
        </PlannedAdministrationFixed>
    </PlannedAdministration>
    <PlannedAdministration>...</PlannedAdministration>
    <PlannedAdministration>...</PlannedAdministration>
    <PlannedAdministration>...</PlannedAdministration>
</GetPlannedAdministrationHistoryResponse>