SmartERP Documentation An Ashewa Technology Solutions Platform

Tuition billing, fee structures, and collections

Academic fee structures, installment billing, Telebirr and CBE bank integration, sibling discounts, and fee collection dashboards.

1. Overview & Business Value#

This comprehensive operational guide details the architecture, business workflows, configuration parameters, and execution steps for Tuition billing, fee structures, and collections within SmartERP.

Student admission, academic placement, fee settlement, and campus enrollment swimlane workflow.
SmartERP Education student admission and multi-campus enrollment lifecycle.

SmartERP School Finance (smarterp_school_finance) connects academic enrollment directly with native accounting (account.move), automating billing schedules and tracking receivables per student and guardian.

2. Prerequisites & Security Access Groups#

  • Required Modules: smarterp_school, smarterp_academic
  • Security Groups:
    • Teacher / Instructor (Technical ID: smarterp_school.group_school_teacher)
    • Academic Registrar (Technical ID: smarterp_school.group_school_registrar)
    • Principal / Headmaster (Technical ID: smarterp_school.group_school_manager)
  • Master Data Dependencies: Academic grade levels (Primary, Middle, Secondary), curriculum syllabus, examination schedules, fee structures, and guardian records.

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 School → Admissions.

Step 2: Operational Data Parameters & Controls#

Ensure all mandatory parameters comply with enterprise operational standards:

  • Authorized Operator: Action executed under assigned RBAC permissions (School Principal, Academic Secretary, Registrar).
  • 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.

Configurable fee structures#

Schools configure recurring and one-off fees per grade level and program:

  • Tuition Fees: Billed monthly, termly, or annually.
  • Ancillary Fees: Registration, laboratory, library, transport, cafeteria, and uniform fees.
  • Discounts & Concessions: Automatic sibling discounts (e.g., 10% for second child, 20% for third child), staff child waivers, and merit scholarships.

Installment invoicing and payments#

sequenceDiagram
    autonumber
    actor Finance as School Accountant
    participant FinanceMod as School Finance
    participant Acct as SmartERP Accounting
    actor Guardian as Student Guardian
    participant Telebirr as Telebirr / CBE
    
    Finance->>FinanceMod: Generate Term I Invoices (Batch by Grade)
    FinanceMod->>Acct: Create draft account.move per student sponsor
    Acct->>Guardian: Deliver invoice via Portal & SMS Payment Link
    Guardian->>Telebirr: Pay via Telebirr SuperApp / CBE Birr
    Telebirr->>Acct: Webhook payment confirmation (JSON-RPC)
    Acct->>Acct: Reconcile invoice & generate Cash Receipt Voucher (CRV)
    Acct->>Guardian: Send instant SMS receipt

Arrears and examination clearance#

  1. Overdue Tracking: Financial dashboards display aging balances per grade, section, and family sponsor.
  2. Examination Clearance Pass: The system can automatically withhold examination admit cards or online report card downloads for students with outstanding tuition arrears until finance clearance is approved.

4. Advanced Configuration Points#

  • Automated Actions & Scheduled Tasks (Crons):
    • School: Generate term grade report cards (smarterp_school.ir_cron_gradecards): Runs at the end of each term to compile student transcripts
    • School: Daily parent attendance notification via SMS (smarterp_school.ir_cron_attendance_sms): Runs daily at 09:30 to notify guardians of student absences
  • Custom Print Templates & Reports:
    • Official Student Report Card & Academic Transcript
    • Classroom Daily Attendance Register
    • Term Tuition Billing & Fee Collection 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 / ExceptionProbable Root CauseCorrective Action / Resolution
Grading Error: Assessment marks exceed maximum possible scoreEntered score is higher than configured assessment component maximum.Correct score to fall within valid range (e.g. 0 to 20 for mid-term test).
Section Assignment Error: Class capacity exceededTarget section has reached maximum allowable classroom pupil ratio.Allocate student to an alternative section or obtain Principal waiver.
Financial Hold: Outstanding fee balanceStudent examination entry card or portal view blocked by unpaid tuition.Settle balance via Telebirr or cash cashier receipt.
Last updated: 2026-11-15