====== Søg bestillinger ======

Søgning på bestillinger kan anvendes til at fremsøge bestillinger, der er oprettet af en given organisation. Id'erne på de fremsøgte bestillinger returneres grupperet ud fra patient og status.

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

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

Forespørgslen indeholder følgende parametre

  * ''OrderingOrganisation'', identifier på den bestillende organisation
  * Ét eller flere af følgende flag: ''IncludeUnhandledOrders'', ''IncludeEffectuatedOrders'' og ''IncludeCancelledOrders''. Disse flag angiver om hhv. ubehandlede, udleverede og annullerede bestillinger ønskes fremsøgt.
  * CreatedSince, der afgrænser hvor gamle bestillinger man er interesseret i

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

Nedenstående eksempel viser søgning efter bestillinger oprettet af (''OrderingOrganisation'') som er et hospital med SKS kode. Der ønskes fremsøgt ubehandlede og annullerede bestillinger, ikke behandlede.

<code xml SearchOrdersRequest.xml>
<SearchOrdersRequest>
    <OrderingOrganisation source="SKS">6630</OrderingOrganisation>
    <IncludeUnhandledOrders/>
    <IncludeCancelledOrders/>
    <CreatedSince>2019-01-01T00:00:00Z</CreatedSince>
</SearchOrdersRequest>

</code>

===== Svar =====

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

Svaret vil indeholde en række ''Patient''-elementer som hver indholder bestillinger vedrørende den pågældende patient grupperet efter status. 

Hvert ''Patient''-element indeholder:
  * ''PersonIdentifier'': patientens ID, f.eks. CPR-nummer
  * ''UnhandledOrders'': indeholder et ''OldestCreatedDateTime'', som er tidspunktet for den ældste fremsøgte ubehandlede bestilling. Hernæst en række ''Identifier''elementer med de ubehandlede bestillingers ID'er.
  * 'EffectuatedOrders'': indeholder et ''OldestCreatedDateTime''- og en række ''Identifier''-elementer på fremsøgte udleverede bestillinger.
  * ''CancelledOrders'': indeholder et ''OldestCreatedDateTime''- og en række ''Identifier''-elementer på fremsøgte annullerede bestillinger.

En given sekvens af hhv. ubehandlede, udleverede eller annullerede bestillinger fremgår kun, hvis bestillinger med denne status er blevet fremsøgt.

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

<code xml SearchOrdersResponse.xml>

<SearchOrdersResponse>
    <Patient>
	<PersonIdentifier source="CPR">1111111118</PersonIdentifier>
	<UnhandledOrders>
		<OldestCreatedDateTime>2019-07-18T18:45:00Z</OldestCreatedDateTime>
		<Identifier>301483388005088</Identifier>
	</UnhandledOrders>
	<CancelledOrders>
		<OldestCreatedDateTime>2019-06-01T12:00:00Z</OldestCreatedDateTime>
		<Identifier>301483388013088</Identifier>
	</CancelledOrders>
    </Patient>
    <Patient>
    ...
    </Patient
    <Patient>
    ...
    </Patient
    ...
</SearchOrdersResponse>

</code>