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.
{screenshot:templates-stamps-and-signatures-overview-dashboard}
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 Module Interface#
- Log into your SmartERP instance at
https://smarterp.et/odoo. - Open the main App Switcher (grid icon in the top-left corner).
- Select the Correspondence app icon.
- From the top navigation bar, open Correspondence β Letters β Inbound / Outbound / Internal Memoranda.
{screenshot:templates-stamps-and-signatures-app-switcher-navigation}
Step 2: Creating and Parameterizing Records#
- Click the New button in the top-left control panel.
- Complete the mandatory fields in the record form:
- Letter Subject (Mandatory): Clear administrative or commercial subject heading
- Sender / Recipient Entity (Mandatory): External institution or internal department
- Dispatch Channel (Mandatory): Physical courier, hand delivery, or digital dispatch
- Dual Date (EC & GC) (Mandatory): Official Ethiopian calendar and Gregorian dates
- Configure optional operational parameters and localized tags as required:
- Digital Signature / Seal (Optional): Authorized executive cryptographic stamp
- Security Classification (Optional): Routine, Confidential, Secret, or Top Secret
- Related Prior Reference (Optional): Cross-referenced correspondence tracking ID
- Click the Save icon in the control bar to commit the record.
{screenshot:templates-stamps-and-signatures-record-creation-form}
Step 3: Validating and Processing Transactions#
- State Transitions: Execute operational state progression (Draft Memo β Editorial Review β Legal Clearance β Executive Signature & Stamp β Dispatched / Archived).
- Ledger & System Impact: Maintains immutable institutional correspondence registry with cryptographic QR validation for external party verification.
- Audit Verification: Automated recording of author ID, timestamp, and immutable revision history.
{screenshot:templates-stamps-and-signatures-transaction-processing-state}
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. |