Admin Collecting Centre Fees - hmislk/hmis GitHub Wiki

Collecting Centre Fees

Overview

Collecting centres receive a percentage of the fees for tests they refer to the main laboratory. Collecting Centre fees configure the exact amounts charged per test per centre, which may differ from the standard patient fees. This supports scenarios where different collecting centres have negotiated different rates or use different price lists.

When to Use

  • Setting a specific price for a test when ordered through a particular collecting centre
  • Configuring the CC-specific rate list after a new CC has been registered
  • Updating prices following a fee revision for CC partners
  • Assigning a named fee list to a collecting centre rather than configuring individual item fees

Navigating to Collecting Centre Fee Management

  1. Click Administration → Manage Pricing
  2. Select Manage Collecting Centre Fees from the pricing index

Required privilege: AdminPrices

The Manage Collecting Centre Fees Screen

Filters:

  • Select Collecting Centre — autocomplete showing CC Code and Name
  • Select Item — autocomplete showing the service or investigation

After selecting both, the screen displays:

  • Total — the current CC-specific total for local patients
  • A fee table with existing CC fee components

Adding or Editing Collecting Centre Fees

  1. Select the Collecting Centre and Item
  2. Click Add New Fee to open the fee dialog
  3. Configure the fee (same fields as base fees — Name, Fee Type, amounts, discount flags)
  4. Click Save

Bulk Upload of CC Fees

Upload Page What It Does
Upload to Add CC Fees by Item Code Adds new CC fees from a spreadsheet using item codes
Item Fee Upload Collecting Centre Upload or replace fees for a specific collecting centre
Collecting Centre Price List Upload Upload a full price list for a CC
Download Item Fees for Collecting Centres Export current CC fees to a spreadsheet

Assigning Fee Lists to Collecting Centres

Instead of configuring fees item by item, a named Fee List can be assigned to a collecting centre. This applies a pre-configured price list to all tests billed through that CC.

  1. Navigate to Assign Fee Lists to Collecting Centres from the pricing index
  2. Select the collecting centre
  3. Select the fee list to assign
  4. Save

For managing fee lists, see Fee Lists and Payment Schemes.

Retiring CC Fees

The Retire All Collecting Centre Item Fees utility allows you to retire (deactivate) all fee records for a collecting centre at once — useful when a CC relationship ends and you need to remove their price overrides.

Technical Notes (Admin/Developer)

CC fees are FeeValue entities with collectingCentre set to the CC institution. itemFeeManager.collectingCentre holds the selection. updateItemAndCollectingCentreFees() loads existing fees; addNewForCollectingCentreFee() creates records. The CC's feeListType field (set on the collecting centre record) links to a FeeListType for list-based pricing.

Related Features