OneBill POS: Enterprise Point of Sale & Smart Inventory Management

1. Executive Summary & System Architecture

In today's retail and wholesale commerce, businesses can no longer afford fragmented software stacks. Disconnected checkout counters, manual stock counts, inaccurate batch tracking, and sluggish billing terminals cause revenue leakage, customer dissatisfaction, and reconciliation nightmares.

OneBill POS is an all-in-one commercial operating system. Built on an enterprise-grade web architecture, OneBill unites high-speed cashier checkout, granular batch and variation inventory control, multi-warehouse stock logistics, supplier procurement (PO & GRN), customer credit ledger accounting, automated SMS notifications, and executive BI analytics into one unified, intuitive platform.

Whether powering a busy single-terminal retail store or a distributed network of wholesale warehouses, OneBill delivers the speed, transaction atomicity, and operational visibility needed to scale modern commercial enterprise.

Core Capabilities Matrix

2. Supply Chain & Transaction Pipeline

OneBill connects vendors, warehouse logistics, front-of-house checkout lanes, and financial accounting through strict transactional isolation. Inbound purchase orders generate verified stock inflows that flow into central or branch warehouses, allocate to active POS terminals, and immediately sync with customer digital portals.

Automated ESC/POS Thermal Print & Digital Bill

In retail environments, printing speed is everything. OneBill communicates directly with 80mm and 58mm thermal printers via raw ESC/POS commands, eliminating printer dialogue prompts and rendering slips in under 20ms:

3. FIFO Batch Management & Matrix Variations

Unlike generic inventory counters that only track gross SKU numbers, OneBill executes strict First-In First-Out (FIFO) queue depletion. When a product is rung up at the register, the system dynamically deducts from the oldest active batch first, accurately preserving historical cost of goods sold (COGS) and safeguarding gross profit reporting:

• Matrix Variation Engine: Supports multi-dimensional matrix attributes—such as Size × Color × Fabric for apparel, or Storage × RAM × Grade for consumer electronics.
• Immutable Batch Cost Tracking: Every inbound Goods Received Note stamps a unique batch identifier, purchase price, wholesale threshold, and expiration date.
• Batch Expiry Alerts: Early warning indicators flag batches approaching their expiration date (configurable 30/60/90-day intervals) to prompt promotional clearance before loss.
• CSV Price Synchronization: Export batches to CSV, modify wholesale and retail margins in bulk, and re-import with cryptographic physical stock locking.

4. Multi-Warehouse Routing & Inter-Branch Transfers

For multi-branch chains, retail enterprises, and distributor networks, OneBill structures inventory across multiple physical and logical warehouses:

• Cashier Physical Scoping: Cashiers are bound to their assigned terminal warehouse. A cashier at the Colombo branch cannot inadvertently bill stock allocated to the Kandy warehouse.
• Transfer Orders (TR-YYYYMMDD-XXXX): Inter-branch stock transfers follow a rigorous 4-stage lifecycle: Draft → In-Transit (Locked) → Received & Verified → Reconciled.
• Transit State Protection: While stock is en route between warehouses, it is locked in an immutable transit pool, eliminating phantom double-counting.

5. Customer Debt Ledger & Public Bill Portal

In wholesale and neighborhood retail, customer credit is standard practice. OneBill transforms credit risk into an auditable competitive advantage:

• Dual Customer Modeling: Frictionless walk-in cashiers handle fast consumer lines, while registered customer profiles maintain credit limits, payment terms, and lifetime transaction histories.
• Credit Sales & Partial Settlements: Bills can be marked as partial cash, with the remainder auto-debited to the customer's credit ledger. Cashiers can collect ad-hoc debt repayments at any terminal.
• Self-Service Digital Bill Portal (/my-bills/{id}): Registered customers receive a private web URL to inspect itemized receipts, review lifetime balance statements, and verify warranty dates directly from their smartphones.

6. Automated Event-Driven SMS Notification Engine

OneBill integrates directly with commercial SMS gateways (including Dialog, Mobitel, Twilio, and Textlocal) to trigger automated transactional SMS notifications:

• Instant Sale Receipts: When a sale settles, the customer immediately receives an SMS with their bill total, balance due, and direct shortlink to their digital receipt.
• Payment Acknowledgments: Debt repayments trigger an instant SMS confirmation showing the amount credited and remaining balance.
• Automated Debt Reminders: Management can trigger 1-click friendly debt reminders to customers with overdue balances.
• Delivery Audit Trail: Every outbound message is logged in an immutable SMS audit table with timestamps, gateway delivery status, and recipient MSISDN.

7. Executive KPI Dashboard & Report Modules

Real-time operational dashboards provide business owners and financial controllers with actionable commercial metrics without waiting for end-of-month book closing:

8. Enterprise Governance, Spatie RBAC & Security

OneBill implements enterprise-grade role-based access control (RBAC) via the industry-standard Spatie Laravel Permission architecture:

• Granular 25+ Permission Modules: Define custom roles such as Cashier, Store Supervisor, Procurement Officer, Inventory Auditor, and Super Admin.
• Cashier Physical Lock: Restricts cashiers to billing only within their assigned physical store or warehouse.
• Immutable Activity Audit Log: Every price override, stock adjustment, transfer approval, and cashier refund is indelibly stamped with user ID, IP address, and previous values.
• Two-Factor & OAuth Authentication: Google OAuth single sign-on (SSO) with optional Google reCAPTCHA v2/v3 protection on public checkout and bill portals.

9. Architectural Comparison