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