Admin OPD Services Overview - hmislk/hmis GitHub Wiki
OPD Services Overview
Overview
The OPD Services module is where all billable services — consultations, procedures, investigations — are defined, categorised, and made available to billing departments. Setting up services correctly is foundational: the service record is what appears on bills, drives fee calculations, and controls billing behaviour for each item.
Navigating to Item/Service Management
- Click Administration in the main menu
- Click Manage Items
- The item management index opens with a left-side navigation panel
Required privilege: AdminItems
What Is an "Item"?
In HMIS, the word Item is the general term for anything that can appear on a bill. Items have a type (DTYPE) that determines which module uses them:
| Item Type | Used For |
|---|---|
| Service | OPD consultation fees, procedures, packaged services |
| Investigation | Lab tests and imaging studies |
| InwardService | Inpatient/IPD charges |
| Package | Grouped services sold as a bundle |
| PharmacyItem | Drugs and consumables |
When you navigate to Manage Items, you can work with Services and Investigations. Pharmacy items are managed under Pharmaceutical Management.
How OPD Item Listing Works — The Three Controls
When a cashier opens a new OPD bill, the system determines which items to show based on three configurable controls that work in combination:
- Item is active — only non-retired, non-inactive items appear
- Institution mapping — the item must be mapped to the cashier's institution (or no institution restriction applies)
- Department mapping — the item must be mapped to the cashier's department (or no department restriction applies)
The full detail is in How OPD Item Listing Works — Overview.
Fee Resolution Order
For each item shown in an OPD bill, the system resolves the price in this priority order:
- Department fee — a fee specifically set for this department
- Site fee — a fee set for the physical site
- Base fee — the default price for all departments
This means different departments can charge different prices for the same service without duplicating the service record. Details in Fee Configuration Overview.
Key Administration Tasks
| Task | Navigation |
|---|---|
| Create a new OPD service | Item management → OPD Services → Add |
| Create service categories | Item management → OPD Service Categories |
| Map services to an institution | Item management → Manage Institution Item Mappings |
| Map services to a department | Item management → Manage Department Item Mappings |
| Set base fees | Administration → Manage Pricing |
| Set department-specific fees | Administration → Manage Pricing → Department Fees |
| Define packages | Item management → Packages |