Create supplier purchase
Record the supplier, destination, costs, attachment and purchase status before stock enters the business.
How MobiPOS runs the business.
This page shows how a mobile retail business can run its daily operations in MobiPOS: buying stock, registering IMEIs, moving devices between locations, selling to customers, managing agents and DSAs, handling repairs, tracking credit, and reviewing reports.
Journey 01
Complete foundation
Full Business Flow
Shows how MobiPOS controls the journey from supplier purchase to warehouse, branch, agent, customer sale, repair, audit trail and management reporting.
Business flow
Supplier
→
Purchase
→
Receiving
→
IMEI Intake
→
Warehouse
→
Transfer
→
POS/Agent
→
Customer
→
Reports
Open workflow ↗
Receive and validate stock
Confirm what arrived, flag supplier discrepancies and keep payables linked to the purchase.
Register IMEIs in batch
Use pasted scanner lines, CSV or Excel to create centralized serialized inventory records.
Move stock with custody
Transfer selected items to branches, POS locations, repair benches or agent custody without retyping IMEIs.
Sell, repair or report
Complete POS sales, repair tickets, commissions and owner reports while stock and activity history remain traceable.
78 serialized devices and 133 stock movements in the current demo dataset.
All critical inventory changes should produce audit and stock movement evidence.
Journey 02
Complete with OCR boundary
Purchasing And Stock Intake Journey
Controls how new products and serialized devices enter the business and become available stock.
Business flow
Supplier Order
→
Invoice Upload
→
Receive
→
Discrepancy Check
→
Batch IMEI Upload
→
Available Stock
Create purchase
Choose supplier, destination, purchase date, status and supporting document.
Extract document text
CSV, text and Excel documents can be extracted for review. Scanned PDFs/images are marked for manual review until OCR is connected.
Receive stock
Record received quantities and create discrepancy records when delivery differs from the order.
Upload IMEI batch
Paste lines or upload CSV/Excel to validate duplicates and register devices.
Real OCR for scanned supplier invoices is still pending.
Excel/CSV intake is implemented and covered by tests.
Journey 03
Complete foundation
Inventory, Transfer And Custody Journey
Keeps every phone traceable as it moves between warehouse, branch, POS, repair desk and field custody.
Business flow
Search Device
→
Select IMEIs
→
Dispatch
→
Receive
→
Resolve Difference
→
Update Custody
Search inventory
Find products or devices by IMEI, serial, SKU, barcode, model, status, branch or custodian.
Create transfer
Select source and destination, choose existing stock and dispatch it for receiving.
Allocate to agent
Move selected devices into agent custody with ownership history.
Resolve discrepancies
Review missing, excess or damaged transfer items through exception reports.
Manual IMEI re-entry should not be required during transfer selection.
Discrepancies require review instead of silent stock edits.
Journey 04
Workflow complete; live providers pending
POS, Payments And Credit Journey
Supports day-to-day selling, split payments, customer credit, receipts and session reconciliation.
Business flow
Open Session
→
Scan Item
→
Select IMEI
→
Choose Customer
→
Record Payment
→
Receipt
→
Reconcile
Open register
Cashier starts a session at an assigned POS location.
Build cart
Scan or type product, SKU, barcode, serial or IMEI. Serialized products require an available IMEI.
Record payment
Capture cash, M-Pesa reference, card, bank, credit or split payment.
Review sales
Managers and owners review sales, payment status, returns and outstanding balances.
M-Pesa is recordable today, but live Daraja confirmation is not connected.
Offline invoices are local drafts requiring online validation; production policy still needs a final decision.
Journey 05
Complete foundation
Agent And DSA Journey
Models field sales hierarchy, onboarding documents, stock allocation, recall and accountability.
Business flow
Register Agent
→
Upload ID
→
Approve
→
Register DSA
→
Allocate Stock
→
Sell/Return
→
Report
Create agent profile
Capture legal identity, phone, branch, supervising manager and verification status.
Upload ID documents
Attach national ID or onboarding documents for compliance and review from an agent profile.
Register DSA
Link DSA profiles under supervising agents where business policy permits.
Allocate and recall stock
Move selected devices into and out of agent custody with audit records.
Review network report
Owner checks agent/DSA stock, activity and accountability.
Direct camera capture is browser upload based, not a separate native scanning app.
Advanced productivity recommendations remain future work.
Journey 06
Complete foundation
After-Sales, Audit And Reporting Journey
Keeps repairs, returns, refunds, expenses, commissions and staff activity visible after the original sale.
Business flow
Return/Repair
→
Parts Usage
→
Refund/Commission
→
Expense
→
Audit Event
→
Owner Report
Create repair ticket
Track customer, device, warranty and repair status.
Record returns/refunds
Handle after-sales corrections without deleting completed sale history.
Approve/pay commissions
Review commission accruals and payout status.
Review activity
Owner checks logins, actions, privileged changes and suspicious activity.
Open operational reports
Use reports for stock, sales, aging, exceptions, IMEI history and agent visibility.
Completed operational records should be corrected through reversals and approvals, not deletion.
Sentry and production monitoring still require deployment configuration.
Role-based flows
Role mapped
Each staff member understands their journey.
The owner gets the widest business view, but each staff member has a focused workflow. This helps a company see how managers, inventory teams, cashiers, agents, DSAs and technicians work in one shared system.
Owner
Brian OtienoOwns the full business view: branches, money, stock risk, approvals, staff activity and growth decisions.
3 branchs8 locations42 audit events7 login events
Branch Manager
MaryControls branch execution: approvals, transfers, customer credit, cash discipline and exceptions.
8 transfers1 purchase discrepancy3 receivables
Inventory Officer
GraceMaintains inventory accuracy by receiving stock, uploading IMEIs, moving stock and correcting exceptions.
78 serialized units60 available units133 ledger movements
Cashier
KevinRuns the POS: opens a session, sells devices and accessories, records payments and reconciles cash.
27 sales27 payments17 sold devices
Field Agent
RennyReceives allocated devices, works with DSAs, completes field sales and remains accountable for custody.
1 agent1 agent custody location4 credit sales
Direct Sales Agent
FaithSupports field sales under an agent while the business keeps supervisor, customer and stock accountability.
1 DSA4 credit workflows12 commission records
Technician
DanielHandles warranty and repair tickets, uses parts from stock and updates repair outcomes.
7 repair tickets1 repair location1 after-sales return
Ready to explore the business flow.
Start with the journey cards, then sign in to open the workflows inside MobiPOS.