Hent receptanmodninger for CPR-nummer

Servicen GetPrescriptionRequests træder i stedet for servicen GetOrderedEffectuationsRequest i den tidligere EO-snitflade.

Den simplificeres en del i denne udgave, da den laves til at hente alle data for én patient ad gangen (dog med paginering på dato, hvis der er mange data). Der kan ikke som tidligere hentes både receptanmodninger og/eller apoteksbestillinger, filtreres på forskellige tilstande. eller ekskluderes specifikke anmodnings-ID'er.

Her er et simpelt eksempel på et request:

GetPrescriptionRequestsRequest.xml

<GetPrescriptionRequestsRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
</GetPrescriptionRequestsRequest>

Eller hvis man enten kun vil se hvad der er nyt i denne uge, eller skal hente igen pga. paginering, så kan et request se således ud:

GetPrescriptionRequestsRequest-paginering.xml

<GetPrescriptionRequestsRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <FromDateTime>2013-06-27</FromDateTime>
</GetPrescriptionRequestsRequest>

Man kan også angive både FromDateTime og ToDateTime

Nedenfor ses et eksempel på et svar:

GetPrescriptionRequestsResponse.xml

<GetPrescriptionRequestsResponse>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <PrescriptionRequest>
        <Identifier>1341404071665003002</Identifier>
        <DrugMedicationIdentifier>1341404681125001011</DrugMedicationIdentifier>
        <Created>
            <By>
                <Other>
                    <Name>
                        <GivenName>Hanne</GivenName>
                        <Surname>Hansen</Surname>
                    </Name>
                </Other>
                <Role>Assistent for Sygeplejerske</Role>
                <Organisation>
                    <Name>Hjemmesygeplejen i Skanderborg</Name>
                    <AddressLine>Adelgade 64</AddressLine>
                    <AddressLine>8660 Skanderborg</AddressLine>
                    <TelephoneNumber>87947000</TelephoneNumber>
                    <EmailAddress>hjs@skanderborg.dk</EmailAddress>
                    <Type>Kommune</Type>
                    <Identifier source="Kommunekode">746</Identifier>
                </Organisation>
            </By>
            <DateTime>2013-11-12T08:43:12</DateTime>
        </Created>
        <PrescribingOrganisation>
            <Name>Lægerne Vestergade</Name>
            <Type>Yder</Type>
            <Identifier source="Yder">061069</Identifier>
        </PrescribingOrganisation>
        <PackageRestriction>
            <PackageNumber source="Medicinpriser" date="2016-06-03">84194</PackageNumber>
            <PackageQuantity>1</PackageQuantity>
        </PackageRestriction>
        <Order>
            <OrderedAtPharmacy>
                <Name>Skanderborg Apotek</Name>
                <Type>Apotek</Type>
                <Identifier source="EAN-Lokationsnummer">5790000170609</Identifier>
            </OrderedAtPharmacy>
            <DeliveryInstructionText>Sendes sammen med øvrige ordrer til plejehjemmet</DeliveryInstructionText>
            <Delivery>
                <Priority>send til anden adresse samme dag</Priority>
                <StreetName>Søkildevej 2</StreetName>
                <PostCode>8680</PostCode>
                <ContactName>Hanne Hansen</ContactName>
            </Delivery>
        </Order>
        <Status>Prescribed</Status>
        <PrescriptionIdentifier>1341404071775105002</PrescriptionIdentifier>
    </PrescriptionRequest>
    <!-- Yderligere request elementer kan evt. inkluderes
    <PrescriptionRequest>
        ....
    </PrescriptionRequest>
    -->
    <PageNumber>1</PageNumber>
    <MoreAvailable/>
</GetPrescriptionRequestsResponse>

Svaret er lidt simplere end i den tidligere EO-service, fordi:

• Det kun kan indeholde data fra én patient
• Det kun kan indeholde receptanmodninger (ikke apoteksbestillinger)
• Det ikke beskæftiger sig med om medicinen er udleveret, men kun om recepten er lavet (ingen
• EffectuatingOrganisation)
• Hver enkelt receptanmodning har en eksplicit status, som enten er Unhandled, Prescribed eller Cancelled.
• Hvis der både er udstedt en recept på denne anmodning og anmodningen er annulleret, anses status for at være Prescribed (denne situation vil blive forhindret fremadrettet, men kan forekomme i eksisterende data), og så returneres både en CancelledBy modificator og en PrescriptionIdentifier, så det kan ses på entiteten hvad der er foregået.
• I stedet for OrderedBy og OrderedDateTime elementer anvendes nu en Created struktur, ligesom i mange andre 1.4.6 services.
• Information vedr. evt. bestilling til apotek er under et Order element som har samme struktur som i både RequestPrescription og CreatePrescription.

I 1.4.4 E2 og 1.4.6 E2 (og fremtidige) kan man angive en afvisningsårsag når en receptanmodning annulleres. Denne kan derfor optræde i et CancellationReason element til sidst i PrescriptionRequest strukturen.

Hvis der er mere end 25 receptanmodninger til patienten angives til sidst et MoreAvailable-element for at understøtte paginering. Eksempel:

<GetPrescriptionRequestsResponse>
    <PrescriptionRequest>
        ....
    </PrescriptionRequest>
    <PrescriptionRequest>
        ....
    </PrescriptionRequest>
    <PrescriptionRequest>
        ....
    </PrescriptionRequest>
    <!-- Yderligere 22 elementer her... -->
    <MoreAvailable />
</GetPrescriptionRequestsResponse>

MoreAvailable elementet kan bruges til at lave en udtømmende søgning af receptanmodninger ved at sende GetPrescriptionRequestsRequest anmodninger med fortløbende PageNumber værdier, indtil der ikke længere returneres et MoreAvailable element.