Finance Module Overview - hmislk/hmis GitHub Wiki
Finance and Cashier Module Overview
Introduction
The Finance and Cashier module is the central hub for all financial operations in HMIS. It covers the complete transaction lifecycle from opening a shift to closing the books at the end of the day. Cashiers, finance officers, department supervisors, and hospital administrators all use different parts of this module.
Who Uses This Module
| Role | Primary Tasks |
|---|---|
| Cashier | Start/end shift, collect payments, issue float transfers, record shortage/excess, handover |
| Finance Officer | Cashier summaries, cashbook review, day-end report, credit company settlements |
| Department Supervisor | Float management, drawer adjustments, department revenue reports |
| Administrator | Configuration, audit, drawer adjustments, QB/ERP export |
The Shift Lifecycle
Every cashier works within a shift. The shift defines the period over which their collections are tracked and reconciled.
- Start Shift — cashier opens a new shift by recording the opening float (cash in drawer) by denomination
- Collect Payments — OPD bills, pharmacy bills, inward bill payments, and other transactions are processed; each payment updates the cashier's drawer balance
- Float Transfers — during the shift, a supervisor may add or remove float; transfers are formally recorded with denominations
- End Shift — cashier generates a shift-end summary showing all collections by payment method
- Handover — cashier hands over physical cash and shift records to the next cashier or supervisor; acceptance is confirmed digitally
Navigation
The main hub is the Financial Transaction Manager, accessed from:
- Main Menu → (user menu, top right) → My Financial Transaction Manager
- Main Menu → Payment → Financial Transaction Manager
This opens cashier/index.xhtml, an accordion-panel dashboard with nine tabs: Shift, Drawer, Float Management, Handover, Income and Expense, Cash Book, Reports, Legacy, and Admin.
Module Sections
- Starting and Ending a Shift
- My Drawer
- Depositing Funds and Withdrawals
- Float Transfers
- Float Transfer Requests
- Shift Handover
- Shift Shortage and Excess
- IOU Bills
- Income and Expense Bills
- Drawer Adjustment
- Denomination Management
Billing Sub-Modules
QuickBooks and ERP Integration
HMIS can export financial data to QuickBooks (QB) in IIF format or via REST API. See QB Integration Overview.
Technical Reference
| Item | Detail |
|---|---|
| Main controller | FinancialTransactionController (80+ navigate methods) |
| Main page | cashier/index.xhtml |
| Privilege (user menu) | MyFinanacialTransactionManager |
| Privilege (payment menu) | PaymentBilling |