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.

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#
- Log into your SmartERP instance at
https://smarterp.et/odoo. - Open the main App Switcher (grid icon in the top-left corner).
- 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 Expression | Evaluated 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#
- Non-Repudiation: Captures signatory IP address, authenticated user identity, GPS coordinates (if mobile), and timestamp.
- Document Tamper-Proofing: Any subsequent modification to the PDF breaks the cryptographic hash, invalidating the signature.
- 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 slipsLetters: 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 / Exception | Probable Root Cause | Corrective Action / Resolution |
|---|---|---|
Signature Block: Missing executive stamp clearance | Letter cannot be dispatched without authorized cryptographic stamp. | Submit letter to Executive Office for digital signing. |
Calendar Error: Invalid Ethiopian date conversion | Specified 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 TIN | External institutional recipient lacks complete corporate profile. | Create or update recipient partner master record before dispatching. |