# Inpatient — Room Reservations 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` --- ## Reservation Calendar 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. --- ## Creating a Reservation 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. --- ## Reservation Status Values | Status | Meaning | |---|---| | Scheduled | Reservation made; patient not yet admitted | | Confirmed | Reservation confirmed by ward | | Cancelled | Reservation cancelled | --- ## Converting a Reservation to an Admission 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. ![Reservations Details dialog with the Admit button](images/23615-reservation-details-admit.png) *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.)* ![Admission screen opened from the Admit button](images/23615-admission-screen-after-admit.png) *After **Admit**: the "Admit a Patient" screen opens with the reserved patient loaded and the **Appointment** tab available. (Patient details blacked out.)* ### Admission Window 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 `" - 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**. ![Admission-window ConfigOption rows in Application Options](images/23615-admission-window-config-options.png) *The two admission-window keys in Application Options, both defaulting to 24 hours.* ![Reservation Expired growl when outside the admission window](images/23615-admission-window-expired.png) *With the grace period set to 0, admitting a reservation whose window has already passed is blocked with "Reservation Expired".* --- ## Related Articles - [Inpatient — Room Occupancy and Vacancy](Inpatient-Room-Occupancy-and-Vacancy) — live view of what is occupied - [Inpatient — Admit a Patient](Inpatient-Admit-a-Patient) — standard admission without a prior reservation - [Admin — Room Categories, Rooms, and Room Fees](Admin-Inpatient-Room-Categories-Rooms-Fees) — room setup