# 🧾 Cashbook in CareCode HIMS ## Overview The **Cashbook** in CareCode HIMS is a central financial log that records monetary movements resulting from shift handovers, deposits, and reconciliations. It ensures traceability, auditability, and transparency across all levels of operationβ€”**institution**, **site**, and **department**β€”by linking every transaction to its source. --- ## πŸ” Structure of a Cashbook Entry Each **cashbook entry** is created under the following structure: | Field | Description | | ----------------- | ------------------------------------------------------------------ | | **User** | The cashier or staff who performed the handover | | **Department** | The department from which the payment originated | | **Site** | Derived from the department | | **Institution** | Derived from the department | | **Date** | Entry date (shifts spanning multiple days are split automatically) | | **Amount** | Total of all payment modes for that shift handover | | **Payment Modes** | A breakdown (e.g., Cash, Card, Cheque, eWallet, IOUs) | > πŸ”„ **Note:** Cashbook entries are **only created once per transaction**, even if amounts are re-handovered between users later. --- ## πŸ§‘β€πŸ’Ό When Entries Are Created Cashbook entries are generated in the following events: ### βœ… Shift Handover * Each shift handover creates a **new cashbook entry**. * The system splits entries if a shift spans across calendar days. * One entry per user, per department, per day. ### βœ… Bank Deposits / Safe Deposits * When money is deposited to bank or safe, an entry **reduces** the cash book balance. * The deposit page selects the logged department's cash book by default; you may pick any other department's cash book. ### βœ… Withdrawals * Money withdrawn from the bank or safe back into the hospital **increases** the cash book balance. ### βœ… Non-Cash Settlement Approval * When a non-cash settlement (card processor settlement, cheque clearance, eWallet remittance) is approved, each settled payment **reduces** the cash book of the settlement's department. Cancelling the settlement puts the amounts back. See [Non-Cash Settlement](Non-Cash-Settlement). --- ## ❌ When Entries Are Not Created * **User-to-user float or re-handover** transactions do **not** create new cashbook entries. * The payment is only recorded **once**, at the point of the **original shift handover**. * **Billing, cancellations and returns** (OPD, pharmacy, inward, patient deposits and others) do **not** create cashbook entries. Collections reach the cashbook only when their handover is accepted. --- ## 🧾 Reporting The system provides comprehensive reporting views based on the cashbook: ### 1. **Individual Cashbook View** * View of cashbook entries per user * Shift-by-shift breakdown * Payment method breakdown ### 2. **Department Cashbook** * Aggregated entries per department * Used for internal audits and departmental financial summaries ### 3. **Site Cashbook** * Combined cash movements across all departments operating at the same site ### 4. **Institution Cashbook** * Aggregated view across all sites and departments under a legal entity Each report supports date range filtering, payment method summarisation, and user-based access permissions. --- ## πŸ’‘ Best Practices * Ensure all **shift handovers are accepted** before relying on cashbook totals. * Float movements should be reconciled using drawer-level reports, not cashbook. * Use institution and site cashbooks for **financial audits and bank reconciliations**. --- [πŸ”™ Back to Financial Management](https://github.com/hmislk/hmis/wiki/Financial-Management)