Inpatient Room Occupancy and Vacancy - hmislk/hmis GitHub Wiki

Inpatient — Room Occupancy and Vacancy

Two related pages that give you the ward-clerk view of which beds are taken and which are free.

Page URL Menu
Room Occupancy /inward/inward_room_occupancy.xhtml Inpatient → Room → Room Occupancy
Room Vacancy /inward/inward_room_vacant.xhtml Inpatient → Room → Room Vacancy

Both are under privilege InwardRoomRoomOccupency (Room Occupancy specifically gates discharge from this page with InwardRoomDischarge).

Note — this is a paginated table view, not a real-time color-coded bed-map / floor plan. A live ward board with color-coded statuses and reservation overlap detection is not currently available. The closest real-time-style view is the Nursing Workbench tabs for Rooms / BHTs.

Room Occupancy

Shows every PatientRoom row — i.e., every room currently assigned to an admission. The table loads on demand; press Fill to load only your department's rooms, or Fill All to load every room in the institution.

Columns

Column What it shows
Room No Room name. A green ✓ icon means the BHT in this row has been discharged from this room; a red ✕ means still occupied. Discharged rows are coloured discharged-color.
BHT No Clickable link to the Inpatient Dashboard for that BHT.
Patient Patient name.
Guardian Guardian name + phone.
Credit Company Insurer linked to the admission (if any).
Payment Method Cash / Card / Credit Company / etc.
Action Discharge from Room if not discharged; Cancel Discharge from Room if discharged in error. Only rendered to users with InwardRoomDischarge.

Use case patterns

  • Daily ward round — Fill, scan for ✕ rows, click the BHT to open the dashboard.
  • Pre-cleaning a room — find the row by patient name, press Discharge from Room once the patient has actually left. This sets PatientRoom.discharged = true so the bed becomes available to other admissions.
  • Undo a wrong dischargeCancel Discharge from Room flips discharged back to false, re-opening the room to this admission. Important when the room has not yet been reassigned. See #20183 for a historical issue where discharged=0 left rooms looking occupied.

Room Vacancy

Shows every RoomFacilityCharge (i.e., every room that exists in the master data with at least one fee plan), not just occupied ones. Useful when you want to see what's available before admitting.

Columns

Column What it shows
Room Room name.
Category Room category (Private, Semi-private, General Ward, etc.).
Department The department this room belongs to.
Room Charges for 24 Room charge × 8 — a quick approximation of a 24-hour room rate (the underlying timed charge is per 3 hours; 8 × 3-hour blocks = 24 hours).

The 24-hour figure here is room charge only — it does not include linen, MO, nursing, administration, or medical care charges that may also apply for the same 24 hours. See Admin — Room Categories, Rooms and Fees for the full fee structure.

Press Fill to load the table.

Releasing a room from elsewhere

In addition to Discharge from Room on this page, a room is automatically released when:

See also