Mass Activation

Overview

Mass Activation allows you to activate or renew multiple subscribers at once with a single click. Instead of activating subscribers one by one, you can select hundreds or thousands of subscribers and activate them all together in bulk. This is extremely useful for monthly renewals, promotional campaigns, or reactivating expired subscribers.

WHAT IS MASS ACTIVATION?

Mass Activation is bulk processing that:

Activates Multiple Subscribers - Process hundreds at once
Same Package for All - Or keep their current packages
Smart Payment Logic - Auto-detects subscriber balance
Error Handling - Skips failed subscribers, continues with others
Transaction Safety - Each subscriber processed atomically

Perfect for: Monthly renewals, bulk reactivations, promotional campaigns!

How Mass Activation Works

The Complete Flow

1. Select Subscribers → 2. Choose Package → 3. Select Payment Type → 
4. System Validates Each → 5. Process Activations → 6. Generate Report

Key Features

✅ Bulk Processing

Activate 10, 100, or 1000+ subscribers at once
Each subscriber processed independently
Failed subscribers don't stop the process

✅ Smart Payment Detection

Auto-checks subscriber balance
Falls back to invoice if insufficient
No manual intervention needed

✅ Error Handling

Skips subscribers that fail validation
Logs detailed error messages
Continues with remaining subscribers

✅ Transaction Safety

Each subscriber in separate transaction
All-or-nothing for each subscriber
No partial activations

Payment Types

Mass Activation offers 2 payment types that determine how invoices are paid:

1. Direct Billing (Payment Type 1)

What It Is:

Creates DUE invoices for all subscribers
Salesperson/reseller balance is deducted
Subscribers pay later in cash/mobile money
Invoice remains unpaid until subscriber pays

When to Use:

Monthly renewals where subscribers pay cash
Field collection by staff
Postpaid billing model
When subscribers don't have prepaid balance

How It Works:

1. System creates invoice for subscriber
2. Salesperson balance is cut (cost price)
3. Invoice status = DUE
4. Subscriber pays later (cash/mobile money)
5. When paid, invoice status = PAID

Example:

Package Price: 1000 BDT
Salesperson Cost: 900 BDT
Salesperson Profit: 100 BDT

Process:
- Invoice created: 1000 BDT (DUE)
- Salesperson balance cut: -900 BDT
- Salesperson profit: +100 BDT (in cash later)
- Subscriber owes: 1000 BDT

2. Smart Billing (Payment Type 2)

What It Is:

Intelligent payment detection
Checks subscriber balance first
If balance sufficient → Pays from balance (PAID invoice)
If balance insufficient → Creates DUE invoice (like Direct Billing)

When to Use:

Mixed subscriber base (some prepaid, some postpaid)
Want to auto-collect from subscribers with balance
Reduce manual collection work
Maximize automation

How It Works:

For Each Subscriber:
1. Check subscriber balance
2. IF balance ≥ invoice amount:
   → Pay from balance (invoice PAID)
   → Salesperson gets profit in balance
3. IF balance < invoice amount:
   → Create DUE invoice
   → Cut salesperson balance
   → Salesperson gets profit in cash later

Example 1: Subscriber Has Balance

Subscriber Balance: 1500 BDT
Invoice Amount: 1000 BDT

Process:
- Subscriber balance: 1500 - 1000 = 500 BDT
- Invoice status: PAID
- Salesperson profit: +100 BDT (added to balance)
- No cash collection needed

Example 2: Subscriber Has Insufficient Balance

Subscriber Balance: 300 BDT
Invoice Amount: 1000 BDT

Process:
- Balance insufficient (300 < 1000)
- Falls back to Direct Billing
- Invoice status: DUE
- Salesperson balance cut: -900 BDT
- Subscriber owes: 1000 BDT

Direct vs Smart Billing

Comparison Table

