SmartERP Documentation An Ashewa Technology Solutions Platform

Manage CRM pipeline stages and lead scoring

Configure visual Kanban stages, automated lead assignment rules, AI lead scoring, and activity scheduling.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Manage CRM pipeline stages and lead scoring within SmartERP.

Swimlane lead-to-cash workflow diagram from CRM capture to quotation, credit check, order confirmation, and invoice payment.
Commercial lead-to-cash operational and fulfillment lifecycle.

CRM Opportunity Pipeline and Deal Stages

This guide explains how sales teams manage and convert opportunities using the SmartERP visual CRM pipeline.

CRM Pipeline Kanban

2. Prerequisites & Security Access Groups#

  • Required Modules: sale_management, crm, point_of_sale, smarterp_payment_telebirr
  • Security Groups:
    • Sales User (Technical ID: sales_team.group_sale_salesman)
    • Sales Administrator (Technical ID: sales_team.group_sale_manager)
    • POS User / Cashier (Technical ID: point_of_sale.group_pos_user)
  • Master Data Dependencies: Customer partner registry, selling pricelists, product inventory balances, payment providers (Telebirr/CBE Birr), and POS terminal sessions.

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 CRM → Leads / Pipeline.

CRM Opportunity Pipeline and Deal Stages

Step 2: Operational Data Parameters & Controls#

Ensure all mandatory parameters comply with enterprise operational standards:

  • Authorized Operator: Action executed under assigned RBAC permissions (Sales Representative, Business Development Lead).
  • Relational Integrity: Linked to upstream customer, product, inventory lot, or manufacturing order.
  • Statutory & Quality Controls: Verified against Ethiopian commercial and tax regulations or technical engineering specifications.

Step 3: Operational Execution & State Progression#

  • State Progression Gate: Advance record from Draft through Confirmed to Completed / Posted.
  • Integrated System Impact: Automatically updates inventory stock quants, customer receivables, or work-in-progress cost accounting ledgers.
  • Audit Verification: System registers tamper-evident audit records logging user ID, timestamp, and cryptographic transaction digests.

Procedure#

  1. Open CRM → Sales → My Pipeline.
  2. Opportunities appear in Kanban stages:
    • New: Inbound leads from website, Telebirr portal, or trade exhibitions.
    • Qualified: Budget confirmed, decision maker identified, requirements logged.
    • Proposition: Formal quotation or tender response submitted.
    • Negotiation: Terms, payment methods, and delivery schedules under review.
    • Won: Order confirmed and contract signed.
  3. To advance a deal, drag the opportunity card to the next column.
  4. Click on a card to view deal details:
    • Schedule phone calls, site visits, or follow-up meetings in Activities.
    • Review AI lead score and conversion probability computed by smarterp_crm_ai.

Automated Lead Assignment#

SmartERP routes leads automatically based on territory and product lines:

  • Leads originating from Addis Ababa retail inquiries route to the Retail Commercial Team.
  • Leads originating from government or enterprise tenders route to the Corporate Sourcing Team.

4. Advanced Configuration Points#

  • Automated Actions & Scheduled Tasks (Crons):
    • CRM: Lead auto-assignment (crm.ir_cron_lead_assign): Runs hourly to allocate unassigned leads across sales teams
    • Sales: Expire overdue quotations (sale.ir_cron_expire_quotes): Runs nightly to mark stale quotes as cancelled
    • POS: Close abandoned register sessions (point_of_sale.ir_cron_session_cleanup): Runs nightly to alert managers of open cashier terminals
  • Custom Print Templates & Reports:
    • Customer Sales Quotation / Pro-forma Invoice
    • Commercial Tax Invoice (Model 85 Compliant)
    • POS Cash Register Receipt with QR Validation
    • Customer Credit Limit & Receivables Aging Statement
  • 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
Credit Limit Blocked: Customer balance exceeds ceilingOutstanding customer debt plus current order exceeds approved credit limit.Obtain credit committee exception approval or collect an advance cash payment.
Validation Error: Tax definition missing on product lineProduct item lacks default statutory 15% VAT mapping.Update the product master accounting tab with standard statutory VAT rates.
POS Session Error: Cash register mismatch upon closurePhysical cash count does not reconcile with POS recorded register balance.Document discrepancy explanation in the closing wizard and submit for manager review.
Payment Gateway Error: Telebirr timeoutNetwork timeout or invalid API bridge credentials.Verify merchant credentials in Invoicing → Configuration → Payment Providers and retry transaction query.

Next#

Last updated: 2026-11-15