📶 electronics

SIM Activations

SIM Activations logs every new SIM card you activate for a customer — which operator, which plan, the SIM/ICCID number — and separately tracks whether the operator's activation commission owed to you has actually been received.

📍 Menu path: /electronics/telecom

👤 Who uses it: Owner,Manager,Staff

Overview

Every activation records the customer's name and phone, the Operator (Jio/Airtel/Vi/BSNL/Other), an optional Plan Name and Plan Value, the SIM/ICCID number, and the Activation Date.

Two independent statuses are tracked per record: an activation Status (Pending/Activated/Failed/Cancelled) for the SIM itself, and a separate Commission Status (Pending/Received/Rejected) for the payout the operator owes your shop for the activation.

Four summary tiles at the top give an instant read on volume and money: Total Activations, Activated count, Commission Received (sum of all RECEIVED commission amounts) and Commission Pending (sum of all still-PENDING commission amounts).

Filter pills (All/Pending/Activated/Failed/Cancelled) and a search box (by name, phone, operator or SIM number) narrow the table quickly on a busy counter.

Before You Start

No setup required — this is a standalone ledger not linked to Products, Customers or Billing.
Have the customer's name and phone, plus the SIM/ICCID number, ready when recording a new activation (both name and phone are required fields).

Step-by-Step Guide

1 Record a new SIM activation

Click Record Activation.
Enter Customer Name and Phone (both required), choose the Operator (Jio/Airtel/Vi/BSNL/Other), and optionally the Plan Name and Plan Value.
Enter the SIM / ICCID Number (19 or 20 digits) and the Activation Date.
Enter the Commission Amount you expect from the operator for this activation and leave Commission Status as Pending until it is actually paid out.
Click Save — the record starts with activation Status Pending.

2 Update activation and commission status

Click the edit (pencil) icon on a row — editing reveals a Status dropdown (Pending/Activated/Failed/Cancelled) that is hidden on first creation.
Move Status to Activated once the SIM is confirmed live on the network, or Failed/Cancelled if the activation did not go through.
Once the operator actually pays out the activation incentive, edit the record again and set Commission Status to Received (or Rejected if the operator denies the claim).

3 Monitor commission income

Check the Commission Received and Commission Pending tiles at the top for a running total of what has been paid versus what is still owed.
Use the Comm. Status column badge in the table (Pending/Received/Rejected) to spot which specific activations still need to be chased with the operator.

4 Search and clean up records

Use the search box to find an activation by customer name, phone, operator or SIM number.
Click the trash icon to permanently delete an activation record after a confirmation prompt.

Every Field & Button, Explained

Field / Button	What it does
`Record Activation`	Opens the form to log a new SIM activation.
`Total Activations / Activated / Commission Received / Commission Pending tiles`	Live counts and sums across all activation records — Received and Pending are summed only from records with that specific Commission Status.
`Status filter pills (All/Pending/Activated/Failed/Cancelled)`	Filters the table by activation status with a live count per pill.
`Search box`	Filters by customer name, phone, operator name or SIM number as you type.
`Customer Name * / Phone *`	Both required before the record can be saved.
`Operator *`	Jio / Airtel / Vi / BSNL / Other — shown as a color-coded badge in the table.
`Plan Name / Plan Value`	Optional description and price of the recharge plan sold alongside the SIM.
`SIM / ICCID Number`	The physical SIM card's ICCID, shown in monospace in the table.
`Activation Date`	The date the SIM went live.
`Status (edit mode only)`	Pending / Activated / Failed / Cancelled — only editable once a record already exists.
`Commission Amount`	The incentive amount you expect (or received) from the operator for this activation.
`Commission Status`	Pending / Received / Rejected — tracked independently of the SIM activation Status.
`Notes`	Free-text notes field.
`Edit (pencil icon)`	Reopens the form to update any field or advance status.
`Delete (trash icon)`	Permanently removes the record after confirmation.

Tips & Best Practices

Set the Commission Amount at the time of activation even if it hasn't been paid yet — the Pending tile is only useful if every activation's expected commission is recorded up front.
Reconcile Commission Status to Received as soon as the operator's payout batch arrives, so the Pending total always reflects genuinely outstanding money.
Use the operator badge colors (Jio blue, Airtel red, Vi violet, BSNL orange) to scan the table quickly when multiple operators are active at your counter.

Troubleshooting & FAQ

I can't save a new activation — it keeps saying phone is required.

Both Customer Name and Customer Phone are mandatory fields; the form blocks saving until both are filled in.

Where did the Status field go when I tried to add a new activation?

The Status dropdown (Pending/Activated/Failed/Cancelled) only shows up when editing an existing record — every new activation is created as Pending by default.

The Commission Received tile doesn't match what I was actually paid.

That tile only sums records whose Commission Status is explicitly set to Received — edit each activation and update its Commission Status once the operator confirms payment.

Can this page activate a SIM directly with the operator?

No — this is a manual record-keeping ledger for your own tracking; it does not connect to any operator API or activation portal.

🧑‍💻 Developer Notes

Source component(s):

frontend-app/pos-app-electronics/src/pages/electronics/TelecomActivationPage.jsx
frontend-app/packages/pos-react-lib/src/pages/electronics/TelecomActivationPage.jsx (actual implementation)

Backend endpoints used:

GET /electronics/telecom
POST /electronics/telecom
PUT /electronics/telecom/:id
DELETE /electronics/telecom/:id

Related tables (db-core repositories):

ElectronicsTelecomActivation

Feature flag key: billing

Thin re-export in pos-app-electronics; real component lives in shared pos-react-lib package. Commission Received/Pending summary tiles are computed client-side by filtering the full in-memory items array by `commissionStatus`, not via a separate aggregate API call. Mounted at `/electronics/telecom` behind `` with no minTier restriction.