SmartERP Documentation An Ashewa Technology Solutions Platform

Templates, organizational stamps, and electronic signatures

Bilingual letter templates, dynamic Jinja/QWeb placeholders, authorized organizational stamps, and PKI electronic signature execution.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Templates, organizational stamps, and electronic signatures 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 Letter & Correspondence Management eliminates repetitive manual formatting and ensures visual brand integrity through centralized letter templates, cryptographically protected organizational stamps, and legally binding electronic signatures.

2. Prerequisites & Security Access Groups#

  • Required Modules: smarterp_letter, smarterp_correspondence
  • Security Groups:
    • Letter Registry Clerk (Technical ID: smarterp_letter.group_letter_clerk)
    • Executive Reviewer (Technical ID: smarterp_letter.group_letter_reviewer)
    • Director General (Technical ID: smarterp_letter.group_letter_executive)
  • Master Data Dependencies: Dual calendar templates (Ethiopian & Gregorian), official stamp repository, letter reference numbering formats, and departmental dispatch routes.

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.

Bilingual letter templates#

Templates (smarterp.letter.template) allow organizations to standardize correspondence layouts across departments. Each template supports English, Amharic, or bilingual side-by-side presentation.

Dynamic placeholder variables#

Templates support dynamic evaluation of letter, counterparty, and company attributes:

Variable ExpressionEvaluated Value
${object.reference_number}Official allocated reference number (e.g. ATS/CORP/OUT/2026/00142)
${object.subject}Subject line in English or Amharic
${object.date}Gregorian date formatted according to user locale
${object.ethiopian_date_str}Ethiopian calendar date string (e.g. ጥቅምት 05 ቀን 2019 ዓ.ም)
${object.recipient_partner_id.name}Recipient organization or primary contact name
${object.recipient_partner_id.street}Recipient physical address
${object.signatory_employee_id.name}Authorized signatory full name
${object.signatory_title}Signatory official institutional title
${object.company_id.name}Originating company / entity name

Authorized organizational stamps#

In Ethiopian corporate and public institutional practice, an official letter is incomplete without an authorized organizational seal (የድርጅቱ ማህተም). SmartERP provides a secure digital stamp registry (smarterp.letter.stamp) that balances visual authenticity with cryptographic security:

  • Role-Based Stamp Protection: Stamps are restricted to authorized registry officers, department heads, or legal custodians.
  • PIN / Password Authentication: High-security executive seals can require an authorization PIN code before they can be affixed to an approved letter.
  • Watermarking & Audit Tracking: When a stamp is applied to a PDF, the system embeds an invisible cryptographic watermark, the user ID of the officer who affixed it, and the exact timestamp.
  • Visual Positioning: Placed seamlessly over the signatory block or letter footer using coordinate-based canvas positioning (ReportLab).

Electronic signatures and legal compliance#

Through deep integration with SmartERP Sign (smarterp_sign), outgoing letters and executive memos can be electronically signed with full legal validity under the Ethiopian Electronic Signature Proclamation No. 1072/2018:

flowchart LR
    A[Letter Approved] --> B[Generate Standard PDF]
    B --> C[Create SmartERP Sign Request]
    C --> D[Signatory Receives Secure Link / PIN]
    D --> E[Signatory Signs with Touch / Certificate]
    E --> F[Generate Audit Evidence Certificate]
    F --> G[Seal PDF with SHA-256 Digest]
    G --> H[Final Document Saved to DMS]

Signature security features#

  1. Non-Repudiation: Captures signatory IP address, authenticated user identity, GPS coordinates (if mobile), and timestamp.
  2. Document Tamper-Proofing: Any subsequent modification to the PDF breaks the cryptographic hash, invalidating the signature.
  3. Audit Certificate: Every signed letter generates an embedded Evidence Summary Certificate detailing the exact signing sequence, authorized parties, and public key digests.

4. Advanced Configuration Points#

  • Automated Actions & Scheduled Tasks (Crons):
    • Letters: Check dispatch delivery receipt status (smarterp_letter.ir_cron_dispatch_check): Runs daily to verify courier delivery confirmation slips
    • Letters: Follow-up on pending memorandum actions (smarterp_letter.ir_cron_followup): Runs weekly to alert assigned officers of pending correspondence replies
  • Custom Print Templates & Reports:
    • Official Letterhead Dispatch Copy with QR Verification
    • Institutional Letter Inward/Outward Registry 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
Signature Block: Missing executive stamp clearanceLetter cannot be dispatched without authorized cryptographic stamp.Submit letter to Executive Office for digital signing.
Calendar Error: Invalid Ethiopian date conversionSpecified Ethiopian calendar date does not match leap year rules (Pagume 5/6).Use the automated calendar picker to ensure synchronized EC/GC conversion.
Unregistered Recipient: Partner profile missing TINExternal institutional recipient lacks complete corporate profile.Create or update recipient partner master record before dispatching.
Last updated: 2026-11-15