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 Status Report [PHARM-S5]

This section corresponds to transaction [PHARM-S5] of the IHE Technical Framework - Inventory Status Report. Transaction [PHARM-S5] is used by the Inventory Reporter and the Inventory Manager actors to inform about status of an inventory position.

X:Y.Z.1 Scope

The Inventory Status Report [PHARM-S5] transaction is used to inform about the current status of an inventory position, where “inventory position” is a physical location, or a selected set of items for which the inventory status is reported.

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 Report Interactions

X:Y.Z.4.1 Inventory Status Report Message

The Inventory Reporter submits an InventoryReport resource instance that conforms to the InventoryStatusReport profile using the POST method to the /InventoryReport endpoint.

X:Y.Z.4.1.1 Trigger Events

This method is invoked when the Inventory Reporter reports updated information 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.