Finance OPD Bill Search and Reprint - hmislk/hmis GitHub Wiki
OPD Bill Search and Reprint
Introduction
OPD bills can be searched, viewed, and reprinted at any time after creation. This is used by cashiers to verify a previous transaction, supervisors to investigate queries, and billing staff to reprint lost receipts.
Navigation
- Bill View/Search: Main Menu → OPD → Bill Search (privilege:
OpdBillSearch) →opd/bill_view.xhtml - Reprint: Main Menu → OPD → Reprint →
opd/bill_reprint.xhtml - Cashier Bill Search: Main Menu → Financial Transaction Manager → Reports tab → Cashier Bill List
Bill Search
- Navigate to
opd/bill_view.xhtml. - Enter search criteria: bill number, patient name/ID, date range, department, or payment method.
- Click Search. The results list shows matching bills with: bill number, date, patient, department, total, payment method, status (active/cancelled).
- Click a bill to view its full detail: line items, fees, payment records, cancellation status.
Reprint OPD Bill
- Navigate to
opd/bill_reprint.xhtml. - Search for the bill and select it.
- Choose the print format (A4 or POS, based on configuration).
- Click Print. The receipt is rendered for printing.
When the department uses the 5×5 Custom 3 OPD bill (OPD Sale Bill is FiveFiveCustom3),
a Print (Raw Text) button next to Print sends the duplicate straight to a
dot-matrix printer in the printer's own font — see
OPD Bill — Raw Text (Dot-Matrix) Printing.
Original Bill Reprint
opd/original_bill_reprint.xhtml reprints the bill in its original format exactly as it was printed at time of creation — useful when the patient requires an exact duplicate.
FiveFiveCustom3 Receipt Layout Customization
The FiveFiveCustom3 OPD paper format (selectable per-user/department under Print → Paper Type on the bill view page, or via the department's opdBillPaperType preference) supports three admin-configurable customizations, set from Administration → Manage Institutions → Preferences → Department Options (or Application Options for a hospital-wide default):
| Config Option Key | Default | Effect |
|---|---|---|
OPD Bill Receipt Title |
OPD Receipt |
The title line printed under the department name (e.g. a lab-only site can set this to Laboratory Receipt). |
OPD Bill Registration Number |
(blank) | An optional accreditation/registration number line (e.g. PHSRC/ MC/357), printed only when set. |
Enable OPD Custom 3 Bill Header |
false |
When enabled, also prints the institution name, address, phone numbers, and email above the department name/title block. |
When the header block is enabled, the department's primary telephone number (Department.telephone1) prints in bold, followed by the secondary number (Department.telephone2) — both editable on the standard Department admin page.
All three keys resolve department first, then hospital-wide, then the default — the same pattern used throughout Application/Department Options — so one hospital's customization never affects another.

FiveFiveCustom3 receipt with Enable OPD Custom 3 Bill Header on, a custom receipt title ("Laboratory Receipt"), and a registration number set.
Patient Accept Payment
opd/patient_accept_payment.xhtml — for processing a pending balance payment from a patient (e.g. where partial payment was accepted earlier and the remainder is due now).
Cashier Shift Bill Search
cashier/cashier_shift_bill_search.xhtml — searches shortage, excess, IOU, and other shift management bills within a date range. Navigate via:
Main Menu → Financial Transaction Manager → Reports tab → Cashier Bill List or Main Menu → Financial Transaction Manager → Shift tab → Shift Shortage Bill Search
Scan Bill by Barcode
cashier/scan_bill_by_barcode_scanner.xhtml — cashier scans a bill barcode to instantly retrieve and view a bill.
Technical Reference
| Item | Detail |
|---|---|
| Controller | BillController, SearchController |
| Bill view page | opd/bill_view.xhtml |
| Reprint page | opd/bill_reprint.xhtml |
| Original reprint | opd/original_bill_reprint.xhtml |
| Patient payment | opd/patient_accept_payment.xhtml |
| Cashier search | cashier/cashier_shift_bill_search.xhtml |
| Barcode scan | cashier/scan_bill_by_barcode_scanner.xhtml |
| Privilege | OpdBillSearch, OpdBillItemSearch |