StoreCashierDocumentation Free 1.6.6 Pro 1.5.6 Apps 1.5.0

Mobile plans in the app PRO APP

For shops that sell SIM cards and carrier plans: the app records plan activations (new line, port-in, upgrade) when a plan product is sold, and takes plan payments (renewals) found by phone number — online and offline — exactly like the web POS. Needs StoreCashier Pro 1.5.4+ with the module Mobile Plans & Activations switched on (the module is included in every Pro package; it is off by default).

Where: the app → add a plan product (activation) · cart action Plan payment (renewal)

Before you start#

  • Switch on the module in Settings → Modules and set up carriers, plans and their POS products (Mobile Plans).
  • Permissions of the cashier: Mobile Plans view (to see anything), add (activations), edit (plan payments). Commission data is never shown in the app.
  • Module off or no permission: plan products are sold as normal products and there is no Plan payment button.
  • App version: activations and plan payments are recorded by POS apps 1.3.0 or later (also offline). Older app versions sell plan products as normal sales with an order note — record those activations in Mobile Plans → New Activation.

Record an activation#

Plan activation form: plan title, customer Alice Johnson with Change, phone number, SIM card number (ICCID), activation type, device IMEI, status after the sale, activation date, notes and PIN warning
Adding a plan product opens the activation form.
  1. Select the customer first (an activation needs a customer from Contacts — the walk-in customer does not count). You can also choose / change it in the form; New customer works online only.
  2. Add the plan product (tap or scan). It gets its own line (quantity 1) and the form opens.
  3. Fill the fields and Save details. Pay as usual.
FieldWhat it does
Plan titleCarrier — plan · cycle · price.
Customer (Change)The customer of the activation = the sale’s customer.
Phone number *The line’s number (digits required). One phone number once per cart.
SIM card number (ICCID)Required when the module setting “require ICCID” is on.
Activation typeNew line · Port-in · Upgrade (as allowed by the site).
Previous carrier * / Number being portedPort-in only. Empty “number being ported” = the phone number.
Device IMEI (optional)Suggests IMEIs of phones in the same cart; pre-filled when there is exactly one.
Status after the saleActive (activated in the carrier portal) or Pending (finish in the carrier portal later).
Activation dateDefault today.
NotesFree text. “Never write the customer’s account PIN or password here — StoreCashier does not store them.”

Pay is blocked while a plan line has no details or no customer (the form opens again). A plan that is no longer offered refuses new activations.

Cart with Smartphone X1 with IMEI and the plan line Activation: 01711 223344
The plan line shows “Activation: phone”. Tap it to edit the details.

Take a plan payment (renewal)#

Plan payment search results: three lines with phone, activation number, customer, plan, status, due date and Add payment buttons
Plan payment: search by phone number, activation number or customer.
  1. Tap Plan payment and type at least 2 characters: phone number, activation number (ACT-…), customer name or mobile.
  2. Online the site is searched (also lines not on the device): “Results from the site.” Offline the lines saved on the device are searched.
  3. Each row shows phone, activation number, customer, carrier / plan, status (Active, Suspended, Expired…) and the due date (overdue in red; “incl. payments waiting to sync” when the device already extended it).
  4. Add payment <price> adds a renewal line for one cycle. The line’s customer becomes the cart customer if none is chosen. The same line twice in one cart is refused.

After the sale#

Sale completed showing Activation no. ACT-000004 with phone and next due, and Plan payment ACT-000001 with next due
The done dialog and the receipt show the activation number and next due date.
  • The site creates the activation (ACT-…) linked to the order, or logs the renewal and extends the due date — with commission, history and notifications exactly like the web POS.
  • Receipt lines under the plan: “Activation no.: …” (“after sync” while queued) or “Plan payment: …”, “Phone: …”, “Next due: …” (“(provisional)” until synced).
  • Offline: the device extends the due date at once, so a second search already shows the new date; after upload the site’s date replaces it.
  • Two counters paid the same cycle offline: the sale is saved once, the renewal is not applied twice, and the sale is flagged renewal_conflict. The receipt says “Renewal not applied twice – the shop will check it”.
  • Invalid details on an offline sale: the line is sold as a normal product and flagged activation_failed / renewal_failed — “… not recorded yet – the shop will check it”.