Finance Agency Management - hmislk/hmis GitHub Wiki
Agency Management
Introduction
Agencies are intermediary partners that direct patients to the hospital — booking agents for channelling, corporate clients, travel health agencies, and similar referral bodies. Agency management covers setup, credit limits, deposits, booking books, and payments to and from agencies.
Navigation
Channelling → Management → Agency tab → Agencies (set up agencies)
Payments → Agency Management (deposits, books, credit limits, payments)
Setting Up an Agency
- Go to Channelling → Management → Agency tab → Agencies. The Manage Channel Agents page opens.
- Click Add.
- Fill in:
- Name and Code — the code is used to pick the agency at billing
- Address, Phone, Mobile, Email, and the Contact Person details
- Standrd Credit Limit, Allowed Credit Limit and Allowed Maximum Credit Limit
- Click Save.
Agency Payment Methods
The PaymentMethod.Agent and PaymentMethod.OnlineBookingAgent values identify agency-collected payments in bills. When a patient is billed through an agency:
- The agency payment method is selected at billing.
- The amount is recorded as owed to/from the agency.
- The patient's bill is still generated; the agency settles with the hospital separately.
Channelling Agents
Channelling agents book appointments on behalf of patients and collect fees from patients directly:
- When booking a channel session, the Agent is selected on the appointment.
- The channel fee is attributed to the agent.
- The agent settles with the hospital at agreed intervals (daily, weekly).
See Channelling Overview for appointment booking details.
Agency deposits, credit and payments
Go to Payments → Agency Management.
| Tab | Button | Use it to |
|---|---|---|
| Manage | Accept Agency Deposits | Record money the agency pays in. Search Agency Deposits finds past deposits |
| Manage | Update Agency Credit Limit | Change how much the agency may book on credit |
| Manage | Issue Agency Books | Issue booking books to an agency. Search Agency Book Issues lists them |
| Manage | Pay Agencies | Pay money the hospital owes the agency |
| Agent | Agent Payment, Pay Agent | Pay an agent. Payment Done Search and Agent Payment Bill Search find past payments |
| Credit/Debit Note | Credit Note, Debit Note | Correct an agency's balance. Each has a search button |
Agency reports
Agency statements and booking summaries are under Channelling → Reports → Agent Reports tab, for example Agent Statement(27).