Inpatient Cancel Admission - hmislk/hmis GitHub Wiki

Inpatient — Cancel Admission

Reached from: Inpatient Dashboard → Cancel Admission (red button under the Admission panel). Controller method: BhtEditController.navigateToCancelAdmission. Privilege: InwardAdmissionsEditAdmission.

Cancels an admission that was created in error. The admission record stays in the database (audit trail) but is marked retired so it disappears from active dashboards and search lists.

When to cancel

Situation Action
Admission created against the wrong patient, no charges yet Cancel here, then re-admit under the correct patient.
Admission created against the wrong patient, charges already exist Use Change Patient for Admission instead — cancelling here would leave the bills orphaned.
Patient changed their mind and went home before any care was given Cancel here.
Patient was admitted but you now want to discharge them normally Do not cancel — use Room Discharge → Final Bill Generation instead.

Pre-conditions

Before pressing Cancel Admission:

  1. No active bills — service bills, professional fee bills, pharmacy issues, deposits, surgery bills. If any exist, cancel each one first (see Bill Cancellations and Refunds).
  2. No payments received — refund any deposit collected; do not just cancel and leave money in limbo.
  3. No baby admission linked to this admission — cancel the baby's admission first or detach it.

The system will warn you if any of these are present, but it is your responsibility to make sure nothing is left dangling. Cancelling does not auto-cancel child records.

What cancellation does

  • Marks the admission as retired (retired = true, retirer, retiredAt).
  • Releases the room (PatientRoom.discharged = true) so it can be assigned to another patient.
  • Hides the admission from the standard inpatient search and dashboard lists.
  • Is journalled — the cancelling user and timestamp are kept on the admission record, and the row remains visible to admin tooling for audit.

What cancellation does not do

  • Does not delete the patient record.
  • Does not refund deposits — do that explicitly through the payment cancellation pages.
  • Does not cancel surgery bookings made against the BHT — cancel those in the theatre module first.
  • Does not unlink baby admissions — handle each baby separately.

See also