Admin Inpatient Admission Items and Fees - hmislk/hmis GitHub Wiki

Admin — Inpatient Admission Items and Fees

Page: /inward/inward_admission_items_and_fees.xhtml Reached from: Admin — Manage Inpatient Services → Admission Types tab → Admission Items and Fees. Controller: AdmissionTypeController.navigateToManageAdmissionItemsAndFees Privilege: InwardAdministration

This page defines the one-off charges that fire automatically when a patient is admitted under a given admission type. Examples: admission fee, registration fee, on-admission MO fee, ward kit charge, etc.

This is different from:

  • Timed services (room rent, oxygen, monitoring) — those accrue per unit of time. See Admin — Timed Services.
  • Services billed on demand (lab tests, X-rays, professional consults) — those are added through the various Add … pages during the stay.

Page layout

The page works at two levels:

  1. Pick an Admission Type from the dropdown / list at the top.
  2. The right pane shows the items currently attached to that type, each with its fee.

Below the list, an autocomplete to add a new item, and a fee panel to edit the fee of the selected item.

Per-item fields

For each item attached to an admission type:

  • Item — pick from the inward services catalogue (admission charges, MO charges, registration fees, etc., all Item records flagged for inward use).
  • Fee — the amount.
  • Fee components — many items break down into staff / hospital / OPD doctor / consultant components. The fee panel allows the admin to apportion the total across these.
  • Department / Institution scope — by default the fee is the same everywhere; if Inward Bill Fees are based on the site is enabled, you can scope a fee to a specific site (see Admin — Module Behaviour).

How the fees fire

When a patient is admitted with this admission type:

  1. The system iterates the items attached to the type.
  2. For each item it creates a BillItem on the admission's first service bill, with the configured fee.
  3. Components are written to BillFee rows so the per-staff / per-consultant share is available to the doctor-payment and staff-payment engines later.
  4. The total appears on the interim bill from the moment of admission.

If the admission type has no items attached, the admission produces no automatic charges — fine for purely manual admission types (test admissions, special cases), wrong for normal wards.

Editing existing fees

Editing a fee here changes only future admissions. Already-created bills are not retro-adjusted. To change an existing admission's fee, edit that specific bill item rather than the master fee.

Multiple admission types — common items

It is common to have the same item (e.g., "Admission Registration Fee") attached to several admission types. The fee can differ per type — a Day Case may carry a smaller registration than a Ward Admission. Configure each combination explicitly; there is no inheritance.

See also