Feature	Direct Billing	Smart Billing
Invoice Status	Always DUE	PAID if balance, else DUE
Subscriber Balance	Not checked	Checked first
Salesperson Balance	Always cut	Cut only if subscriber has no balance
Salesperson Profit	In cash later	In balance if paid, cash if DUE
Cash Collection	Required for all	Only for insufficient balance
Best For	Postpaid model	Mixed prepaid/postpaid
Automation	Manual collection	Auto-collection when possible

When to Use Each

Use Direct Billing When:

✅ All subscribers are postpaid
✅ Field staff collects cash
✅ You want consistent DUE invoices
✅ Subscribers don't maintain prepaid balance

Use Smart Billing When:

✅ Mixed subscriber base
✅ Some subscribers have prepaid balance
✅ Want to maximize automation
✅ Reduce manual collection work
✅ Prefer auto-deduction when possible

Accounting Logic

How Money Flows

Direct Billing Flow

Step 1: Invoice Creation

Invoice Amount: 1000 BDT
Status: DUE
Subscriber Owes: 1000 BDT

Step 2: Salesperson Balance Cut

Salesperson Balance Before: 50,000 BDT
Package Cost: 900 BDT
Salesperson Balance After: 49,100 BDT

Step 3: Profit Recording

Salesperson Profit: 100 BDT
Profit Type: Cash (to be received)
Balance Change: No (profit in cash, not balance)

Step 4: Later - Subscriber Pays

Subscriber pays 1000 BDT in cash
Invoice Status: DUE → PAID
Salesperson receives: 1000 BDT cash
Salesperson keeps profit: 100 BDT
Salesperson pays upstream: 900 BDT

Smart Billing Flow (With Balance)

Step 1: Balance Check

Subscriber Balance: 1500 BDT
Invoice Amount: 1000 BDT
Result: ✅ Sufficient

Step 2: Payment from Balance

Subscriber Balance Before: 1500 BDT
Invoice Amount: 1000 BDT
Subscriber Balance After: 500 BDT
Invoice Status: PAID

Step 3: Salesperson Profit Added

Salesperson Balance Before: 50,000 BDT
Salesperson Profit: 100 BDT
Salesperson Balance After: 50,100 BDT
Balance Change: Yes (profit added to balance)

No Cash Collection Needed!

Smart Billing Flow (Without Balance)

Step 1: Balance Check

Subscriber Balance: 300 BDT
Invoice Amount: 1000 BDT
Result: ❌ Insufficient

Step 2: Fallback to Direct Billing

Same as Direct Billing:
- Invoice Status: DUE
- Salesperson balance cut: -900 BDT
- Profit in cash later: 100 BDT
- Subscriber owes: 1000 BDT

Discount Handling

Critical Rule: Discount is absorbed from salesperson's profit, NOT from upstream cost.

Example:

Package Price: 1000 BDT
Salesperson Cost: 900 BDT
Salesperson Profit: 100 BDT
Subscriber Discount: 50 BDT

Calculation:
- Subscriber Pays: 1000 - 50 = 950 BDT
- Salesperson Cost: 900 BDT (unchanged)
- Salesperson Profit: 100 - 50 = 50 BDT

Admin vs Reseller:

Admin (Profile Type 1):

Cuts NET amount (what subscriber pays)
Absorbs discount from own profit
No upstream payment

Reseller (Profile Type 3+):

Cuts FULL amount (must pay upstream)
Discount comes from their profit
Must pay parent reseller full cost

Staff Balance Limit

If Staff Has Balance Deduction Enabled:

How It Works:

Staff Balance Limit: 10,000 BDT
Package Cost: 900 BDT

Process:
1. Check: 10,000 ≥ 900 ✅
2. Activate subscriber
3. Deduct: 10,000 - 900 = 9,100 BDT
4. New Limit: 9,100 BDT

If Insufficient:

Staff Balance Limit: 500 BDT
Package Cost: 900 BDT

Result: ❌ Error
Message: "Insufficient Staff Accounting Balance"
Subscriber: Skipped

Validation Rules

Mass Activation validates each subscriber before activation. If validation fails, that subscriber is skipped and logged.