Wiki Spaces


Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack


Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »


The heart of any institution is its people and the OpenHMIS project is creating tools to enable that "heart" to run more smoothly. Providing quality medical services is a challenge and OpenMRS is a great help to meet that challenge, but it does not directly address the administrative needs of a medical institution. This is where the OpenHMIS modules come in: we are creating OpenMRS modules that provide the tools to help institutions run more effectively.

The OpenHMIS Inventory Module is a simple inventory management system that runs within OpenMRS. As the name implies, it is a tool to help with inventory management and is at the center of many other institutional services such as Billing, Pharmacy, and Lab. This module specifically targets small-mid sized institutions that need a simple inventory management system and thus does not (currently) provide all the features that a more full-fledged inventory management system has. The main features include:

  • Item Management
  • Stockroom Management
  • Stock Operation Tracking

Future versions may include support for:

  • Stock Operation Requests
  • Automatic Item Stock Replenishment
  • Supplier Management
  • Support for External Inventory Systems



Version History

VersionReleasedRelease Notes


REST Web Services

The REST Web Services module must first be configured if this has not already been done.  

  1. On the OpenMRS Administration page, click on the REST Web Services - Settings link.  
  2. Update the Rest Web Services URI Prefix setting according to your OpenMRS server URI.  For example, if clients connect to the server with the following URI '' then the prefix should be '/openmrs'.

Global Options

The configuration for the Inventory Module is done through global options which can be accessed via the AdministrationSettings page.  

Inventory Auto Generate Operation Number: Whether or not to generate an operation number when a new stock operation is created.

Inventory Operation Number Identifier Source Id The ID of the Idgen module identifier source. Instructions for finding this ID can be found here.

Module Administration

Once the module has been installed, an OpenHMIS Inventory Module section will appear on the administration page with the following screens:

Inventory Role Creation

Add or remove the required privileges to use the inventory module to/from a role or create a new role with those privileges.

Manage Items

Manage the items that are used by your institution.  

Manage Departments

Manage the departments for items.

Manage Institutions

Manage the external institutions that item stock can be distributed to.

Manage Stockrooms

Manage the stockrooms and view stockroom details.

Note: If you have more than 100 locations and all of your locations are not displayed when adding/editing a stockroom, you can increase the REST parameter for maximum results to greater than your number of locations using the global property, ''.

Manage Operation Types

Manage the stockroom operation types.

View Stock Operations

View and process stockroom operations.

Generate Item Mappings

Generate item to concept mappings,

Inventory Module Concepts

To effectively use the inventory module, it is important to understand the different objects and how they relate.

ItemThe information about a product or service that can be purchased or tracked at an institution.
Item StockA physical item that is located in a stockroom or distributed to an external institution or patient. This includes a quantity and an optional expiration date. Item stock can only be created for items that are marked as having physical inventory.
StockroomA location where item stock is stored.
Stock Operation Type

The kind of stock operation to be performed. The module currently includes six stock operation types:

  1. Adjustment: Item stock quantities that do not match the current system quantity
  2. Disposed: Item stock that have expired and must be removed from circulation
  3. Distribution: Item stock that are distributed to a patient or external institution
  4. Receipt: Item stock that are added into the inventory system from an outside provider
  5. Return: Item stock that are returned to the system after being distributed
  6. Transfer: Item stock that are transferred from one stockroom to another.
Stock OperationMoves one or more item stock into, within, or out from the institution, as defined by the Stock Operation Type.
TransactionRecords the individual changes in item stock in a given stockroom. For example, if a single item stock is transferred from the Main stockroom to the Pharmacy stockroom, two transactions would be created; one for the item stock subtraction from Main and another for the item stock addition to Pharmacy.

All item stock changes occur via Stock Operations 

"My" operations

Processing operations

Creating new operations

Inventory Dashboard


Inventory Role Creation


Manage Items


Manage Departments


Manage Institutions


Manage Stockrooms


Manage Operation Types


View Stock Operations


Generate Item Mappings


  • No labels