Admin Inpatient Timed Services - hmislk/hmis GitHub Wiki
Admin — Inpatient Timed Services
Timed services are charges that accrue continuously over time while a patient is admitted — room rent, oxygen therapy, IV fluid administration, special nursing care, ventilator use. The system calculates the total charge based on the duration of use.
Pages: Admin → Manage Inpatient Services → Services
XHTML:
/inward/inward_timed_item_category.xhtml— categories/inward/inward_timed_item.xhtml— timed items/inward/inward_timed_item_fee.xhtml— fees
Controllers:TimedItemCategoryController,TimedItemController,TimedItemFeeController
Privilege:InwardAdministration
Three-level Structure
Timed Item Categories
Group timed services by type — e.g., Room Charges, Oxygen Therapy, Special Nursing.
| Field | Notes |
|---|---|
| Name | Category name |
| Code | Short code |
Timed Items
Individual services within a category — e.g., "Single AC Room per day", "Oxygen — continuous", "Ventilator support per hour".
| Field | Notes |
|---|---|
| Name | Service name |
| Category | Parent timed item category |
| Code | Short code |
| Unit | Time unit (e.g., per Day, per Hour) |
Timed Item Fees
The charge associated with a timed item. Multiple fees can be configured per item (for different patient types or institutions).
| Field | Notes |
|---|---|
| Timed Item | The service this fee applies to |
| Fee | Charge per unit of time |
| Fee Type | Patient category (Cash, Credit, etc.) |
Adding Timed Services to a BHT
From the Admission Profile or Nursing Workbench, use Add Timed Services to record the start (and optionally end) of a timed service for the patient. The controller InwardTimedItemController.navigateToAddInwardTimedServicesFromInpatientProfile() opens the timed service entry form.
Each timed service entry records:
- Start time (when the service began)
- End time (when it stopped, or current time if still running)
- Duration auto-calculated
- Charge = duration × fee per unit
Room Fees as Timed Services
Room occupancy charges are implemented as timed services. When a patient is admitted to a room, a timed service entry starts. On room change, the entry is closed at the change time and a new one opens for the new room. On discharge, all open timed services close automatically.
Timed Service Report
The timed service report (/inward/inward_report_timed_service.xhtml) shows timed service consumption filtered by date range, timed item, institution, site, and department. See the developer reference at Inward Navigation & Reference for filter details.
Related Articles
- Admin — Room Categories, Rooms, and Room Fees — room fees use timed services
- Inpatient — Room Change and Guardian Room Change — fee split on room change
- Admin — Inpatient Module Configuration Overview — navigation overview