Inpatient Final Bill Generation - hmislk/hmis GitHub Wiki
Inpatient — Final Bill Generation
The final bill consolidates all charges accumulated during the admission into a single billable document. It is generated after nursing discharge is confirmed and must be settled before the admission is fully closed.
Page: Admission Profile → Billing panel → Final Bill (shown after discharge), or via menu search
XHTML: /inward/inward_bill_final.xhtml (generation), /inward/inward_bill_final_break_down.xhtml (breakdown)
Controller: BhtSummeryController / InwardBeanController
Privilege: InwardBilling
What the Final Bill Includes
The final bill aggregates every charge posted to the BHT:
| Charge Category | Examples |
|---|---|
| Room charges | Room rent, guardian room rent |
| Timed services | Oxygen, IV fluids, nursing procedures |
| Services & investigations | Lab tests, radiology, physiotherapy |
| Outside charges | External provider fees |
| Pharmacy issues | Medicines dispensed to the BHT |
| Professional fees | Consultant and specialist fees |
| Surgery fees | Theatre and surgery charges |
| Admission items | Auto-charged items configured on the admission type |
Bill Generation Steps
- Open the Final Bill page for the discharged BHT.
- Click Process — the system calculates all charges and updates totals.
- Review the line items in the bill breakdown panel.
- Optionally adjust line items (if permitted).
- Click Settle — this locks the bill and redirects to payment.
Depending on configuration, additional options appear:
- Show an Intermediate Bill on Final Bill Edit — if enabled, Process shows a preliminary printable bill before Settle
- Save Provisional Bill — saves a draft without settling (if config key enabled)
Bill Breakdown
The breakdown view (inward_bill_final_break_down.xhtml) shows charges grouped by category with subtotals. This view is useful for:
- Itemised review before settlement
- Printing a pre-settlement itemised statement for the patient or their insurance company
Discounts
Discounts can be applied to the final bill through the Discount Matrix configuration. See Admin — Inpatient Discount Matrix.
Price Adjustments
Per-BHT price adjustments (overrides to standard fees) can be applied for services, investigations, pharmacy, and store items. See Admin — Inpatient Price Adjustments.
After Settlement
Once Settle is clicked:
patientEncounter.paymentFinalized = true- The final bill is locked — no further charges can be added
- The Admission Profile Billing panel switches from "Interim Bill" to "Final Bill"
- Proceed to Inpatient — Final Bill Payment
Interim Bill (During Admission)
Before discharge, an Interim Bill (running total) is available from the Admission Profile at any time. It shows the current total without finalising anything. See also the Estimated Bill which includes professional fee estimates.
Related Articles
- Inpatient — Nursing Discharge — must be confirmed before settling the bill (replaces the old room-discharge gate as of PR #21553)
- Inpatient — Room Discharge — must be done before nursing discharge
- Inpatient — Final Bill Payment — collecting payment after settling
- Inpatient — Patient Deposits — deposits collected earlier are applied here
- Admin — Inpatient Discount Matrix — configuring discounts
- Admin — Inpatient Price Adjustments — per-BHT price overrides