Room reservations allow staff to pre-book a specific room for a planned admission before the patient physically arrives. The reservation is visible on a calendar so that overlapping bookings are avoided.

Page: Inpatient → Appointment → Room Reservations
XHTML: /inward/inward_reservations_schedule_calendar.xhtml
Controller: InwardReservationController
Privilege: InwardRoomRoomOccupency

---

The page displays a date-range calendar view of all room reservations. Filters:

• From Date / To Date — view reservations within a time window
• Status — filter by appointment status (Scheduled, Confirmed, Cancelled, etc.)

Each reservation block shows the patient name, room, and time slot.

---

Reservations are created through the Add Appointment / Appointment Admission flow in the Appointment sub-menu. The calendar view is used to check availability before booking and to manage existing reservations.

---

Status	Meaning
Scheduled	Reservation made; patient not yet admitted
Confirmed	Reservation confirmed by ward
Cancelled	Reservation cancelled

---

When the patient arrives, the reservation is converted into an active admission. There are two routes:

1. From the Reservation Calendar — click the reservation block, then Admit on the Reservations Details dialog. The admission screen (Inpatient → Appointment → Patient Admit) opens with the patient, room, and appointment bill already attached.
2. From the menu — Inpatient → Appointment → Appointment Admission, then pick the reservation.

Both pick up the pre-selected room and appointment bill and carry the reservation forward to the admission.

The Reservations Details dialog opened from a calendar block. Admit takes the reservation straight to the admission screen. (Patient, doctor, mobile and appointment number are blacked out here.)

After Admit: the "Admit a Patient" screen opens with the reserved patient loaded and the Appointment tab available. (Patient details blacked out.)

Admission from a reservation is allowed only within a time window around the reservation, not only on the reservation's calendar day. The window is:

• from a configurable number of hours before Reserve From — Inward - Reservation Admission Early Window (Hours) (default 24), and
• until a configurable number of hours after the reservation end — Inward - Reservation Admission Grace Period (Hours) (default 24). When a reservation has no explicit Reserve To, Reserve From is used as the end.

Outside the window, Admit shows "Reservation not yet open for admission" (too early) or "Reservation Expired" (too late) and no admission is created. A reservation with no Reserve To is treated as valid (matching how the calendar lists it) — it is not rejected just for lacking an end date.

Both values are ConfigOption rows of type LONG, resolved per department first — a "<Department> - Inward - Reservation Admission …" row overrides the plain application-scoped row, which in turn falls back to the 24-hour default. Edit the application-wide value at Administration → Manage Institutions → Preferences → Application Options, or set a department-specific value at Department Options.

The two admission-window keys in Application Options, both defaulting to 24 hours.

With the grace period set to 0, admitting a reservation whose window has already passed is blocked with "Reservation Expired".

---

• Inpatient — Room Occupancy and Vacancy — live view of what is occupied
• Inpatient — Admit a Patient — standard admission without a prior reservation
• Admin — Room Categories, Rooms, and Room Fees — room setup