SmartERP Documentation An Ashewa Technology Solutions Platform

AI OCR and structured field extraction

Optical Character Recognition, automated vendor bill extraction, Ethiopian Pagume calendar handling, and ETB financial normalization.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for AI OCR and structured field extraction within SmartERP.

Module map showing dependencies between SmartERP Supply Chain Core, Tenders, Store Vouchers, Landed Costs, and WMS.
SmartERP Supply Chain and Sourcing architectural module map.

SmartERP Documents Enterprise eliminates manual data entry from scanned invoices, receipts, and contracts via an integrated AI-powered OCR engine.

2. Prerequisites & Security Access Groups#

  • Required Modules: documents, smarterp_dms
  • Security Groups:
    • Documents User (Technical ID: documents.group_documents_user)
    • Documents Administrator (Technical ID: documents.group_documents_manager)
  • Master Data Dependencies: Workspace hierarchies, document tags, automated actions, OCR rule definitions, and retention policies.

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 Settings → Technical.

Step 2: Operational Data Parameters & Controls#

Ensure all mandatory parameters comply with enterprise operational standards:

  • Authorized Operator: Action executed under assigned RBAC permissions (System Administrator, Certified Specialist).
  • 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.

Optical character recognition pipeline#

flowchart LR
    A[Scanned PDF / JPEG] --> B[Image Preprocessing & Deskew]
    B --> C[Tesseract / Multimodal AI Engine]
    C --> D{Script Detection}
    D -->|Latin| E[English Text Extraction]
    D -->|Ethiopic| F[Ge'ez Fidel Extraction]
    E --> G[Regex & Semantic Entity Extractor]
    F --> G
    G --> H[Populate Vendor Bill / Partner / Tax Fields]

Ethiopian fiscal calendar & currency extraction#

Unlike standard global OCR engines, SmartERP Documents is specifically tuned for Ethiopian commercial documents:

  1. Pagume (ጳጉሜን) Calendar Support: Correctly recognizes the 13th month of the Ethiopian calendar (ጳጉሜን 1-6) without throwing invalid date errors.
  2. Dual-Calendar Date Conversion: Automatically maps Ethiopian dates printed on supplier receipts (e.g., ጳጉሜን 3 ቀን 2017 ዓ.ም) to Gregorian accounting dates (September 8, 2025).
  3. ETB Currency Normalization: Accurately recognizes Birr currency symbols (ETB, ብር, Br.) and parses standard Ethiopian number formats (e.g., 125,450.00 ብር).
  4. TIN & Tax Recognition: Extracts 10-digit Ethiopian Taxpayer Identification Numbers (TIN) and 15% VAT breakdown lines directly into the accounting invoice draft.

4. Advanced Configuration Points#

  • Automated Actions & Scheduled Tasks (Crons):
    • Documents: Run OCR field extraction (documents.ir_cron_ocr_process): Runs every 15 minutes to process incoming scanned document text
    • Documents: Archive expired records (documents.ir_cron_retention): Runs weekly to enforce statutory document retention schedules
  • Custom Print Templates & Reports:
    • Document Audit Trail & Access Log
    • Workspace Document Storage & Activity Ledger
  • 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 Rights Error: Workspace access restrictedUser lacks permissions for confidential legal or HR workspace.Request workspace access clearance from Documents Administrator.
OCR Extraction Failure: Low scan resolutionScanned image DPI is below minimum threshold for optical character recognition.Upload document at minimum 300 DPI resolution with clear contrast.
Upload Blocked: File size exceeds maximum limitFile exceeds system maximum attachment size.Compress file or upload via secure external cloud link.
Last updated: 2026-11-15