Inpatient Bill Cancellations and Refunds Overview - hmislk/hmis GitHub Wiki

Inpatient — Bill Cancellations and Refunds (Overview)

The inpatient module provides dedicated cancellation and refund pages for each bill type. All cancellations require privilege and record a reason; cancelled bills are retained in the database for audit purposes.

Cancellation Pages

Bill Type Page Notes
Final bill /inward/inward_cancel_bill_final.xhtml Cancels the final bill; returns BHT to pre-settlement state
Payment bill /inward/inward_cancel_bill_payment.xhtml Cancels a collected payment
Professional fee bill /inward/inward_cancel_bill_professional.xhtml Cancels a professional fee bill
Provisional bill /inward/inward_cancel_bill_provisional.xhtml Cancels a provisional bill
Refund bill /inward/inward_cancel_bill_refund.xhtml Cancels an already-issued refund
Service bill /inward/inward_cancel_bill_service.xhtml Cancels a services & investigations bill
BHT bill (general) /inward/bht_bill_cancel.xhtml General BHT bill cancellation
Deposit payment /inward/inward_deposit_cancel_bill_payment.xhtml Cancels a deposit collection

Refund Pages

Refund Type Page Notes
General inpatient refund /inward/inward_bill_refund.xhtml Refund against a settled bill
Service bill refund /inward/inward_bill_service_refund.xhtml Refund for a specific service bill item — InwardServiceController

Pharmacy Cancellations

Pharmacy-related inpatient cancellations (issue cancellations, reprint) are handled by the pharmacy module. See:

How Cancellations Work

When a bill is cancelled:

  • The bill record is flagged cancelled = true and a CancelledBill record is created — the bill itself is not deleted
  • Bill items and fee lines remain retired = false so that cancellation print-outs display correctly
  • A new contra-bill may be created depending on the cancellation type
  • The BHT totals are recalculated

Note: Cancellation does NOT set retired = true on bill fee lines. This distinction is important for reports and print-outs — cancelled bills remain queryable.

Audit Trail

Every cancellation records:

  • Cancelling user
  • Cancellation timestamp
  • Reason for cancellation

Related Articles