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

  1. Go to Channelling → Management → Agency tab → Agencies. The Manage Channel Agents page opens.
  2. Click Add.
  3. 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
  4. 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:

  1. When booking a channel session, the Agent is selected on the appointment.
  2. The channel fee is attributed to the agent.
  3. 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).


Back to Finance