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.

Request

I forespørgsel 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: Versionsnummeret for den pågældende version af den planlagte administration.
• Created, modifikatoren: For personen, som oprindeligt 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 indrapporterede 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>