Finance Inpatient Price Adjustments - hmislk/hmis GitHub Wiki
Inpatient Price Adjustments
Introduction
An inpatient price adjustment is a configured margin โ the hospital's service charge โ added on top of an item's base price when it is billed to an inpatient. Adjustments are set up as a matrix of rules keyed on department, item category, BHT type, admission type, room category, credit company, payment method and a price band, not entered per patient.
This trips people up, so it is worth stating plainly:
A price adjustment increases what the patient is charged. It is a markup, not a discount, and it is not a per-BHT concession. To reduce what a patient pays, use a discount or the discount fields on the final bill โ see Adjustments vs discounts below.
Where They Are Configured
Administration โ Manage Inpatient Services โ Price Matrix, then the matrix for the charge type being priced:
| Matrix | Applies to |
|---|---|
| Inward Price Adjustment - Service | Inpatient service bills |
| Inward Price Adjustment - Investigation | Inpatient investigation bills |
| Inward Price Adjustment - Pharmacy | Pharmacy issues to a BHT (ward issue, theatre issue, inpatient direct issue) |
| Inward Price Adjustment - Store | Store issues to a BHT |
| Inward Price Adjustment - Room Facility Category | Room and related accommodation charges |
Access requires the InwardAdministration privilege. (There is no InwardPriceAdjustment privilege โ that name belongs to the underlying entity, not to the privilege list.)
Each rule carries a From and To price band, a Margin, and the dimensions it is scoped by. Leaving Credit Company blank makes the rule apply to all companies; leaving Room Category as All Room Categories makes it apply regardless of the room.
The step-by-step procedure for adding, filling, editing and deleting matrix rows is documented on Inward Price Adjustment Matrix, which is the single source of truth for these screens. Rows are edited and deleted in the matrix table itself โ there is no separate add page or cancellation page.
How an Adjustment Reaches the Bill
The margin is resolved when the item is billed and is folded into the charge itself โ it is never a separate line on the patient's bill. On the final bill it can be seen only as a split of the total: Total Charges is the billed figure, and where the user holds the ShowServiceCharges privilege the screen also breaks it into Gross Total (before markup) and Service Charge (Margin) (the markup the matrix applied), per charge category as well as overall.
Because the margin is resolved at billing time, changing a matrix rule does not retrospectively change bills that have already been raised.
See Inpatient โ Final Bill Generation ยง Price Matrix Value for how the split is presented, and Inpatient Final Bill for the bill as a whole.
Adjustments vs Discounts
These are separate mechanisms, configured on different screens, moving the total in opposite directions.
| Price Adjustment (Price Matrix) | Discount | |
|---|---|---|
| Effect on the bill | Increases it โ adds the service-charge margin | Reduces it |
| Where configured | Administration โ Manage Inpatient Services โ Price Matrix | Administration โ Manage Inpatient Services โ Discount Matrix, or typed on the final bill |
| Scope | Rules matrix: department, category, BHT type, admission type, room category, credit company, payment method, price band | Rule matrix by patient type / credit company / payment mode, or a one-off figure on this bill |
| Visible on the bill | No โ folded into the charge; only the Gross/Margin split reveals it | Yes โ Item Discounts, Charge Type Discounts and Bill Level Discount are shown, and total as Total Discount |
| Documented at | Inward Price Adjustment Matrix | Admin โ Inpatient Discount Matrix |
A one-off concession for a particular patient is therefore made as a discount on that patient's final bill โ a Bill Level Discount, a per-category Adjusted Total, or a per-row discount on room charges โ not by adding a price-matrix rule.
Technical Reference
| Item | Detail |
|---|---|
| Pages | inward/inward_price_adjustment_service.xhtml, inward/inward_price_adjustment_investigation.xhtml, inward/inward_price_adjustment_pharmacy.xhtml, inward/inward_price_adjustment_store.xhtml, inward/inward_price_adjustment_room_category.xhtml |
| Reached from | inward/inward_administration.xhtml (Administration โ Manage Inpatient Services) |
| Controller | InwardPriceAdjustmntController (the missing "e" is an intentional legacy spelling โ do not "correct" it) |
| Entity | InwardPriceAdjustment (a PriceMatrix subtype) |
| Resolution at billing time | PriceMatrixController |
| Privilege | InwardAdministration |
Related Pages
- Inward Price Adjustment Matrix โ the end-user workflow for these screens
- Admin โ Inpatient Price Adjustments โ the administrator's reference
- Admin โ Inpatient Discount Matrix โ the mechanism that reduces a bill
- Inpatient Final Bill โ where the margin and the discounts both surface
- Admin โ Inpatient Charge Type Labels โ the categories the matrix is scoped by