Inward Professional and Surgery Payments - hmislk/hmis GitHub Wiki
Inward Professional and Surgery Payments
Doctors and consultants who attend inpatients earn fees that are tracked separately from OPD fees. HMIS settles inpatient (inward) professional fees through two related screens β one for general professional fees, one for surgery-specific fees. The workflow mirrors the OPD All-Due flow, but the source bills come from inward admissions and theatre records instead of OPD service bills.
For the OPD equivalent, see OPD Doctor Payments β All Due.
Inward Professional Payment
This is the catch-all settlement for inpatient consultant fees that are not classed as surgery β typically ward rounds, consults, and procedure fees billed on the admission.
Navigation
Top menu β Inward β Professional Payment. (Exact wording depends on your installation; the underlying page is the inward professional payment screen.)
Path: /inward/inward_bill_professional_payment.xhtml.
Privilege required: typically InwardBilling plus PaymentBilling. Ask your administrator if the menu item is missing.
Step 1 β Find due fees
Top filter row:
| Filter | Effect |
|---|---|
| From / To | Required date range, long date-time format. Limits to bill fees created in the window. |
| Speciality | Optional. Autocomplete from the All Specialities catalog (this screen uses the staff speciality, not the channelling Doctor Speciality). |
| Professional | Optional. Autocomplete for the doctor / consultant. Leave blank to include everyone. |
Click Find Due Payments. The grid populates with one row per unpaid fee line. Use Download as Excel to export the current results to Staff_Payment_Due_Inward.xlsx.
Step 2 β Select fees to settle
The grid has a row checkbox at the left of each row and a header checkbox to select all rows on the current page. As you tick or untick, the totals on the right recalculate live.
The grid usually exposes:
- Bill No (the admission's professional fee bill number)
- Bill Time
- Patient
- Item / fee line
- Charge type (Professional, Anaesthetist, Ward Round, etc.)
- Fee value
Step 3 β Choose payment method and WHT
The same Payment Details panel as the OPD All-Due screen sits below the grid:
| Field | Notes |
|---|---|
| WHT Calculation | Dropdown (or fixed badge depending on the Allow User To Select⦠setting) for the three calculation modes. See Withholding Tax on Professional Payments. |
| Payment Method | Cash, Cheque, Bank Transfer, etc. Credit methods are not offered. |
| Total Payment Completed for this month | Read-only running total for the chosen professional at the current institute. |
| Withholding Cutoff / Percentage | Read-only configuration values. |
The right-hand totals show Total Due, Paying This Time, Withholding Tax, and Paying This Time without WHT, all updating as you tick rows or change the WHT mode.
Step 4 β Settle
Click Settle Professional Payment in the panel header. Confirm the dialog. The system creates a payment bill (type Professional Payment for Staff) tagged for inward, links the selected bill fees to it, and switches to print-preview.
Step 5 β Print
Use the standard print button in the preview header. The voucher includes the doctor's name, the period covered, the fees paid, the WHT deducted, and the net amount.
Inward Surgery Payment
This screen is specialised for surgery-related payments β surgeon's fee, anaesthetist's fee, assistant's fee, and any theatre-fee splits configured per procedure.
Navigation
Top menu β Inward β Surgery Payment.
Path: /inward/inward_bill_surgery_payment.xhtml.
Privilege required: similar to the professional payment screen.
Workflow
The workflow is the same four-step pattern: date range and professional β grid of due surgery fees β select β settle. The differences are:
- The source bills are theatre / surgery bills, not ward bills.
- Each surgery typically generates several fee lines (surgeon, anaesthetist, assistant). The grid shows them as separate rows; pay them together or separately as your hospital practice requires.
- The Speciality dropdown filters by staff speciality; pick the speciality that applies to the recipient (e.g., Anaesthesia for the anaesthetist's payment run).
- WHT applies in the same way as the professional payment screen.
What this is not for
- Channelling payments. Consultants who see private patients on scheduled sessions are paid through the channelling module (Channel β Paying a Doctor), not here.
- OPD bills. OPD professional fees are paid through the OPD doctor payment screens (OPD Doctor Payments β Per Shift and OPD Doctor Payments β All Due).
- Salary. Salary payments run through the HR/payroll module, not the professional-payment screens. The two flows produce different bill types and live in different reports.
Limitations
- The screen does not partition fees by ward, theatre, or admitting consultant. If you want a per-ward summary first, run the inward professional payment report (a separate screen) before settling.
- Refunded admissions and cancelled surgeries may need a manual recheck β the grid hides cancelled bills, but partially-refunded admissions still show their professional fees because the surgery happened.
- A surgery payment bill, once finalised, cannot be partially edited. Cancel and rerun for corrections.