SmartERP Documentation An Ashewa Technology Solutions Platform

Medical Store Operations: Model 19 GRN & Model 20 SIV

Manage hospital central medical warehouse receipts using Model 19 GRN and clinical department issues using Model 20 SIV.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Medical Store Operations: Model 19 GRN & Model 20 SIV within SmartERP.

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

Manage hospital central medical warehouse receipts using Model 19 GRN and clinical department issues using Model 20 SIV.

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.

Ethiopian Public Property Administration Framework#

Hospital pharmacies and medical warehouses in Ethiopia must comply with statutory property vouchers:

  • Model 19 (Goods Receiving Note - GRN): Formal document proving physical delivery and quality acceptance of pharmaceuticals, surgical consumables, and reagents from suppliers or the Ethiopian Pharmaceuticals Supply Service (EPSS).
  • Model 20 (Store Issue Voucher - SIV): Authorization document transferring pharmaceuticals and supplies from the central warehouse to hospital wards, operating theatres, laboratories, and outpatient dispensaries.

Receiving Medical Supplies via Model 19 GRN#

  1. Navigate to Inventory > Operations > Receipts and select the Purchase Order.
  2. Verify delivery physical documentation (Supplier Invoice, EPSS Delivery Note, Certificate of Analysis [CoA]).
  3. Enter batch parameters per line item:
    • Lot / Batch Number
    • Manufacturing Date and Expiry Date
    • EFDA Registration License Number
    • Storage Condition Verification: Confirm cold-chain temperature logger readings ($2^\circ C - 8^\circ C$ for vaccines and insulin).
  4. Click Validate.
  5. Click Print Model 19 Voucher:
    • The system generates the standard Ethiopian Model 19 voucher containing item descriptions, batch numbers, unit costs, and receiving storekeeper signatures.

Issuing Supplies to Clinical Departments via Model 20 SIV#

  1. Clinical wards submit electronic Departmental Material Requisitions (PR) for surgical gloves, gauze, syringes, and IV fluids.
  2. In Inventory > Operations > Internal Transfers, review the approved requisition.
  3. Pick stock from central warehouse locations using FEFO rules.
  4. Click Validate Transfer.
  5. Click Print Model 20 SIV Voucher:
    • The Model 20 voucher prints with sequential numbering, specifying issuing warehouse, receiving clinical unit, quantities issued, unit valuations, and issuing/receiving officer sign-offs.
    • The general ledger immediately posts:
      • Debit: Inpatient Ward Consumables Expense (610200)
      • Credit: Central Medical Supplies Inventory (120100)

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