Channel Pay Doctor - hmislk/hmis GitHub Wiki
Paying a Doctor (Channel)
The Pay Doctor function processes payment of the consultant's share of channelling fees. It consolidates the doctor's earnings from one or more sessions into a payment bill.
Navigation
Menu → Channelling → Payment → Pay Doctor
Path: /channel/channel_payment_staff_bill
Requires the ChannellingPaymentPayDoctor privilege.
How Doctor Payments Work
When a patient pays a channel booking fee, the bill records:
- The hospital fee portion (retained by the hospital)
- The doctor fee portion (owed to the consultant)
The doctor's cumulative unpaid fees accumulate and are visible in the Payment Due Search. The Pay Doctor screen is used to settle these dues by creating a payment bill.
Paying a Doctor
Step 1 — Select the Consultant
In the Pay Doctor screen:
- Select the speciality (optional, to filter).
- Select the consultant from the Doctor / Staff field.
Step 2 — Select Sessions to Pay
The screen shows a list of sessions with unpaid doctor fees:
| Column | Content |
|---|---|
| Session Name | Session and date |
| Booking Count | Number of bookings in the session |
| Doctor Fee Per Booking | Fee per patient |
| Total Doctor Fee | Total owed for this session |
| Payment Status | Unpaid / Partially Paid |
Select the sessions (or individual bookings) to include in this payment run.
Step 3 — Set Payment Details
| Field | Description |
|---|---|
| Payment Date | Date of payment (defaults to today) |
| Payment Method | Cash, Cheque, Bank Transfer, etc. |
| Cheque / Reference No | Reference for non-cash payments |
| Notes | Optional memo |
Step 4 — Create the Payment Bill
Click Pay or Create Payment Bill. The system:
- Creates a
BillType.ChannelStaffPaymentbill recording the payment - Links it to the selected sessions/bookings
- Marks those sessions as paid
- Generates a printable payment summary for the doctor
Payment Due Search
Menu → Channelling → Payment → Payment Due Search
Lists all sessions where the doctor's fee has not yet been paid. Use this to identify which sessions are ready for settlement before opening the Pay Doctor screen.
Payment Done Search
Menu → Channelling → Payment → Payment Done Search
Lists all completed doctor payment bills. Use this to verify that a doctor has been paid for a specific period, or to reprint a payment summary.