SmartERP Documentation An Ashewa Technology Solutions Platform

Property Operational Concepts and Leasing Principles

Core concepts of property management including unit classification, gross vs net leases, utility apportionment mathematics, and IFRS 16 revenue recognition.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Property Operational Concepts and Leasing Principles within SmartERP.

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

Understanding the operational and accounting framework of SmartERP Property Management ensures consistent revenue recognition and statutory compliance across property portfolios.

Property Asset Hierarchy#

SmartERP structures real estate assets into a four-tier parent-child hierarchy:

  1. Property Estate / Complex (property.property): Represents the legal land holding, title deed, or urban land lease parcel (e.g., Ashewa Commercial Center, Bole Road).
  2. Building / Block (property.building): The physical structural asset containing common infrastructure (elevators, central HVAC, backup generators, water reservoirs).
  3. Floor / Zone (property.floor): Administrative floor level dividing mechanical rooms, common lobbies, and rentable spaces.
  4. Rental Unit (property.unit): The primary rentable entity (e.g., Office 402, Retail Shop G-12, Penthouse Apt 14B) with defined Gross Leasable Area (GLA) in square meters ($m^2$).

Commercial Lease Structures#

SmartERP supports two primary commercial leasing paradigms:

  • Triple Net Lease (NNN): Tenant pays baseline unit rent plus pro-rata share of property operating expenses, building insurance, and municipal land taxes.
  • Gross Modified Lease: Baseline rental includes standard operational services, with variable utilities (electricity, water, HVAC) billed separately based on dedicated submeter consumption logs.

Utility Apportionment Mathematics#

When common area utilities (central chiller power, standby generator diesel, water pump pressurization) cannot be metered to an individual tenant, SmartERP computes Common Area Maintenance (CAM) charges using the Gross Leasable Area ratio:

$$\text{CAM Share}i = \text{Total Common Cost} \times \left( \frac{\text{Unit GLA}_i}{\sum{j=1}^{N} \text{Building GLA}_j} \right)$$

This mathematical allocation guarantees 100% cost recovery without manual spreadsheet calculations.

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