Fælles Medicinkort - Dokumentation

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== 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.
==== Forespørgsel ====

Her er et simpelt eksempel på et request:

<code xml GetPrescriptionRequestsRequest.xml>
<GetPrescriptionRequestsRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
</GetPrescriptionRequestsRequest>
</code>

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:

<code xml GetPrescriptionRequestsRequest-paginering.xml>
<GetPrescriptionRequestsRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <FromDateTime>2013-06-27</FromDateTime>
</GetPrescriptionRequestsRequest>
</code>

Man kan også angive både ''FromDateTime'' og ''ToDateTime''

==== Svar ====

Nedenfor ses et eksempel på et svar:

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

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
  * 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.
  * Information vedr. evt. bestilling til apotek er under et ''Order'' element.

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

Receptanmodningerne returneres i omvendt kronologisk orden. Det vil sige nyeste først.

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

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

''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.