User guide
SmartPOS Pro Documentation
Everything you need to set up your shop, run billing, manage stock, and read reports.
Introduction
SmartPOS Pro is a point of sale (POS) system for retail and small business. It includes billing, purchases, inventory, expenses, reports, and shop settings in a single web application.
This guide is written for daily use. Follow it to set up your shop, run billing, track stock, and check reports.
Quick Start (5 Minutes)
New user? Follow these steps first:
- Register your shop account and verify your email.
- Go to Settings and set shop name, phone, currency, and receipt format.
- Add a few products in Product → New Product.
- Open Sale → POS, add items, and complete your first sale.
Getting Started
After login, use the left sidebar to move between modules. Menus and actions depend on your role permissions.
Most used actions
Sale → POSPurchase → New PurchaseProduct → New ProductReport → Profit & LossRecommended setup order
- Open Settings and complete shop profile, regional options, and receipt format.
- Add Categories, Units, and Brands under Product (if you use them).
- Create Products with buying price, selling price, and opening stock.
- Add Customers and Suppliers if you track them.
- Configure Payment Methods under Settings.
- Start selling from POS.
Sidebar menu
| Menu | What it does |
|---|---|
| Dashboard | Overview of sales, purchases, stock, and expenses |
| Sale | POS, all sales, sales returns, draft sales |
| Purchase | Record stock purchases from suppliers |
| Product | Products, categories, units, brands, variations |
| Stock | Stock movement history and manual adjustments |
| Contact | Customers and suppliers |
| Expense | Business expenses and categories |
| Report | Sales, purchase, stock, expense, and profit/loss reports |
| Settings | Shop profile, regional, sales, payment methods, email, receipt |
| Users & Roles | Staff accounts and permissions |
| Profile | Your name, email, avatar, and password |
Login & registration
- Register — Creates a new shop and owner account. Email verification is required before login.
- Login — Sign in with email and password after verification.
- Forgot password — Request a reset link from the login page (requires email settings and queue worker).
POS & Sales
The POS screen is used for customer billing at the counter.
Make a sale
- Open Sale → POS.
- Search products by name or scan a barcode in the search box.
- Click a product to add it to the cart. For products with variations, pick the variation first.
- Optionally select a Customer or leave as walk-in.
- Adjust quantity, apply a discount if needed, and choose payment method.
- Click Complete Sale.
- Review the invoice preview, then click Print Invoice or New Sale.
Draft sales
Save an incomplete cart as a draft from POS using Save Draft. Open saved drafts from Drafts on the POS page or from Sale → Draft Sale.
All sales
View completed sales under Sale → All Sales. You can:
- Open sale details
- Print invoice
- Collect due payment
- Process returns
- Delete a sale (if permitted)
Sales returns
Go to Sale → Sales Returns to view return history or create a new return from an existing sale.
Purchases
Record stock bought from suppliers.
Add a purchase
- Open Purchase → New Purchase.
- Select a Supplier (or add one from Contact → Supplier).
- Search and add products with quantity and unit cost.
- Apply discount if needed and enter paid amount.
- Save the purchase.
- Print the purchase receipt from the success screen.
View and manage past purchases under Purchase → All Purchases. You can add payments for due amounts and print invoices from the detail view.
Products & Stock
Products
Create products under Product → New Product. Set:
- Name, SKU, barcode
- Category, brand, unit
- Buying price and selling price
- Opening stock (for new items)
- Variations (size, color, etc.) if applicable
Catalog setup
Organize products using:
- Categories — product groups
- Units — pcs, kg, box, etc.
- Brands — manufacturer or brand name
- Variations — reusable variation types (e.g. Size: S, M, L)
Stock
- Movements — automatic log when sales, purchases, returns, or adjustments change stock
- Adjustment — manually increase or decrease stock (damage, found items, corrections)
Customers & Suppliers
Customers
Add customers under Contact → Customer. Link a customer at POS to track who bought items. Customer phone and address appear on invoices when set.
Suppliers
Add suppliers under Contact → Supplier. Select a supplier when recording purchases.
Expenses
Track business spending outside of inventory purchases.
- Create expense categories under Expense → Categories (rent, utilities, salary, etc.).
- Add expenses from Expense → Add Expense.
- View all expenses under Expense → All Expenses.
Reports
All reports support a date range filter. Most reports can be printed, exported to CSV, or Excel.
| Report | Use for |
|---|---|
| Sales Report | Daily or monthly sales totals and line items |
| Purchase Report | Supplier purchases over a period |
| Stock Report | Current stock levels and values |
| Movement Report | Every stock in/out transaction |
| Expense Report | Business expenses by category |
| Profit & Loss | Revenue vs cost summary |
Settings & Receipts
Open Settings from the sidebar. Update these tabs once before regular use:
| Tab | Purpose |
|---|---|
| Profile | Shop name, phone, address, email |
| Regional | Country, currency, timezone, date format |
| Sales | Invoice prefix, draft prefix, default payment method |
| Payment Methods | Cash, card, mobile banking, and custom methods |
| Email Templates | Customize password reset and notification emails |
| Receipt | Print format and receipt footer message |
Receipt print formats
| Format | Best for |
|---|---|
| 58mm Thermal | Small Bluetooth/USB receipt printers |
| 80mm Thermal | Standard POS thermal printers (most common) |
| A5 | Half-page invoice on office printer |
| A4 | Full-page invoice for accounts and filing |
| Letter (US) | US letter-size office printers |
Choose your format under Settings → Receipt. The live preview updates as you change options. Thermal formats print a compact receipt; A4/A5/Letter use a detailed invoice layout.
Set a custom Receipt footer message (e.g. "Thank you for your purchase!") shown at the bottom of invoices.
Users & Roles
Each shop has its own roles and staff users. Permissions control which menu items and actions each person can access.
Default roles
| Role | Description |
|---|---|
| Owner | Full access. Assigned to the shop creator. Cannot be deleted. |
| Manager | Daily operations without user management. |
| Cashier | POS, sales, product viewing, and contacts. |
| Viewer | Read-only access to dashboard, sales, purchases, products, stock, expenses, and reports. |
Add staff
- Open Users & Roles from the sidebar.
- On the Users tab, click Add User.
- Enter name, email, password, and assign a role.
- The staff member logs in with their own email and password.
Custom roles
On the Roles tab, click Create Role to define permissions for your team. System roles (Owner, Manager, Cashier, Viewer) can be edited but not deleted.