...
Requirements
- OpenMRS 1.9.9+
- REST Web Services Module 2.x
- OpenHMIS Commons Module 3.x
- OpenHMIS Backbone Forms Module 2.x
- (Optional) Idgen Module: Needed to automatically generate operation numbers
Download
- Module: https://modulesaddons.openmrs.org/#/modulesshow/vieworg.openmrs.jsp?module=.openhmis.-inventory-module
- Source code: https://github.com/OpenHMIS/openmrs-module-openhmis.inventory
...
| Version | Released | Release Notes |
|---|---|---|
| 1.0 | 24-Sept-2014 | |
| 1.1 | 4-Nov-2014 | |
| 1.3 | 15-Dec-2014 | 1.3 Notes |
| 1.4 | 13-Feb-2015 | 1.4 Notes |
| 1.5 | 19-Mar-2015 | 1.5 Notes |
| 1.6 - 2.0 | 29-Apr-2015 | 1.6 - 2.0 Notes |
| 2.1 | 10-Dec-2015 | 2.1 Notes |
| 2.2.1 | 12-Apr-2016 | 2.2.1 Notes |
| 2.3.3 | 31-Aug-2016 | 2.3.3 Notes |
| 2.4.0 | 02-Nov-2017 | 2.4.0 Notes |
| Anchor | ||||
|---|---|---|---|---|
|
...
The Settings page also includes Reports that a user can select from pre-entered Jaspers Reports.
Module Administration
Before the OpenMRS 2.0 release, an OpenHMIS Inventory Module section appears at the far right corner of the home page after installation of the inventory module.
...
Below is a table showing all the inventory module management features and a brief description of what each is responsible for:
| Link | Description | Sample |
|---|---|---|
| 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 | Add, edit, retire, and purge the items (that is, the products and services) that are used by your institution. |  |
| Manage Departments | Add, edit, retire, and purge the item departments. |  |
| Manage Institutions | Add, edit, retire, and purge the external institutions that item stock can be distributed to. |  |
| Manage Stockrooms | Add, edit, retire, and purge the stockrooms and view stockroom details. |  |
| Manage Operation Types | Add, edit and retire the stock operation types. |  |
| Generate Item Mappings | Generate item to concept mappings. |  |
...
When viewing a stock operation with item stock details that were automatically selected the details will not show the specific batch or expiration, instead they will be listed as (Auto).
Step By Step Setup
Once you understand the various concepts, then you need to setup the various components so as to get a working prototype.
Rest Web Services
First setup the rest web services URI as explained in the configurations description above.
Create an Inventory Number Generator (optional)
You need to have installed the idgen module in order to use this functionality.
On the OpenMRS Administration page, click on the Manage Identifier Types – Patients link: |  |
|---|---|
Then you will click on Add Patient Identifier Type link as shown: |  |
Add the Name, description (optional) and the Number format in this example (0123456789) and the Save Identifier Type: |  |
After Saving the Identifier type above, you will get this page. Add Base Character set, First Identifier set which will be the first operation number. Then add a prefix, min and max length all optional and then Save |  |
Navigate to the Inventory Settings page where you will check the "Auto Generate Operation Number" check box and then choose the Inventory Generator as seen shown. Please remember to click Save Settings to effect changes. |  |
Create a department
Items from Pharmacy, those from Lab, Surgery and so on can be grouped under departments. So for example to create items from Pharmacy create a pharmacy department and then associate items to be created later under this department.
From Manage Inventory Module, click on Manage Departments | Click on New Department | Enter a name and optional description | Save Changes |
|---|---|---|---|
 |  |  |  |
Create Items
Create items and services.
From Manage Inventory Module, click on Manage Items | Click on New Item | Item Name, Department, Price and Default price are required | Save Changes |
|---|---|---|---|
 |  |  |  |
Create a Stockroom
Below is how to create a stockroom:
From Manage Inventory Module, click on Manage Stockroom | Click on New Stockroom | Enter a name and optional location | Save Changes |
|---|---|---|---|
 |  |  |  |
Perform Inventory Operation
Now that you have created a department, item and stockroom, you are ready to start performing inventory stock operations.
Ideally the first stock operation should be a receipt or initial operation. This will put item stock that is a quantity and expiration to your item(s)
| Click on Inventory Tasks |  |
|---|---|
| Then Click on create operation |  |
This is the Inventory operation page from which you'll change the Operation Type stockroom and enter the line items |  |
Change the Operation Type to Initial and the Destination Stockroom to Main Pharmacy. This means that you are creation an operation to be effected in Main Pharmacy for the item that you will choose below |  |
Search for the line item in the Operation Items section then enter a quantity and expiration for the item |  |
| Then save the operation |  |
Since the "Autocomplete Operation" check box in the inventory settings is off, then the Status of the Operation is pending awaiting completion. Click on the Operation in order to complete it |  |
Click on the Button on the Top right hand of the page and you will see a complete operation button |  |
| Click on Complete Operation to complete it |  |
| The status now changes to COMPLETED |  |
Inventory Dashboard
The Inventory Dashboard is the landing page to perform inventory-related activities. From this dashboard users can view and process their stock operations as well as create new stock operations. The dashboard is accessed from the Inventory link on the right side of the OpenMRS header. For the new version, the Inventory module is accessed from the home page using the Inventory application.
...