====== Hent bestillinger ======

Denne service anvendes til at hente detaljerede informationer om bestillinger på udleveringsgrundlag for en given patient eller organisation.

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

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#GetOrdersRequestType|Request]]

Servicen kaldes med følgende parametre:
  * Et PersonId (''PersonIdentifier'') på patienten. Alternativt kan en ''OrganisationIdentifier'' angives, hvis der er tale om bestillinger til en organisation (for eksempel bestillinger på praksisrecepter).
  * En liste af bestillingsid'er (''OrderIdentifier''). Alternativt en afgrænsning af hvor gamle bestillinger, der skal medtages i svaret.  (''CreatedSince'').

==== Eksempel på forespørgsel ====

Nedenstående eksempler viser oplag på en Patient med CPR nummer 1111111118 (''PersonIdentifier ''). 

Hentning af bestillinger med bestemte id'er (''Identifier''). 

<code xml 1: GetOrdersRequest-Identifiers.xml>
<GetOrdersRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier >
    <OrderIdentifier>301483388005088</OrderIdentifier>
    <OrderIdentifier>301483388013088</OrderIdentifier>
</GetOrdersRequest>
</code>

Hent alle bestillinger lavet på og efter det angivne tidspunkt (''CreatedSince'')

<code xml 2: GetOrdersRequest-CreatedSince.xml>
<GetOrdersRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier >
    <CreatedSince>2019-05-01T12:00:00Z</CreatedSince>
</GetOrdersRequest>
</code>

Hent alle bestillinger lavet på og efter det angivne tidspunkt (''CreatedSince''), hvor modtageren er en lægepraksis.

<code xml 3: GetOrdersRequest-org.xml>
<GetOrdersRequest>
    <OrganisationIdentifier source="Yder">57890</OrganisationIdentifier >
    <CreatedSince>2019-05-01T12:00:00Z</CreatedSince>
</GetOrdersRequest>
</code>

===== Svar =====

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

Svaret vil indeholde:
  - Den ''PersonIdentifier'' eller ''OrganisationIdentifier'', som blev angivet i forespørgslen.
  - En række ''OrderOnWarrant''-elementer, som grupperer bestillinger efter udleveringsgrundlagets ID. Disse indeholder hver ''WarrantIdentifier'' på udleveringsgrundlaget og op til flere ''Order''-elementer.

[[fmk:medicinecard-inline_2022_01_01:feltbeskrivelser#OrderType|Order]]-elementerne indeholder følgende:
  * ''Identifier'', ID'et på den enkelte bestilling
  * ''Version'', versionsnummer på den enkelte bestilling
  * ''Status'', Status for bestillingen
  * ''Created'', Modifikatoroplysninger på den person/organisation, som har oprettet denne bestilling
  * Optionelt: ''ReportedBy'', Modifikatoroplysninger omkring personen/organisation, som indrapporterede denne bestilling
  * Optionelt: ''Modified'', Modifikatoroplysninger på person/organisation, som senest har foretaget ændringer 
  * ''OrderedAtPharmacy'', Organisationsoplysninger på det apotek, som bestillingen er sendt til/oprettet hos
  * Optionelt, max 3: ''DeliveryInstructionText'' Korte tekster med leverings instruktioner
  * Optionelt: ''Delivery'', Oplysninger om leveringssted
  * Optionelt: ''CancellationReason'', Årsag til annullering
  * Optionelt: ''HandoverIdentifier'' ID på den tilknyttede udlevering.

==== Eksempel på Svar====

<code xml GetOrdersResponse.xml>

<GetOrdersRequest>
    <PersonIdentifier source="CPR">1111111118</PersonIdentifier>
    <OrderOnWarrant>
        <WarrantIdentifier>34123421349709</WarrantIdentifier>
        <Order>
	     <Identifier>301483388005088</Identifier>
             <Version>34123132903812</Version>
             <Status>Udført</Status>
             <OrderedAtPharmacy>
                 <Identifier source="EAN-Lokationsnummer">5790001381615</Identifier>
                 <Type>Apotek</Type>
                 <Name>Kolind Apotek - Filial af Ebeltoft Apotek</Name>
                 <AddressLine>Drasbeksgade 16</AddressLine>
                 <AddressLine>8560 Kolind</AddressLine>
                 <TelephoneNumber>86392155</TelephoneNumber>
             </OrderedAtPharmacy>
             <Created>
                <By>
                    <HealthcareProfessional>
                        <Identifier source="Autorisation">2Q5TK</Identifier>
                        <Name>Tess Christoffersen</Name>
                        <Information type="SpecialityCode">PSYK</Information>
                    </HealthcareProfessional>
                    <Role>Læge</Role>
                    <Organisation>
                        <Identifier source="Yder">66974</Identifier>
                        <Type>Yder</Type>
                        <Name>Lægerne Vestergade</Name>
                        <AddressLine>Vestergade 2</AddressLine>
                        <AddressLine>8660 Skanderborg</AddressLine>
                        <TelephoneNumber>86521348</TelephoneNumber>
                        <EmailAddress>kontakt@laegernevestergade.dk</EmailAddress>
                    </Organisation>
                </By>
                <DateTime>2019-06-30T12:00:00Z</DateTime>
            </Created>
            <DeliveryInstructionText>Tag første dør</DeliveryInstructionText>
            <DeliveryInstructionText>Ring gerne på klokken</DeliveryInstructionText>
            <Delivery>
                <Priority>send til udleveringssted samme dag</Priority>
                <DeliverySite>
                    <Identifier source="Udleveringssted">12341234321</Identifier>
                    <Type>Medicinudleveringssted</Type>
                    <Name>Superbrugsen Kolind</Name>
                    <AddressLine>Bugtrupvej 1</AddressLine>
                    <AddressLine>8560 Kolind</Adressline>
                </DeliverySite>
            </Delivery>
            <HandoverIdentifier>301483388005088</HandoverIdentifier>
        </Order>
        <Order>
            [...]
        </Order>
    </OrderOnWarrant>
    <OrderOnWarrant>
        <WarrantIdentifier>341230483271</WarrantIdentifier>
        <Order>
            [...]
        </Order>
    </OrderOnWarrant>
</GetOrdersRequest>

</code>