Admin Collecting Centres - hmislk/hmis GitHub Wiki
Collecting Centres
Overview
Collecting Centres (CCs) are external sample collection points or referral locations that submit work to the main laboratory or hospital. They are typically clinics, pharmacies, or diagnostic centres that operate independently but send patient samples or referrals to your institution. The system manages their fees, credit limits, payment methods, and lab routing separately from regular departments.
When to Use
- Setting up a new external lab collecting centre
- Updating a collecting centre's fee list, percentage cut, or credit limits
- Configuring which laboratory institution and department receives samples from the centre
- Deactivating a collecting centre that has ceased operations
Navigating to Collecting Centre Management
- Click Administration → Manage Institutions
- Select Collecting Centres from the management index
Required privilege: AdminInstitutions
The Collecting Centre List
The list shows all collecting centres in the format "Code - Name". Use the filter box to search. Click a centre to select it and view its details on the right.
Creating a New Collecting Centre
- Click Add New
- Fill in the four tabs:
Basic Details Tab
| Field | Description |
|---|---|
| Name | Full name of the collecting centre |
| Printing Name | Name used on bills and reports |
| Institution Code | Bill prefix for this centre |
| Code | Short code — click the refresh icon to auto-generate |
| Description | Optional notes |
| Route | The delivery route for this centre — select from dropdown |
| Lab Institution | The main institution that receives this centre's samples — type to search |
| Lab Department | The receiving department within that institution (auto-filtered by institution) |
| Account No | Bank account number |
Pricing Tab
| Field | Description |
|---|---|
| Percentage | Commission percentage — the share of fees the collecting centre earns |
| Payment Method | How the centre pays (e.g. cash, credit) |
| Select Fee List | The named fee list applied to this centre's bills |
| Current Balance | Outstanding balance (editable only by developers) |
| Standard Credit Limit | The normal maximum credit |
| Allowed Credit Limit | The current effective credit limit |
| Max Credit Limit | The absolute maximum credit allowed |
Contact Details Tab
| Field | Description |
|---|---|
| Contact Number | Phone number |
| Email Address | Email address |
| Owner Name | Name of the CC owner/manager |
| Address | Physical address |
| Web | Website |
Metadata Tab
| Field | Description |
|---|---|
| Active | Toggle — deactivate the CC without deleting it |
| Creator | Who created this record |
| Created At | When it was created |
- Click Save
Bulk Upload of Collecting Centres
For importing many CCs at once, use the bulk upload feature from the collecting centre upload page (collecting_centre_upload.xhtml). Prepare a spreadsheet with the required columns and upload it.
Collecting Centre Fees
Collecting centres can be assigned their own fee schedule, separate from regular department fees. See Collecting Centre Fees for how to configure CC-specific pricing.
Technical Notes (Admin/Developer)
Collecting centres are stored as Institution entities with type CollectingCentre. The collectingCentreController handles CRUD. The percentage field is the CC's commission share. The feeListType links to a FeeListType entity that groups a set of fee overrides. Credit limit fields control outstanding balances — exceeded limits may be flagged during billing.