Sales, CRM and POS overview
Architectural and operational foundation of SmartERP commercial operations, customer relationships, credit governance, retail checkout, and digital payment gateways.
1. Overview & Business Value#
This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Sales, CRM and POS overview within SmartERP.
This page provides the operational and architectural foundation of SmartERP Sales, CRM, and Point of Sale (POS). It is written for Commercial Directors, Sales Managers, Account Executives, POS Supervisors, Cashiers, and Credit Controllers.
SmartERP Commercial Suite integrates pipeline opportunity tracking, customer master dossiers, automated credit limit governance, quotation workflows, Ethiopian fiscal VAT invoicing, multi-lane retail point of sale, and national digital FinTech payment rails (Telebirr and Chapa).
[sales-lead-to-cash-workflow]
{screenshot:overview-overview-dashboard}
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 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 Sales app icon.
- From the top navigation bar, open Sales β Orders β Quotations / Orders; Point of Sale β Dashboard.
{screenshot:overview-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:
- Customer Name (Mandatory): Registered partner record with complete invoicing and delivery addresses
- Product Lines (Mandatory): Saleable items with approved commercial pricelist rates and VAT classification
- Payment Terms (Mandatory): Immediate settlement, milestone advance, or agreed commercial credit terms
- Salesperson (Mandatory): Account executive responsible for the customer commercial relationship
- Configure optional operational parameters and localized tags as required:
- Analytic Account (Optional): Revenue center or project allocation for commercial tracking
- Customer PO Reference (Optional): External purchase order number issued by the client
- Shipping Policy (Optional): Deliver all products at once or allow partial dispatches
- Click the Save icon in the control bar to commit the record.
{screenshot:overview-record-creation-form}
Step 3: Validating and Processing Transactions#
- State Transitions: Execute operational state progression (Quotation β Sent β Confirmed Sales Order β Delivery Done β Invoiced β Paid).
- Ledger & System Impact: Generates customer tax invoice, posts accounts receivable debit and sales revenue credit, and updates inventory valuation upon delivery.
- Audit Verification: Automated recording of author ID, timestamp, and immutable revision history.
{screenshot:overview-transaction-processing-state}
Core Capabilities#
| Functional Area | Key Capabilities | Primary User Roles |
|---|---|---|
| CRM & Lead Pipeline | Visual Kanban stages, lead scoring (smarterp_crm_ai), automated routing, activity scheduling, opportunity win probability. | Sales Representative, Sales Manager |
| Customer Master Dossier | TIN validation, VAT registration certificate status, Category A/B tax classification, withholding agent flag. | Credit Officer, Sales Representative |
| Pricelists & Quotations | Multi-tier volume discounts, margin guardrails, proforma invoices, digital contract e-signatures (smarterp_sign_sale). | Account Executive, Sales Manager |
| Credit Limit Control | Credit ceiling enforcement, overdue invoice blocking, automated credit exposure computation, executive override governance. | Credit Controller, Finance Director |
| Fulfillment & Reservations | Automated inventory stock reservation upon order confirmation, delivery order scheduling, dropshipping triggers. | Warehouse Dispatcher, Logistics Officer |
| Fiscal VAT Invoicing | Statutory Ethiopian 15% VAT invoice generation (Form 3.10), buyer/seller TIN printing, 2% withholding receivable tracking. | Billing Clerk, Accountant |
| Point of Sale (POS) | Daily register sessions, physical cash denomination counts, GS1 barcode scanning, split tenders, Z-Report session closing. | Cashier, POS Supervisor |
| FinTech Digital Payments | Real-time dynamic Telebirr SuperApp C2B/B2B QR codes, automated webhook settlement, Chapa e-commerce gateway. | Cashier, Customer |
Statutory Commercial Compliance Baseline#
SmartERP Sales operations comply with Ethiopian commercial and tax regulations:
- 15% Value Added Tax (VAT): Automated calculation across taxable goods and services; generates statutory VAT sales registers and monthly declaration schedules for the Ministry of Revenues (MOR).
- 2% Withholding Tax (WHT) Receivable: Automatically flags withholding agent clients, deducts 2% WHT at billing or settlement, and tracks Withholding Voucher (WHV) certificate claims.
- Tax Identification Numbers (TIN): Mandatory 10-digit TIN validation on all B2B invoices exceeding statutory commercial thresholds.
- Fiscal Cash Register Integration: Supports interface with fiscal printer devices (MRC) and electronic fiscal receipts.
Commercial Lifecycle#
Every sales engagement follows an auditable 6-stage lifecycle:
[sales-data-model]
- Lead Qualification (
crm.lead): Inbound inquiries are scored, enriched with company data, and assigned to sales specialists. - Quotation & Proposal (
sale.order): Product pricing, delivery lead times, and terms are structured into a formal quotation or proforma invoice. - Credit Verification (
base_accounting_kit): The system verifies total customer exposure (open AR + pending orders) against the approved credit limit. - Order Confirmation & Reservation (
stock.picking): Order confirmation reserves inventory in the warehouse and schedules delivery. - Fiscal Invoicing (
account.move): Delivery triggers statutory 15% VAT sales invoice with buyer/seller TINs. - Payment Settlement (
pos.session/payment_telebirr): Cash, bank transfer, or Telebirr payment settles the receivable and posts to the General Ledger.
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 teamsSales: Expire overdue quotations(sale.ir_cron_expire_quotes): Runs nightly to mark stale quotes as cancelledPOS: 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 / Exception | Probable Root Cause | Corrective Action / Resolution |
|---|---|---|
Credit Limit Blocked: Customer balance exceeds ceiling | Outstanding 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 line | Product 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 closure | Physical 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 timeout | Network timeout or invalid API bridge credentials. | Verify merchant credentials in Invoicing β Configuration β Payment Providers and retry transaction query. |
Next#
- Understand commercial concepts: Concepts and commercial governance.
- Walk through a complete order: Quick start.
- Manage your sales pipeline: Manage CRM pipeline stages and lead scoring.