SmartERP Documentation An Ashewa Technology Solutions Platform

Tenant Self-Service Portal Guide

Operating guide for the SmartERP Tenant Portal, invoice viewing, digital payment execution, lease document downloads, and maintenance ticket logging.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Tenant Self-Service Portal Guide within SmartERP.

Relational data model connecting purchase orders, stock pickings, moves, quants, valuation layers, and landed costs.
SmartERP Supply Chain and Inventory relational schema.

The Tenant Self-Service Portal (https://smarterp.et/my/property) provides 24/7 self-service access to tenants, reducing administrative inquiry calls by over 70%.

Tenant Portal Features#

  1. Account Statement: Real-time ledger displaying all posted rent invoices, utility bills, and payment receipts.
  2. One-Click Payment: Settle outstanding invoices instantly using integrated Telebirr or CBE Birr checkout.
  3. Maintenance Ticket Desk: Submit maintenance requests with attached defect photos and track technician dispatch in real time.
  4. Lease Documents: Access certified copies of executed lease agreements, move-in inspection reports, and building house rules.

2. Prerequisites & Security Access Groups#

  • Required Modules: smarterp_property, account, stock, maintenance
  • Security Groups:
    • Property Officer (Technical ID: property.group_property_user)
    • Property Manager / Leasing Director (Technical ID: property.group_property_manager)
    • Real Estate Financial Controller (Technical ID: account.group_account_user)
  • Master Data Dependencies: Established legal entity profile for Company 1 (Ashewa Technology Solutions S.C.), registered properties, rental units, and verified partner tenant profiles (res.partner).

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 Property Management → Units / Leases.

Step 2: Operational Data Parameters & Controls#

Ensure all mandatory parameters comply with enterprise operational standards:

  • Authorized Operator: Action executed under assigned RBAC permissions (Property Manager, Leasing Agent, Facilities Supervisor).
  • 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.

4. Advanced Configuration Points#

  • Automated Actions & Scheduled Tasks (Crons):
    • Property: Generate recurring rent invoices (property.ir_cron_generate_rent_invoices): Runs nightly to generate upcoming month rent invoices.
    • Property: Check expiring leases and send renewal notices (property.ir_cron_lease_expiry_alert): Runs weekly to notify leasing officers 60 days prior to contract expiration.
    • Property: Compute submeter utility charges (property.ir_cron_utility_compute): Runs monthly following meter reading closeout.
  • Custom Print Templates & Reports:
    • Official Tenancy Agreement & Commercial Lease Contract
    • Monthly Rent & Utility Invoice with Telebirr QR Code
    • Move-In / Move-Out Inspection Handover Dossier
    • Property Building Net Operating Income (NOI) Financial Statement
  • Multi-Company Rules: Record-level security isolation under Company 1 (Ashewa Technology Solutions S.C.), preventing cross-company tenant ledger leakage across real estate subsidiaries.

5. Comprehensive Troubleshooting Matrix#

Error Symptom / ExceptionProbable Root CauseCorrective Action / Resolution
Access Rights Error: Cannot confirm Lease ContractUser lacks assigned Property Manager security privileges.Assign user to property.group_property_manager under Settings → Users.
Validation Error: Unit already occupied for selected periodSelected unit has an active overlapping lease contract.Select an available vacant unit or adjust effective commencement date.
Utility Apportionment Error: Sum of tenant percentages exceeds 100%Square meter leasable area calculation mismatch.Re-calculate Gross Leasable Area ratios in Building Unit configuration.
Payment Gateway Timeout: Telebirr rent settlement failedGateway callback timeout or invalid API bridge credentials.Verify merchant configuration in Invoicing → Payment Providers and retry transaction query.
Last updated: 2026-11-15