Admin Fee Configuration Overview - hmislk/hmis GitHub Wiki
Fee Configuration Overview
Overview
Fee configuration controls how much is charged for every service in HMIS. The system uses a layered fee model where a base price can be overridden at the site level, department level, or for specific fee types (staff fees, member fees, credit company rates). Understanding this model is essential before configuring any pricing.
Navigating to Fee Management
- Click Administration in the main menu
- Click Manage Pricing
- The pricing management index opens
Required privilege: AdminPrices
The Fee Hierarchy
Fees are resolved from most specific to most general:
Department Fee → overrides → Site Fee → overrides → Base Fee
When a bill is being processed, the system checks:
- Does a fee exist for this item + department? Use it.
- Does a fee exist for this item + site? Use it.
- Fall back to the base fee.
This means you set one base price for a service and only configure overrides where prices differ.
Fee Components
Each individual fee record on a service has:
| Component | Description |
|---|---|
| Fee Name | A label (e.g. "Hospital Fee", "Doctor Fee", "Staff Discount Fee") |
| Fee Type | The category of charge — determines who pays and how it is reported |
| Fee value | The amount charged |
| Foreigner Fee | An alternate fee for foreign patients (defaults to the regular fee if not set) |
| Discounts Allowed | Whether discounts can be applied to this fee component |
| Service Charge Allowed | Whether a service charge (margin) can be added on top |
Fee Types
The Fee Type defines the purpose of each fee component:
| Fee Type | Description |
|---|---|
| Outpatient | Standard OPD patient fee |
| Staff | Fee for staff members of the institution |
| Member | Fee for membership cardholders |
| OwnInstitution | Discount/rate for patients from the same institution group |
| OtherInstitution | Rate applied when billing another institution |
| Chemical | Consumable/chemical component of a service |
| Department | Fee allocated to the department (internal accounting) |
| Tax | Tax component |
| Issue | Pharmacy issue component |
| Additional | Extra charges |
| Service | General service component |
| CollectingCentre | Rate applicable to collecting centre transactions |
| Referral | Fee for referring institution |
A service can have multiple fee components of different types. For example, a consultation may have an "Outpatient" component (the total bill amount) and a "Staff" component (the portion paid to the doctor).
Total Fee Calculation
The total field on the item is the sum of all its fee components. When a fee component is added or changed, the system recalculates the item total automatically.
Key Fee Management Pages
| Page | What It Manages |
|---|---|
| Manage Base Fees | Global default fees for each item |
| Manage Department Fees | Department-specific fee overrides |
| Manage Site Fees | Site-specific fee overrides |
| Manage Collecting Centre Fees | CC-specific prices |
| Fee List Types | Named fee lists (e.g. for CC pricing tiers) |
| Payment Schemes | Allowed payment methods and discounts |
| Admin Discounts | Membership and payment method discount rules |