SmartERP Documentation An Ashewa Technology Solutions Platform

Clinical Concepts & Ethiopian Healthcare Standards

In-depth explanation of core clinical concepts, medical record numbering, triage protocols, and statutory compliance in Ethiopia.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Clinical Concepts & Ethiopian Healthcare Standards within SmartERP.

Healthcare OPD and IPD Admission, Discharge, and Transfer (ADT) operational swimlane workflow.
SmartERP Healthcare Outpatient (OPD) and Inpatient (IPD) clinical workflow lifecycle.

In-depth explanation of core clinical concepts, medical record numbering, triage protocols, and statutory compliance in Ethiopia.

2. Prerequisites & Security Access Groups#

  • Required Modules: smarterp_healthcare, smarterp_clinical_core, smarterp_pharmacy
  • Security Groups:
    • Healthcare Receptionist (Technical ID: smarterp_healthcare.group_medical_receptionist)
    • Physician / Attending Doctor (Technical ID: smarterp_healthcare.group_medical_doctor)
    • Pharmacy Dispenser (Technical ID: smarterp_healthcare.group_medical_pharmacist)
  • Master Data Dependencies: Patient master registry (Medical Record Number - MRN), EFDA drug formulary, Ethiopian Ministry of Health (MoH) HMIS disease codes, and EHIS insurance tariffs.

3. Step-by-Step Configuration & Execution#

Step 1: Navigating to the Interface#

  1. Log into your SmartERP instance at https://smarterp.et/odoo.
  2. Open the main App Switcher (grid icon in the top-left corner).
  3. Navigate to Hospital → Patient Management → OPD / IPD.

Step 2: Operational Data Parameters & Controls#

Ensure all mandatory parameters comply with enterprise operational standards:

  • Authorized Operator: Action executed under assigned RBAC permissions (Chief Medical Officer, Clinical Nurse, Receptionist, Pharmacist).
  • Relational Integrity: Linked to upstream master records, approval requests, or transactional ledgers.
  • Statutory & Quality Controls: Verified against Ethiopian statutory regulations and corporate governance standards.

Step 3: Operational Execution & State Progression#

  • State Progression Gate: Advance record from Draft through Audited to Confirmed / Certified.
  • Integrated System Impact: Automatically updates real-time operational states and posts financial/inventory journal moves.
  • Audit Verification: System registers tamper-evident audit records logging user ID, timestamp, and cryptographic transaction digests.

Medical Record Number (MRN) Taxonomy#

The Medical Record Number (MRN) serves as the persistent, unique master key for every patient across their lifetime interactions with the healthcare facility. SmartERP generates MRNs following a standardized sequence format:

$$\text{MRN} = \text{FACILITY_CODE} - \text{YEAR} - \text{SEQUENTIAL_ID}$$

For example, BLH-2026-004812 uniquely identifies a patient registered at Black Lion Hospital in the year 2026. This identifier persists across outpatient visits, emergency trauma admissions, inpatient surgeries, and laboratory testing.

Five-Level Triage Acuity Categorization#

SmartERP adapts the South African Triage Scale (SATS) and WHO Emergency Triage Assessment and Treatment (ETAT) guidelines calibrated for Ethiopian emergency rooms:

  1. Red (Resuscitation - Immediate): Life-threatening emergencies requiring instant intervention (e.g., cardiac arrest, airway obstruction, severe shock).
  2. Orange (Very Urgent - within 10 minutes): Critical conditions with physiological instability (e.g., severe dyspnea, acute chest pain, altered mental state).
  3. Yellow (Urgent - within 60 minutes): Serious illnesses with stable vital signs requiring timely investigation (e.g., open fractures, severe abdominal colic).
  4. Green (Standard OPD - within 120 minutes): Mild illnesses and routine ambulatory cases (e.g., mild fever, superficial abrasions, routine medication refills).
  5. Blue (Non-Urgent / Administrative): Minor complaints, administrative consultations, or deceased on arrival.

Integrated Diagnostics and Pharmacy Ecosystem#

The electronic consultation interface drives diagnostic testing and pharmaceutical fulfillment directly without manual paper slips:

Electronic Medical Record (EMR) integrated laboratory and pharmacy fulfillment lifecycle with EFDA FEFO batch tracking.
Integrated clinical encounter, diagnostic laboratory, and pharmacy dispensing workflow.

EFDA FEFO Dispensing Rules#

Under Ethiopian Food and Drug Authority directives, pharmacies must ensure zero expired medications reach patients:

$$\text{Dispense Priority} = \min(\text{Expiry Date}) \quad \text{subject to} \quad \text{Expiry Date} > \text{Today}$$

When a physician prescribes a medication, SmartERP automatically reserves inventory from the warehouse lot having the earliest expiration date. If a lot is within 60 days of expiry, the system triggers a quarantine notification to the pharmacy manager and blocks automatic allocation unless manually overridden by a licensed chief pharmacist.

EHIS Community-Based Health Insurance (CBHI) Architecture#

The Ethiopian Health Insurance Service (EHIS) mandates strict verification and billing structures for enrolled citizens:

  • Kebele & Household Registry: Every patient claiming CBHI coverage must present their active household passbook stamped by their local Woreda Health Insurance Scheme office.
  • Benefit Packages: Essential health service packages (EHSP) cover outpatient consultations, essential diagnostics, and national generic medications at 100% reimbursement.
  • Exclusion Lists: High-cost elective procedures, cosmetic interventions, and proprietary brand medications not on the national drug list require patient co-payment or full out-of-pocket settlement.

4. Advanced Configuration Points#

  • Automated Actions & Scheduled Tasks (Crons):
    • Healthcare: Generate daily MoH HMIS aggregate tally (smarterp_healthcare.ir_cron_hmis_sync): Runs daily at 23:00 to prepare DHIS2 health data summaries
    • Pharmacy: Flag expiring EFDA medicine batches (smarterp_healthcare.ir_cron_fefo_expiry): Runs daily at 06:00 to alert dispensers of lots expiring within 60 days
  • Custom Print Templates & Reports:
    • Official Patient Encounter Summary & Medical Certificate
    • Electronic Prescription Order Form (Model 19 Compliant)
    • Ethiopian Health Insurance Service (EHIS) Claim Dossier
    • Daily MoH Outpatient / Inpatient Morbidity Tally Sheet
  • Multi-Company Rules: Record-level security isolation under Company 1 (Ashewa Technology Solutions S.C.), preventing cross-company ledger leakage across parent and subsidiary legal entities.

5. Comprehensive Troubleshooting Matrix#

Error Symptom / ExceptionProbable Root CauseCorrective Action / Resolution
Access Block: Confidential clinical diagnosis restrictedUser is not listed as the patient's attending physician or authorized consultant.Request explicit clinical consultation delegation from the department head.
Credit Ceiling Block: Corporate insurance expiredPatient corporate insurance policy limit exceeded or expired.Switch billing mode to private cash settlement or upload pre-authorization approval from the insurer.
FEFO Allocation Error: Expired medicine batch blockedDispenser selected medicine lot past statutory EFDA expiry date.Isolate expired lot to quarantine storage and dispense compliant active lot.
Last updated: 2026-11-15