Quick Sale & POS Receipts
Fast point-of-sale with 80mm thermal receipt printing
Overview
Quick Sale is a streamlined alternative to the full invoice flow. It is available on all plans and accessible from the sidebar, dashboard quick actions, or the mobile bottom navigation bar.
Go to Sales → Quick Sale to start.
How It Works
Behind the scenes, a quick sale creates a fully finalized and paid Invoice plus a Receipt in one atomic transaction. All existing reporting, stock deduction, and finance ledger logic is reused.
Step 1: Add Products
You have two ways to add items:
- Search bar: Type a product name, SKU, or barcode. Select from the dropdown to add to cart.
- Product grid: Tap any product tile to add it. Tap again to increase quantity. A green badge shows the current count in cart.
Step 2: Review Cart
Once you have items in cart, tap the green Checkout button to switch to the cart view. Here you can:
- Adjust quantities with +/- buttons or type directly
- Remove items
- Apply a per-line percentage discount to individual items (e.g., 10% off a specific product)
- Apply an overall fixed discount to the entire sale (e.g., KES 200 off the total)
- Set Sold by — the staff member making the sale (defaults to you)
- Set Referred by — optional broker who brought the deal (for commission tracking). Use + Add Broker to register a new external broker inline without leaving the sale
- See the running total including VAT and all discounts
- Tap Add More to go back to the product grid
Step 3: Complete Sale
Choose a payment method, optionally enter a reference and amount received, then tap Complete Sale.
| Field | Notes |
|---|---|
| Payment Method | Cash (default), MPesa, Card, or Bank Transfer |
| Split Payment | Toggle to accept multiple methods on one sale (e.g., part Cash + part M-Pesa). Add rows for each method and amount |
| Reference | Only shown for MPesa/Bank — enter the transaction code |
| Amount Received | Optional. If entered and greater than total, the change due is displayed |
Discounts
Quick Sale supports two types of discounts that can be combined:
| Discount Type | How It Works |
|---|---|
| Per-line % | Enter a percentage discount on any individual line item in the cart. The discount is applied to the line total before tax. Example: 10% off a KES 500 item = KES 450 line total. |
| Overall Fixed | Enter a fixed KES amount to subtract from the entire sale total. This is applied after all line-level discounts and before tax calculation. Example: KES 200 off a KES 3,000 cart. |
Both discount types are reflected on the printed receipt and in the underlying invoice record.
Branch Enforcement
When selling stocked products, Quick Sale uses your currently selected branch to determine which stock to deduct. If you operate multiple branches, make sure the correct branch is selected in the header branch picker before starting a sale. Stock availability shown on product tiles reflects the selected branch's inventory.
Non-stocked products (services) can be sold regardless of branch selection.
Stock Enforcement
Quick Sale enforces stock limits for stocked products. You cannot sell more than what is available in your warehouse.
- Out of stock: Product tiles are greyed out and disabled
- At limit: Tiles show an amber border with "All X in cart" when you have added all available stock
- Over limit: An error message appears if you try to add more than available
- Non-stocked products (services) have no stock limit
The server also validates stock before completing the sale, so even if the page data is stale, overselling is prevented.
Walk-in Customer
Quick sales are automatically assigned to a Walk-in Customer record. This customer is auto-created on your first quick sale and reused for all subsequent ones. You do not need to select or manage this customer — it is handled transparently.
Walk-in sales appear in your sales reports and customer statements under "Walk-in Customer".
Pricing
Product prices are loaded from your default price list. If a product has no price rule in the default list, the price shows as 0.00 — you should set up pricing in Settings → Pricing before using Quick Sale.
VAT is automatically calculated at 16% for products with a "vatable" tax profile.
What Gets Created
Each completed quick sale creates:
- A finalized + paid Invoice (status: "paid", notes: "Quick Sale")
- A Receipt linked to that invoice
- Stock ledger entries deducting sold quantities
- Finance ledger entries for revenue, cash, and VAT
Quick sales count toward your invoices per month plan limit since they create real invoices internally.
Quick Sale vs Full Invoice
| Feature | Quick Sale | Full Invoice |
|---|---|---|
| Customer | Auto (Walk-in) | Select from list |
| Draft mode | No — always finalized | Yes — save as draft first |
| Discounts | Per-line % + overall fixed | Per-line discounts |
| Partial payment | No — full payment only | Yes |
| Due date / credit | No — immediate | Yes — custom terms |
| UoM selection | Base UoM only | Any configured UoM |
| eTIMS fields | Not shown | Available if enabled |
| Speed | Seconds | Minutes |
POS Thermal Receipt Printing
After each sale, StockPulse generates a professional 80mm thermal receipt that you can print directly to your POS printer. Receipts include:
- Company header: Business name, address, phone, KRA PIN
- Line items: Product name, UoM, quantity, unit price, line total
- Tax summary: Automatic VAT breakdown — net amount (total / 1.16), VAT amount, and total. Compliant with Kenya 16% VAT
- Payment details: Amount tendered, change given, payment method and reference
- Receipt footer: Receipt number, date, “Served by” name, custom thank-you message
How to Print
After completing a sale, click the Print Receipt button. This opens a print-optimised view sized for 80mm paper. Click Print in the browser dialog to send it to your connected thermal printer.
Supported printers include any standard 80mm (3-inch) ESC/POS thermal printer connected via USB, Bluetooth, or network (Epson, Star, custom Chinese POS printers, etc.).
Reprinting Receipts
You can reprint any receipt from Sales → Receipts. Each receipt row has a dropdown menu with three options: Download PDF (full-size A4), Print Receipt (standard print), and Print POS (80mm thermal format). Quick date filters (Today, Yesterday, 7 Days, This Month) help you find receipts fast.