Sign Up, Verify & First Login
Create your account, verify your identity, choose a plan, and log in for the first time — all in under five minutes.
Creating Your Account
Open QuickPOS in your browser (it works on phones, tablets, and computers). You will see a welcome screen with two buttons: Sign Up and Log In. Tap Sign Up.
Choosing a Subscription Plan
Your account starts on a free trial with full access to all features. Before the trial ends, head to Billing & Subscription to pick a plan ranging from Starter to Premium.
Staff PIN Login
If you are a staff member (not the owner), your manager gives you a 4-digit PIN. On the login screen, choose Staff PIN Login, select the shop, and type your PIN.
Point of Sale — Making Sales
The POS screen is designed for speed: big buttons, one-tap adding, instant search, and audio feedback.
Finding Products
- Type to search: Matches against product name, barcode, SKU, or generic name instantly.
- Scan a barcode: Tap the 📷 button to use your device's camera.
- Browse categories: Use the chips at the top to filter grids quickly.
Cart & Checkout
Adjust quantities, apply discounts, choose payment, and close the sale.
Payment Methods
Receipts & Printing
Generate professional receipts in multiple sizes and share or print them instantly.
| Format | Best For | Details |
|---|---|---|
| 58mm Thermal | Small receipt printers | Compact layout for 58mm-wide thermal paper. |
| 80mm Thermal | Wider receipt printers | More room for item details. Common in bars. |
| A4 Invoice | Wholesale / B2B | Full-page invoice with logo and formal layout. |
Keyboard Shortcuts
For desktop cashiers, keyboard shortcuts dramatically speed up selling.
Inventory Management
Add products, track stock levels, categorize items, and keep your catalog organized.
Go to Inventory and tap + Add Item. Required fields are just product name and selling price. Recommended: cost price, stock quantity, and category.
The inventory page also displays your total valuation metrics — stock value, retail value, potential profit, and low-stock alerts.
Stock Movements & Losses
Track every unit that enters or leaves your store — including losses, breakages, and expired goods.
| Reason | When to Use |
|---|---|
| 💥 Damaged | Physically damaged — dropped, crushed |
| 🗑️ Wasted | Food/drink waste, preparation spillage |
| 🚨 Theft | Confirmed or suspected theft |
| ⏰ Expired | Past expiry date |
Customers & Debts
Keep a directory of customers, track who owes you, and record repayments.
When you sell on credit, the total is added to the customer's credit balance. On the customer list, a red badge shows each debtor's amount. You can open a profile and tap Record Payment to lower their balance.
Suppliers
Record the people and companies you buy stock from.
Add each supplier with contact details, opening balance, and notes. When you restock, connect the purchase to the supplier so QuickPOS can show what you owe, what you have paid, and the full purchase history.
Use supplier names consistently. This makes purchase reports, supplier ledgers, and stock-cost reviews much easier for the owner.
Expenses
Track the true cost of running the shop.
Record rent, salaries, transport, electricity, repairs, packaging, and other operating costs. These expenses deduct from gross profit so the owner can see the real net profit of the business.
| Expense Type | Example | Why It Matters |
|---|---|---|
| Fixed | Rent, salary, subscription | Shows your regular monthly business cost. |
| Variable | Transport, packaging, repairs | Explains why profit changes from week to week. |
| Stock-related | Loading, delivery, supplier fees | Helps you understand the real cost of goods. |
Staff Management
Add team members, assign roles, and control who can access what.
| Role | Access Level |
|---|---|
| Cashier | Make sales. Cannot see full reports or alter sensitive inventory settings unless allowed. |
| Manager | Inventory, reports, refunds, stock corrections, and conflict management. |
| Pharmacist | Pharmacy Handles controlled substances and medicine-specific records. |
| Shop Owner | Full access — settings, billing, Telegram connection, staff, and full reports. |
Shifts & Cash
Track the money each cashier handles.
Open a shift with starting cash. At closing time, enter the counted physical cash. QuickPOS compares expected cash with counted cash and highlights shortages or excess instantly.
Tabs & Held Orders
Keep active carts open for customers, tables, and pending orders.
Tap 📋 Hold instead of completing a sale to save the cart. This is useful for bars, restaurants, wholesalers, and customers who want to add more items before paying.
Name the tab clearly, for example Table 4 Hall, Outside Table 1, or the customer name. This prevents staff confusion during busy hours.
Dashboard
See your shop health quickly.
The dashboard shows sales, payment methods, top products, low-stock items, expired or expiring items, and shop value. Owners can use it to know what is moving, what is stuck, and what needs attention.
Reports & Analytics
Deep-dive into your numbers and understand performance.
- Sales Reports: Daily, weekly, monthly, and custom date summaries.
- Payment Reports: Cash, transfer, card, split payment, and debts.
- Inventory Reports: Low stock, out of stock, stock value, stock loss, and expiry reports.
- Staff Reports: Compare cashier sales, voids, refunds, and performance.
Audit Trail
Keep a permanent record of important actions.
QuickPOS records sensitive actions such as refunds, price edits, stock corrections, login activity, deleted items, and cash differences. This protects the owner and discourages internal abuse.
Offline Mode
QuickPOS is built to continue selling even when network is bad.
If internet drops, the app switches to local mode. You can still make sales, print receipts, reduce stock, add customers, and manage tabs on the device. Work is safely queued until the connection returns.
For best offline reliability, each cashier should log in once while online on the device they will use. After that, the device can open QuickPOS even during bad network periods.
Sync & Conflicts
Bring offline sales back online safely.
When internet returns, QuickPOS syncs queued sales and stock changes. If two devices changed the same stock while offline, managers can review the conflict and apply the safest correction.
Sync is designed to send changed records instead of forcing a full refresh every time. This reduces data usage and keeps the POS fast on phones and tablets.
Multi-Device Setup
Run QuickPOS on multiple tablets, phones, and computers.
Each allowed staff member can use their own device. Owners should create staff accounts instead of sharing one login, so every sale, refund, and stock correction is tied to the right person.
Telegram Alerts & Restock Bot
Receive important shop alerts and manage stock from Telegram.
QuickPOS supports a central Telegram bot controlled by the system admin. Shop owners do not need to create their own bot token. They simply connect their Telegram account from QuickPOS and start receiving shop notifications.
Low stock, out of stock, expired items, and items expiring soon.
Optional sale alerts, unusual stock activity, and daily summaries.
View stock lists and update quantities using guided Telegram buttons.
Owners with more than one shop can switch shop context before checking alerts.
How to connect Telegram
Go to Settings → Telegram Alerts as the shop owner or authorized manager.
QuickPOS opens the official Telegram bot using a secure one-time connection link.
Telegram sends your chat ID back through the webhook and QuickPOS saves it automatically.
Use Test Telegram to confirm that alerts can reach the correct phone.
Useful Telegram commands
| Command | What It Does |
|---|---|
| /stock | Shows out-of-stock items that need attention. |
| /lowstock | Shows items below your low-stock threshold. |
| /expired | Shows expired and soon-to-expire items for quick action. |
| /sales | Shows today's sales summary for the active shop. |
| /restock | Starts guided restocking. Select item, enter quantity, and confirm. |
| /shops | Switches active shop when the owner controls multiple shops. |
| /help | Lists available commands and quick actions. |
How Telegram restocking works
When you use /restock, the bot guides you to choose a product and enter the quantity added. QuickPOS updates inventory, records the action in the audit trail, and the POS receives the new stock during sync or live refresh.
QuickPOS is designed to avoid repeated noise. Low-stock and out-of-stock alerts are sent when the condition appears or changes. Expired item reminders can repeat daily until resolved.
The bot token is configured by the super admin only. Shop users connect with a secure Telegram link; they do not paste bot tokens. Owners can disconnect Telegram from settings at any time.
Billing & Plans
Manage your subscription and account limits.
The billing page shows your current plan, renewal status, and payment instructions. If your subscription expires, QuickPOS may still allow login while restricting business actions until payment is completed.
Settings
Configure the shop to match how you work.
Use settings to manage shop details, tax rates, receipt footer text, low-stock thresholds, business type, QR menu settings, Telegram alerts, staff permissions, and printing behavior.
Pharmacy Mode
Control medicine inventory with safer records.
Pharmacy Mode adds expiry tracking, shelf locations, NAFDAC fields, batch awareness, FEFO rotation, and stronger controls for sensitive products.
Bar & Restaurant Mode
Handle tables, tabs, kitchen items, and fast cashier switching.
Bar mode supports table-based tabs, waiter or cashier order handling, chef/kitchen items, claimable orders, service charge options, and fast switching between allowed staff on shared devices.
Wholesale Mode
Sell in cartons, crates, pieces, and volume tiers.
Wholesale Mode enables minimum quantity pricing, carton and piece conversion, crate-based sales, customer debt tracking, supplier purchases, and formal A4 invoices for business customers.
Troubleshooting
| Problem | What to Check |
|---|---|
| Telegram opens but does not connect | Press Start in the bot, then run Test Telegram. If it still fails, the admin should check the webhook. |
| No low-stock alert | Confirm the product threshold, Telegram connection, and whether the alert was already sent. |
| Offline sales not showing online | Open Sync status after internet returns and allow queued sales to complete. |
| Receipt not printing | Check printer pairing, paper size, browser permission, and the selected receipt format. |
| Items not updating on POS | Refresh live inventory signal or allow the next sync cycle to pull the changed item. |
Glossary
| Term | Definition |
|---|---|
| Cost-at-Sale | Records the cost of an item at the moment of sale to freeze profit calculations historically. |
| FEFO | First Expiry, First Out. |
| Idempotency Key | Prevents duplicate processing if a sync request is sent twice by poor networks. |
| PWA | Progressive Web App. |
| Telegram Webhook | The server connection that lets Telegram send bot messages and button actions back to QuickPOS instantly. |
| Low-Stock Threshold | The minimum quantity that triggers low-stock alerts and restock suggestions. |
You Are Ready
This manual covers QuickPOS from sign-up to offline sales, Telegram alerts, restocking, reports, and industry-specific modes. If you ever get stuck, the in-app dashboard alerts and troubleshooting section will guide you. Go run your business.