Charges & bills

A bill is only as accurate as the charges on it, and charges are only correct when the charge master, the tariff and the router rules behind them are sound. This page covers the front half of the revenue cycle: how the Charge Master defines every billable item, how charges are captured and routed as care is delivered, how the DRG Grouper bundles inpatient episodes, and how a billing officer assembles those charges into a locked, invoiced bill. It is written for billing officers and cashiers who build bills, and for the revenue-cycle manager who maintains the master data underneath them.

Where to find it

  • Billing → RCM → Charges → Charge Master — the catalogue of every billable item with its price, service type and revenue account.
  • Billing → RCM → Charges → DRG Grouper — the diagnosis-related-group table used to bundle inpatient episodes into a single case payment.
  • Billing → RCM → Charges → Router Rules — the rules that send a charge to the right cost centre and revenue account.
  • Billing → RCM → Contracts → Payer Contracts — negotiated rates that override list prices for a given payer.

Individual charge lines and the bills they roll up to are reached from the bill record itself; collection of the resulting balance is covered on Payments & claims.

Before you start

Charge capture depends on master data being loaded first:

  • Every service the hospital sells must exist in the Charge Master with a list price, a service type and a revenue account.
  • Service Tariffs must be configured, because a charge takes its service type from the tariff it is linked to.
  • If a payer has negotiated rates, load them as a Payer Contract so the correct rate is applied instead of list price.
  • Departments and facilities must exist so router rules can target them.

The charge master

The Charge Master is the single source of truth for what each service costs and where its revenue lands. Each record carries an internal code, an optional CPT/HCPCS and ICD-10-PCS code, and a Local Code for the NHIF/SHA or insurer code. The Service Type classifies the item, which drives routing and reporting.

FieldMeaningRequired
DescriptionHuman-readable name of the billable itemYes
Internal CodeThe hospital's own item codeYes
CPT/HCPCS CodeInternational procedure code, if usedNo
Local CodeNHIF/SHA or insurer billing codeNo
Service TypeConsultation, Admission/Bed-night, Laboratory, Imaging/Radiology, Pharmacy, Procedure/Surgery, Supplies/Consumables or TherapyNo
List PriceStandard price before any contract or discountNo
Revenue AccountWhere billed revenue postsNo
Requires Prior AuthFlags items that must be cleared with the payer firstNo
High-Cost ItemMarks items for closer auth and denial scrutinyNo
Tip — Set Requires Prior Auth and High-Cost Item on the right master items so the prior-auth engine can fire automatically. See Payments & claims for how those flags feed the PA workflow.

Charge capture and routing

Charges are mostly created for you. As clinicians deliver care, the originating document — a consultation, a lab request, a dispense or a radiology order — raises an hms.charge line against the patient's visit. Each charge records its Source Reference (the originating document number) and is priced from its service tariff. A charge moves through Draft → Billed → Invoiced → Paid, and can be set to Cancelled.

Routing decides which cost centre and revenue account a charge lands in. The Router Rules evaluate by service type and optionally by department, facility or insurance scheme, then send the charge to the configured Route To Cost Center and Route To Revenue Account. Rules run in sequence order, so the most specific rule should sit highest.

  1. Confirm the service exists in the Charge Master with a correct service type.
  2. Create a Router Rule naming that service type and, if needed, the department, facility or scheme it applies to.
  3. Set the target cost centre and revenue account.
  4. Order the rule by sequence so specific rules win over general ones.

Charge and bill states

Both an individual charge and the bill that rolls charges up move through their own status chain. Knowing where a record sits tells you what you can still edit and what has already been committed to an invoice:

RecordStateMeaning
ChargeDraftCaptured but not yet on a billed invoice
ChargeBilledGathered onto a bill
ChargeInvoicedThe bill it belongs to has been invoiced
ChargePaidSettled in full
ChargeCancelledVoided and excluded from billing
BillDraftOpen for charge capture and edits
BillOpenCharges gathered; split computed
BillLockedFrozen against edits; lock date stamped
BillInvoicedPatient and insurer invoices produced
BillPaidPatient share fully collected
BillCancelledVoided

DRG grouping for inpatients

For admissions, the DRG Grouper turns an episode's diagnoses into a single case-based payment instead of line-by-line charges. Each grouper record holds a DRG code and description, a Major Diagnostic Category, a relative weight and a base payment, and links the primary and secondary ICD-10 codes that map to it. The Grouper type can be Africa-DRG, ICD-10-AM (Australian) or CMS-DRG, so the hospital can match the grouping standard its payers recognise.

DRG fieldMeaningRequired
DRG CodeThe diagnosis-related-group identifierYes
DRG DescriptionHuman-readable name of the groupYes
Major Diagnostic CategoryThe MDC the group belongs toNo
GrouperAfrica-DRG, ICD-10-AM (Australian) or CMS-DRGYes
Relative WeightThe case weight applied to base paymentNo
Base PaymentThe case payment before weightingNo
Primary / Secondary ICD-10 CodesDiagnoses that map to this groupNo

Building a bill into an invoice

A bill (hms.bill) gathers every charge for a visit and computes the split between the patient and the insurer. It carries the totals, the Pre-Authorisation Number where one applies, and a status that runs Draft → Open → Locked → Invoiced → Paid (or Cancelled).

  1. Open the visit's bill; confirm all expected charges are listed and the Total, Insurance Share and Patient Share look right.
  2. Apply any discount; the Discount Total and Balance Due update.
  3. Press Lock to freeze the bill against further edits; it moves to Locked and a lock date is stamped.
  4. Press Generate Invoice; the bill becomes Invoiced and patient and insurer invoices are produced.
  5. If a correction is needed, press Unlock (Reopen), fix the charges, then re-lock and re-invoice.
Bill fieldMeaning
TotalSum of all charges before split
Insurance SharePortion billed to the payer
Patient SharePortion owed by the patient
Deposit TotalPre-paid deposits applied to the bill
Paid TotalAmount collected so far
Balance DueWhat remains outstanding
Bill record showing charges and patient/insurer split
A bill rolls up the visit's charges and shows the patient-versus-insurer split.

Roles & access

  • HMS Charge / Bill cashier (facility) — capture and bill within their own facility.
  • HMS Charge / Bill manager (all) — work charges and bills across every facility.
  • RCM User / RCM Manager — maintain the Charge Master, DRG Grouper, Router Rules and Payer Contracts.

Tips & troubleshooting

ProblemFix
Charge billed at zeroThe service has no list price or no tariff — complete the Charge Master entry.
Charge posts to the wrong accountAdd or re-order a Router Rule so a more specific rule wins on sequence.
Cannot edit a chargeThe bill is Locked or Invoiced — Unlock the bill first.
Payer rate ignoredNo active Payer Contract line for that charge — add the negotiated rate.
Was this page helpful?