# Fee Types and Characteristics ## Overview Every fee component in HMIS has a **Fee Type** that determines how it is categorised, who it applies to, and how it appears in financial reports. A single service can have multiple fee components of different types — for example, a total consultation bill might consist of a "Hospital Fee" (Outpatient type) and a "Doctor Fee" (Staff type). Understanding fee types is the key to configuring correct billing and accurate financial reporting. ## The FeeType Enum — All Values | Fee Type | When to Use | |---|---| | **Outpatient** | The standard fee charged to OPD patients. This is the most common type for consultation and procedure fees. | | **Staff** | A fee that applies specifically to staff members of the institution, usually at a discounted rate. Can be linked to a specific speciality and/or staff member. | | **Member** | A fee for patients who are membership cardholders of the hospital's loyalty or welfare program. | | **OwnInstitution** | A special rate when the patient is from the same institution group (e.g. another branch). Must specify the institution. | | **OtherInstitution** | A rate that applies when billing another specific institution (e.g. a referring hospital or partner organisation). Must specify the institution. | | **Chemical** | A fee representing the consumable or drug component of a service (e.g. reagents used in a lab test). | | **Department** | A fee allocated internally to a department for accounting purposes (not charged to the patient). | | **Tax** | A tax component added on top of the base fee. | | **Issue** | Used in pharmacy — represents the issued item's cost component. | | **Additional** | Any extra charge that does not fit the other categories. | | **Service** | A service fee component used in certain billing configurations. | | **CollectingCentre** | The fee component that applies when the billing originates from a collecting centre. | | **Referral** | A fee paid to a referring institution or agent. Must specify the referring institution. | ## Characteristics of a Fee Each fee component, regardless of type, has the following characteristics: ### Discounts Allowed When enabled, the billing system will allow a discount to be applied to this fee component. When disabled, the fee is fixed and cannot be reduced. - Controlled by: **Discounts Allowed** toggle on the fee form - If the service-level **Discount Allowed** flag is off (set during service creation), no fee components can be discounted even if the fee says discounts are allowed ### Service Charge Allowed (Margin Allowed) When enabled, a service charge or margin can be added on top of this fee component during billing. - Controlled by: **Service Charge Allowed** toggle on the fee form - If the service-level **Margin Not Allowed** flag is on, this setting is overridden ### Foreigner Fee Each fee component can have a separate rate for foreign patients. If the foreigner fee is set to 0, the system defaults to the regular fee. ## Fee Type-Specific Behaviour ### Staff Fee (with Speciality and Doctor Selection) When you set a fee type to **Staff** and add a speciality and staff member, this fee component will only apply when the billing is for that specific staff member in that speciality. This enables different consultation fees per doctor. See [Fees by Speciality and Staff Member](Admin-Fees-by-Speciality-and-Staff). ### OwnInstitution / OtherInstitution / Referral (with Institution and Department) When these types are selected, additional **Institution** and **Department** selectors appear. The fee will only be applied when the patient's billing institution matches the configured one. ## Multiple Fee Components on One Service A service can have several fee components. Common patterns: **Standard Consultation:** - Component 1: `Outpatient` — Rs. 1,500 (total patient charge, discounts allowed) **Consultation with Doctor Split:** - Component 1: `Outpatient` — Rs. 1,500 (total charge) - Component 2: `Staff` linked to Dr. Silva — Rs. 1,000 (doctor's share, paid separately) - Component 3: `Department` — Rs. 500 (hospital's share, internal accounting) **Discounted Staff Rate:** - Component 1: `Outpatient` — Rs. 1,500 - Component 2: `Staff` (no specific doctor) — Rs. 500 (applies when billed to any staff member) ## Technical Notes (Admin/Developer) Fee types are defined in the `FeeType` enum in the `com.divudi.core.data` package. Each `Fee` entity has a `feeType` field of this enum type. The `staff` field links to a `Staff` entity (for Staff type); the `speciality` field links to `Speciality`; the `institution` and `department` fields handle OwnInstitution/OtherInstitution/Referral. `discountAllowed` and `marginAllowed` are boolean fields on `Fee`. The billing engine applies the correct fee based on the patient type and context. ## Related Features - [Base Fees — Setting and Editing](Admin-Base-Fees) - [Fee Configuration Overview](Admin-Fee-Configuration-Overview) - [Fees by Speciality and Staff Member](Admin-Fees-by-Speciality-and-Staff) - [Discount Configuration](Admin-Discount-Configuration)