Theatre Timed Services - hmislk/hmis GitHub Wiki
Theatre β Timed Services in Surgery
Overview
Timed Services are charges calculated based on how long a resource was used during a surgical procedure β for example, operating theatre time charged per hour, ventilator time, or recovery room time. Theatre billing staff record the start and end times of each timed service, and the system automatically calculates the charge based on the duration and the configured rate.
When to Use
- Recording OT room usage time for a surgical case
- Billing for ventilator, anaesthetic machine, or recovery room time
- Any duration-based charge that is linked to a specific surgery
Required Privilege
TheatreBilling
Navigating to Add Timed Services
From the Surgery Workbench:
- Open the Surgery Workbench for the patient
- Click Add Timed Services
- The page opens with the surgery pre-loaded
From the Theatre menu:
- Click Theatre β Add Timed Services
- Search for and select the patient's surgery using the autocomplete
Step-by-Step: Recording a Timed Service
Step 1 β Select the Surgery (if not pre-loaded)
If entering from the menu, type the patient's name, BHT, or surgery name in the search field and select from the results.
Step 2 β Add a Timed Service
- Click in the Timed Item field
- Type part of the service name (e.g., "OT Time", "Ventilator") and select from the autocomplete
- Set the Start Time using the calendar/time picker β this is when the resource usage began
- Click Add Time Service
The service appears in the consumed timed services table.
Step 3 β Finalise the Service (Set End Time)
If the end time is not known when the service is first recorded, finish it later:
- Ending now: press Stop on the service's row. The current time becomes its End Time, the charge is worked out up to now, and the service stays on the bill. Stop shows only on a service that is still running.
- Ending at an earlier time: enter the End Time on the row and press Update. The system works out the duration and charge again.
Step 4 β Review the Timed Services
The timed services table shows all recorded entries for this surgery:
| Column | Description |
|---|---|
| Service Name | The timed item name |
| Start Time | When the service began |
| Stopped Time | When the service ended (blank if not yet finalised) |
| Total | Calculated charge (duration Γ rate) β only shown to users with the NursingIPBillingViewRates privilege |
| Date Added | When this record was created |
| Added By | System user who recorded the entry |
| Update / Stop / Delete | Save edited times, stop a running service now, or delete a service entered by mistake |
Entries shown in red are deleted services.
Note: The Total column is hidden for staff who don't hold the NursingIPBillingViewRates privilege β the same privilege that gates rate/value visibility on other inpatient billing screens. Staff without it still see the rest of the table (service name, times, dates) but not the charge value.
How the Charge is Calculated
The system uses the start and end times to calculate:
- Duration in the billing unit configured for that timed item (hours, minutes, or days)
- Charge = Duration Γ Rate per unit
Example: If "OT Time" is configured at 500 per hour and the surgery ran for 2.5 hours, the charge would be 1,250.
Stop or Delete: Do Not Say "Remove"
| You want to⦠| Press | What happens |
|---|---|---|
| End a service that was really given | Stop | It stays on the bill, charged up to the End Time |
| Undo a service entered by mistake | Delete | It and its charge leave the bill |
"Remove" could mean either one, and they have opposite effects on the bill, so the system no longer uses that word for timed services. Say Stop or Delete when reporting a problem or training staff.
Deleting a Timed Service
To delete a service that was added in error:
- Click the Delete button next to the entry in the table
- Confirm in the Delete Timed Service dialog. Press No to keep it.
- On the Surgery Workbench's Timed Services tab, the entry stays visible as a history record of the surgery: the Date column shows a red "Deleted at <date/time>" line under the original add date, and the Added By column shows a red "Deleted by <name>" line. The Delete button for that row is then disabled, and the surgery bill total no longer includes the deleted service. The deleted service is not listed on the admission's interim bill, because it is no longer a charge.
Before deletion, the row's Date/Added By columns show only the original add date and the user who added it:

Before deletion: the service is active and its Delete button is enabled. Staff names are masked.
After clicking Delete and confirming, the same row shows the red "Deleted at"/"Deleted by" history and the Delete button is disabled:

After deletion: the row records when and by whom the service was deleted, and Delete is disabled.
Note: Deletion is only possible while the admission is not finalised, and β from the Surgery Workbench specifically β only while the surgery itself is still Pending Validation. Once a surgery is validated (Completed), the Delete button on its Timed Services tab is disabled and the deletion is also rejected server-side. See Surgery Bill Summary / Validate.
Understanding Messages
Success
- "Timed Service Added Successfully" β The timed service has been recorded and linked to the surgery bill
Error Messages
- "Please select a timed service" β A timed item must be chosen before clicking Add
- "Please select a surgery" β A surgery must be loaded first
- "Enter the Start Time" β A timed service cannot be added without a Start Time; set it to when the resource began to be used

- "End time cannot be before start time" β Correct the end time before saving
- "End time cannot be the same as start time" β A minimum duration is required
- "Admission has been finalised" β No new timed services can be added
Best Practices
- Record the start time at the moment the resource begins to be used β do not rely on memory
- Always finalise open-ended services before the patient is discharged so the final bill is accurate
- If multiple resources are used (e.g., both OT Time and Ventilator Time), add each as a separate timed service
- Review the timed services table in the Surgery Workbench before the patient's final bill is generated
Related Features
- Surgery Workbench β Access point and summary view
- Admin β Theatre Timed Services β Setting up timed service rates
- Theatre β Adding Services to a Surgery β For flat-rate theatre charges
- Theatre Management Module Overview