Add Outside Charges - hmislk/hmis GitHub Wiki

Path:

Inward > Services and Items > Add Outside Charges

It's also reachable directly from an admission's Inpatient Dashboard via the Add Outside Charges button, and from the Surgery Workbench for a surgery's admission — both pre-load the correct patient/admission so you can skip the search step below.

1. Search and Select BHT

You can search using the patient's name or the BHT number.

2. Select the institution from which the charge is from

All charges on one bill must come from the same outside institution — see Outside Institution is locked once a charge has been added below.

3. Select the item, enter the amount, and add a note if needed

There is no Inward Charge Type field to fill in. The charge type is taken from the item's own Inward Category and shown back to you in the Inward Charge Type column once the charge is added. An item with no Inward Category configured cannot be billed here, and the screen will say so.

4. Select "Add"

Then the Charge will be added to the selected BHT.

5. Select "Settle" once every charge for this institution has been added, and confirm the prompt. Only then is the bill created; charges sitting in the list are not yet billed.

The item you select here is what will identify the charge everywhere it's shown afterwards — on this page's own print/settle preview, on the Service Bill, and on the Interim Bill, which lists it by this item's name instead of just the charge category.

Item field is filtered to outside-fee-eligible items

The Item field only lists items that are actually configured for outside charges at the logged department's site — it no longer shows every Service/Investigation in the system.

• Default filtering: an item appears only if, among its non-retired site-level fees (configured on Item Fees for Sites), the only fee type configured is the Outside Fee. An item with a Hospital Fee (or any other fee type) at that site — with or without an Outside Fee alongside it — is excluded.
• Optional stricter mode: an admin can additionally require the item to be explicitly mapped to the site on Admin > Manage Items/Services > Item Mapping > Manage Outside Charge Item Mappings. This is opt-in via a config key and is off by default.
• Departments with no site configured keep the previous, unrestricted item list.

Typing "VACCINATION" matches one eligible item out of three same-named items in the system — the other two have no Outside Fee configured at this site.

Fee Breakdown resolves to the logged site's fee only

Expanding an added charge row shows its Fee Breakdown — the individual fee component(s) that make up the billed amount. This resolves to the Outside Fee configured for the logged department's site only (the same Item Fees for Sites configuration the eligibility check above uses). If the same item also has an Outside Fee configured at the department level (the "Departments Fees" tab on the same admin page), that department-level fee does not also apply here — only the site-level fee is used, so the two are never summed together.

A single "Ambulance Company Charge" row for the site's Outside Fee — a Department Fee configured for the same item does not additionally apply.

Follow-up fixes: Amount field, Outside Institution locking, and new columns

A second pass on issue #23311 fixed a related gap the fee-scoping fix above didn't cover, plus a few small usability issues on the same page:

• Amount field now matches the Fee Breakdown total. The Amount field used to pre-fill from the item's legacy, unscoped total (which could include both a Site Fee and a Department Fee added together), so it could disagree with the site-scoped Fee Breakdown total described above. It now pre-fills from the same site-scoped fee resolution, so the two numbers can no longer disagree.
• Outside Institution is now required, and clearly highlighted. Clicking "Add" without selecting an Outside Institution used to only show a toast message. The field itself is now outlined in red with an inline message until an institution is selected.
• Outside Institution is locked once a charge has been added. All charges on one Outside Charges bill must come from the same institution, since each fee line now separately records the institution it was billed under. The "Change" button next to the institution name disappears after the first charge is added; start a New Bill to bill a different institution.
• New "Inward Charge Type" column in the Outside Charges table, showing the item's configured charge type label (e.g. "Ambulance Charges") next to the item name.
• "No" column in the Outside Charges table no longer takes up disproportionate width for a 1–2 digit row number.

Clicking Add without an Outside Institution selected highlights the field in red with an inline message. The Amount field is pre-filled at 1000 (the site-scoped fee), and the new "Inward Charge Type" column appears in the Outside Charges table header.

Related Pages

• Inpatient Outside Charges — the finance view of the bills created here: bill types, how they roll into the interim/final bill, and how to find, cancel or return a settled outside charge
• Add Services and Investigations — the equivalent screen for services the hospital performs itself
• Item Fees for Sites — where the Outside Fee used here is configured

Back