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 for one block of time |
| Foreigner Fee | Charge for one block, for foreign patients |
| Charged By | How elapsed time becomes money — One Time Fee, Per Minute, Per Hour or Per Day. Defaults to Per Hour |
| Duration | Length of one charged block, counted in the Charged By unit |
| Over Shoot | Grace period, in the same unit, before a part-used block is charged as a whole block |
| Fee Type | Patient category (Cash, Credit, etc.) |
See Admin — Timed Service Charging Units for how the four units behave, worked examples, and how they apply to room charges.
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 = number of blocks × fee per block, where a block's length comes from the service fee's Charged By unit and Duration (a One Time Fee is charged once, regardless of duration)
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 — Timed Service Charging Units — One Time, Per Minute, Per Hour and Per Day charging
- 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