Version 5 · Complete Reference

QuickPOS User Manual

Everything you need to run your business — from your very first sale to advanced inventory, offline sync, pharmacy compliance, bar tabs, and wholesale pricing.

Updated May 2026 · ~13,000 words
Chapter 01

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.

1
Enter your details
Fill in your full name, email address, phone number, and a strong password. Aim for at least eight characters mixing uppercase, lowercase, and numbers.
2
Name your first shop
Enter a shop name and choose your business type: General Retail, Pharmacy, Bar / Restaurant, or Wholesale.
3
Submit and verify
Tap Create Account. A verification email is sent. Open it, click the link, and you are confirmed. Your free trial begins automatically.

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.

💡 Tip
If you have a coupon code, enter it on the billing page before you pay — it will reduce or waive your first payment.

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.

⚠️ Security
Never share your PIN. The owner can reset it from Staff Management if you forget it.
Chapter 03

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.
✅ Stock Validation
QuickPOS enforces real-time stock validation so you never oversell. In pharmacy mode, expired items are also completely blocked from the cart.
Chapter 04

Cart & Checkout

Adjust quantities, apply discounts, choose payment, and close the sale.

Payment Methods

1
Cash
Tap 💵 Cash, enter the amount tendered, and see the exact change to give back.
2
Transfer / Card
Records exact-amount payments instantly.
3
Credit (Buy Now, Pay Later)
Assign a customer first, then tap 📝 Credit. Adds total to their debt balance.
Chapter 05

Receipts & Printing

Generate professional receipts in multiple sizes and share or print them instantly.

FormatBest ForDetails
58mm ThermalSmall receipt printersCompact layout for 58mm-wide thermal paper.
80mm ThermalWider receipt printersMore room for item details. Common in bars.
A4 InvoiceWholesale / B2BFull-page invoice with logo and formal layout.
Chapter 06

Keyboard Shortcuts

For desktop cashiers, keyboard shortcuts dramatically speed up selling.

F1 or / Focus search bar
F2 Complete sale — Cash
F3 Complete sale — Transfer
F4 Complete sale — Card
F8 Repeat last sale
Esc Clear search & return
Chapter 07

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.

Chapter 08

Stock Movements & Losses

Track every unit that enters or leaves your store — including losses, breakages, and expired goods.

ReasonWhen to Use
💥 DamagedPhysically damaged — dropped, crushed
🗑️ WastedFood/drink waste, preparation spillage
🚨 TheftConfirmed or suspected theft
⏰ ExpiredPast expiry date
Chapter 09

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.

Chapter 10

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.

Clean records

Use supplier names consistently. This makes purchase reports, supplier ledgers, and stock-cost reviews much easier for the owner.

Chapter 11

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 TypeExampleWhy It Matters
FixedRent, salary, subscriptionShows your regular monthly business cost.
VariableTransport, packaging, repairsExplains why profit changes from week to week.
Stock-relatedLoading, delivery, supplier feesHelps you understand the real cost of goods.
Chapter 12

Staff Management

Add team members, assign roles, and control who can access what.

RoleAccess Level
CashierMake sales. Cannot see full reports or alter sensitive inventory settings unless allowed.
ManagerInventory, reports, refunds, stock corrections, and conflict management.
PharmacistPharmacy Handles controlled substances and medicine-specific records.
Shop OwnerFull access — settings, billing, Telegram connection, staff, and full reports.
Chapter 13

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.

Chapter 14

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.

Bar and restaurant use

Name the tab clearly, for example Table 4 Hall, Outside Table 1, or the customer name. This prevents staff confusion during busy hours.

Chapter 15

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.

Chapter 16

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.
Chapter 17

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.

Chapter 18

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.

First login matters

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.

Chapter 19

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.

Chapter 20

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.

Chapter 21

QR Menu & WhatsApp Orders

Let customers scan a code, browse your menu, and send orders quickly.

Enable QR Menu for restaurants, bars, lounges, and food businesses. Each QR code can carry the correct table or location, such as Table 4 Hall or Outside Table 1, so customers do not need to type it manually.

  • Create a menu from your inventory items.
  • Generate QR codes for tables, halls, or service areas.
  • Receive customer orders and load them into the cashier POS.
  • Checkout, print, and share the receipt after payment.
Chapter 22

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.

📉
Stock Alerts

Low stock, out of stock, expired items, and items expiring soon.

🧾
Sales Signals

Optional sale alerts, unusual stock activity, and daily summaries.

🔁
Restock Actions

View stock lists and update quantities using guided Telegram buttons.

🏪
Multi-Shop Support

Owners with more than one shop can switch shop context before checking alerts.

How to connect Telegram

1
Open Settings

Go to Settings → Telegram Alerts as the shop owner or authorized manager.

2
Tap Connect Telegram

QuickPOS opens the official Telegram bot using a secure one-time connection link.

3
Press Start in Telegram

Telegram sends your chat ID back through the webhook and QuickPOS saves it automatically.

4
Send a test alert

Use Test Telegram to confirm that alerts can reach the correct phone.

Useful Telegram commands

CommandWhat It Does
/stockShows out-of-stock items that need attention.
/lowstockShows items below your low-stock threshold.
/expiredShows expired and soon-to-expire items for quick action.
/salesShows today's sales summary for the active shop.
/restockStarts guided restocking. Select item, enter quantity, and confirm.
/shopsSwitches active shop when the owner controls multiple shops.
/helpLists 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.

No spam design

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.

Security

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.

Chapter 23

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.

Chapter 24

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.

Chapter 25

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.

Chapter 26

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.

Chapter 27

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.

Reference

Troubleshooting

ProblemWhat to Check
Telegram opens but does not connectPress Start in the bot, then run Test Telegram. If it still fails, the admin should check the webhook.
No low-stock alertConfirm the product threshold, Telegram connection, and whether the alert was already sent.
Offline sales not showing onlineOpen Sync status after internet returns and allow queued sales to complete.
Receipt not printingCheck printer pairing, paper size, browser permission, and the selected receipt format.
Items not updating on POSRefresh live inventory signal or allow the next sync cycle to pull the changed item.
Reference

Glossary

TermDefinition
Cost-at-SaleRecords the cost of an item at the moment of sale to freeze profit calculations historically.
FEFOFirst Expiry, First Out.
Idempotency KeyPrevents duplicate processing if a sync request is sent twice by poor networks.
PWAProgressive Web App.
Telegram WebhookThe server connection that lets Telegram send bot messages and button actions back to QuickPOS instantly.
Low-Stock ThresholdThe minimum quantity that triggers low-stock alerts and restock suggestions.
Q

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.