Supply of Products for Healthcare (SUPPLY), published by IHE Pharmacy Technical Committee. This guide is not an authorized publication; it is the continuous build for version 0.3.0 built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/IHE/pharm-supply/ and changes regularly. See the Directory of published versions

Inventory Query [PHARM-S7]

This section corresponds to transaction [PHARM-S7] of the IHE Technical Framework - Inventory Query. Transaction [PHARM-S7] is used by the Inventory Reporter and the Inventory Manager actors to query for the current status of an inventory position.

X:Y.Z.1 Scope

The Inventory Query [PHARM-S7] transaction is used to query about the inventory in a physical location, or a selected set of items for which the inventory query is issued.

Common cases covered

The following cases are covered with this transaction:

This transaction allows the Inventory Manager to ask an Inventory Reporter for current levels of inventory, so that the Inventory Manager can track the inventory count more accurately.

X:Y.Z.2 Actors Roles

Table X:Y.Z.2-1: Actor Roles

Actor	Role
Supply Requester	Sends Supply Requests to the Supply Request Filler
Supply Request Filler	Accepts the request sent from the Supply Requester

X:Y.Z.3 Referenced Standards

FHIR-R5 HL7 FHIR Release 5.0

X:Y.Z.4 Messages

Figure X:Y.Z.4-1: Inventory Status Query Interactions

X:Y.Z.4.1 Inventory Status Query

​The Inventory Manager submits an Inventory Query resource that conforms to the InventoryReporter profile.

X:Y.Z.4.1.1 Trigger Events

This method is invoked when the Inventory Reporter has updated information to report about the current inventory of one or several positions, e.g. after a monthly count, or daily after recalculating expected existences…

X:Y.Z.4.1.2 Message Semantics

The content type of the HTTP body shall be either application/fhir+json or application/fhir+xml.

The Inventory Reporter shall assure the report is consistent before sending, i.e. all authorizations and approvals are present.

X:Y.Z.4.1.2.1 Resource content

X:Y.Z.4.1.3 Expected Actions

Upon receiving the Inventory Status Report, the Inventory Manager can decide the actions like reporting, deciding on reordering, etc.

X:Y.Z.4.2 Supply Request Response

The Inventory Manager always returns a HTTP Status code appropriate to the processing outcome.

X:Y.Z.4.1.1 Trigger Events

This response is always expected and provides the inventory Reporter with the ackowledgement of the Inventory Status Report, including any technical issues. The response shall immediately follow the Inventory Status Report.

X:Y.Z.4.1.2 Message Semantics

The response to a Inventory Status Report shall consist of:

• In case the report is accepted, the response shall have the response code 201 (Created)
• In case of any error, the response shall have the adequate error code (see FHIR RESTful API for information on error handling)

X:Y.Z.4.1.2.1 Resource content

• When the Inventory Status Report is accepted (regardless of whether it may be acted upon), the response shall contain the resource that has been created from the Inventory Status Report, including the id, version, etc. as assigned by the server. This allows the Inventory Reporter to confirm what has been accepted.
• In case of error, the response should contain an OperationOutcome providing more information about the issue.

X:Y.Z.4.1.3 Expected Actions

Upon receiving the response to the Inventory Status Report, the Inventory Manager can persist the information provided by the Inventory Status Report (status, id, etc.) for future tracking, and can trigger a response to any issues, if they exist.