Appearance
Uganda Health Starter Pack
The Uganda starter pack provides an operational baseline for clinics and health centres. It is inspired by OpenMRS/UgandaEMR-style facility workflows, but it stays aligned with Pinkapple ERP primitives for parties, stock, billing, payments, GL, reporting, and integrations.
The pack is not a national clinical terminology dictionary. Clinical concepts, value sets, forms, order sets, lab menus, medication dictionaries, and reporting concepts should be imported or activated from source-backed terminology such as OCL, CIEL/OpenMRS, LOINC, RxNorm, ICD, SNOMED CT, UCUM, national HMIS sources, or approved facility collections.
What The Pack Provides
| Seed area | Examples |
|---|---|
| Facility starter profiles | Clinic Basic, Health Centre II, Health Centre III/IV. |
| Payer templates | Self Pay, Private Insurance, Employer/Corporate Scheme, Donor/Program Funding. |
| Coverage defaults | Cash, outpatient insurance, corporate credit, and program cover templates. |
| Visit-charge defaults | OPD registration, consultation, lab collection, pharmacy dispensing, imaging, theatre/procedure, admission, discharge, and inpatient bed-night/hour. |
| Pricing starter profile | Uganda Health Standard Tariff with shared Pricing item targets, including the generic sale-price line for stock-backed items. |
| Operational item catalog | ERP-side services and goods that can be sold, stocked, billed, or linked to Health profiles after terminology review. |
| Stock item catalog | Stock-managed medicines and supplies with batch/expiry-ready inventory setup where applicable. |
Clinical concepts and forms are not treated as automatically active Uganda seed content. Import or activate them through Clinical Terminology -> Import Review and Binding Assistant before using them in patient care.
Recommended Expansion Areas
The starter pack is intentionally safe and compact. Health administrators should expand clinical content from authoritative terminology sources before using the system as a full national-program or hospital-grade dictionary.
| Area | Add locally before production use |
|---|---|
| OPD | Local visit types, triage categories, common diagnoses, referral reasons, disposition codes, and common procedure notes. |
| ANC and MCH | Local ANC visit schedule, danger-sign checklist, birth plan fields, immunization schedule, nutrition indicators, and referrals. |
| HIV and TB | Program enrolment fields, regimen tracking, follow-up schedule, adherence questions, TB/HIV linkage fields, and reporting codes. |
| Laboratory | Facility test menu, specimen types, reference ranges, critical limits, analyser mappings, turnaround targets, and result panels. |
| Pharmacy | Formulary, dose forms, strengths, route and frequency value sets, controlled-drug rules, interaction warnings, and stock items. |
| Imaging/procedures | Modality list, body region value sets, consent requirements, contrast/implant/consumable mappings, and report templates. |
| Claims and reporting | Payer-specific benefit rules, pre-authorization requirements, claim codes, HMIS indicators, and export mappings. |
Use the OCL-style repository model for this expansion. Import or curate content into a source, publish a collection version, and then bind the approved concepts to forms, order sets, service profiles, Billing items, stock items, and reports. Do not recreate UgandaEMR, KenyaEMR, CIEL, LOINC, RxNorm, ICD, SNOMED CT, or national HMIS concepts as local-only clinical authority.
Applying The Pack
- Open Healthcare -> Setup -> Operating Model.
- Review Starter Profiles.
- Choose the appropriate Uganda profile for the facility level.
- Apply the profile for the active Health service and branch.
- Review the generated or available payers, coverage templates, charge defaults, operational items, stock items, and pricing targets.
- Bind local billing items, pricing profiles, stock items, departments, rooms, and cashier workflows.
The pack is a starter catalog, not a complete national dictionary. A facility should import and activate the remaining concepts, drugs, lab tests, imaging services, procedures, HMIS forms, order sets, payer contracts, and tariffs it actually uses.
Facility Profiles
| Profile | Best fit |
|---|---|
| Uganda Clinic Basic | Outpatient clinic with registration, consultation, basic lab ordering, medication dispensing, and cash or insurance billing. |
| Uganda Health Centre II | Health-centre front door with OPD, triage, basic medication dispensing, ANC starter forms, and cashier billing templates. |
| Uganda Health Centre III/IV | Larger health centre with OPD, ANC, lab, pharmacy, inpatient bed-night billing, claims, HMIS, and interoperability readiness. |
Required Tenant Binding
Starter records are not enough on their own. Before active facility use, bind:
- clinical order-set lines to actual lab, medication, imaging, or procedure profiles
- medication profiles to operational items, stock items, units, batches, and prices
- lab/imaging/procedure profiles to billing items and pricing rules
- visit-charge defaults to Billing items and invoice policy
- visit-charge defaults to approved pricing profiles or pricing profile items
- payer templates to actual payer parties and contracts
- cashier points to tills, POS registers, payment channels, and settlement rules
- wards, beds, rooms, labs, pharmacy counters, and theatres to operational locations and resources
Localizing For Multiple Facilities
A tenant with many clinics or health centres should keep one governed terminology collection, then scope operational setup per facility.
| Setup item | Shared or facility-specific |
|---|---|
| Concepts and value sets | Usually shared across the tenant so reports and patient charts remain comparable. |
| Clinical forms | Source-backed and shared where clinical policy is the same; create facility variants only when workflow or reporting differs. |
| Order sets | Source-backed clinical intent, with facility-specific service-profile, stock, pricing, and worklist bindings. |
| Tariffs and fees | Facility, payer, and effective-date specific through Pricing and Billing. |
| Stock and batches | Facility and location specific through Inventory. |
| Cashier points | Facility specific through POS/Teller registers, tills, business days, payment channels, and settlement setup. |
| Wards and rooms | Facility specific through operational locations and resource capacity. |
Clinical Content To Import
Use source-backed terminology import for clinical content such as:
| Area | Typical content to import or activate |
|---|---|
| OPD | Triage vitals, pregnancy status, consultation history, assessment, diagnosis, treatment plan, disposition, and fever order sets. |
| ANC | Gravidity, parity, LMP, gestational age, fundal height, fetal heart rate, danger signs, and first-visit lab order sets. |
| HIV | Testing consent, entry point, rapid-test result, recent exposure, disclosure, ART referral, regimen, and program indicators. |
| TB | Cough duration, fever, night sweats, weight loss, TB contact history, sputum AFB, Xpert MTB/RIF, and TB/HIV linkage concepts. |
| Child health | Immunization, vitamin A, deworming, malaria RDT, ORS, zinc, paracetamol, amoxicillin, and nutrition concepts. |
After import, use Binding Assistant to connect approved clinical concepts to operational items, stock items, Health profiles, Billing items, pricing targets, chart widgets, reports, claims, and interoperability mappings.
Cashier And Credit Handling
Use Billing or POS for collection depending on local workflow.
| Scenario | Recommended flow |
|---|---|
| Patient pays before service | Billing invoice and receipt, or POS counter sale where the transaction is retail-like. |
| Patient pays after consultation | Health visit-charge traces -> Billing invoice -> receipt or allocation. |
| Pharmacy cash sale | POS for counter-led sale, Health dispense for clinical safety, Inventory for stock movement. |
| Insurance service | Coverage and pre-authorization in Health, invoice in Billing, claim and remittance in Health, payment settlement in Payments. |
| Corporate credit | Payer coverage and credit context in Health, receivable and statements in Billing. |
| Inpatient bed-night | Health admission/discharge context plus recurring or scheduled Billing charge source. |
Uganda Readiness Checklist
- Health service is active and shown as Health Services.
- Healthcare permission profile is assigned to the service.
- Branches and departments are configured as business units and operational locations.
- Patients are individual parties with Health patient profile and identifiers.
- Providers are parties with credentials and optional linked users.
- Uganda starter profile is applied.
- Required clinical concepts, forms, value sets, and order sets are source-backed, reviewed, and published.
- Orderable services are bound to local Health profiles, operational items, stock items, billing items, and prices.
- Cashier and payment channels are configured.
- Claims, payer, coverage, and credit workflows are reviewed before live insurance billing.