Sales
Use Quick Sale for Amount-Only Counter Lines
Quick Sale is for fast amount entry. Use it carefully because it is not a full stock-controlled catalog workflow.
- Menu path
- Home -> New Sale -> Quick Sale
- Verified from
- Posnic demo and current POS source reviewed on 2026-09-08
Technical source evidence
frontend/modules/sales_write.html #quick_sale_btn, frontend/static/script/js/modules/js/sales.js applyQuickSaleGate, quickSale.open and quickSale.add, api/src/repositories/item.repository.js instanceItemInsert, frontend/modules/settings_write.html Quick Sale feature and user POS Quick sale permission
When Quick Sale Is Appropriate
Quick Sale exists for busy counters where the cashier needs to sell a simple amount without building a full item first. It should not replace catalog discipline for stock items.
- Use for small service charges, temporary fees, one-time miscellaneous items or emergency sales when the catalog is being corrected.
- Do not use for stock-controlled items that need quantity tracking, reorder points, purchase costs, supplier reporting or barcode labels.
- Use a descriptive line name. A receipt line called Misc is hard to audit later.
- The live modal keeps the amount and name separate: amount is required, item name is optional in the UI but should be treated as required by shop policy.
- The modal hint shows the default tax behavior, so owners should verify tax setup before enabling Quick Sale for cashiers.
Add a Quick Sale Line
- Open Home -> New Sale.
- Click Quick Sale.
- Enter the sale amount.
- Enter an item name that explains what was sold.
- Add the line to the cart.
- Check the message that confirms how many quick lines were added.
- Review the cart total, customer, discount and notes.
- Open PAY and complete payment normally.
What Posnic Creates
Quick Sale posts an instant item through `items/instanceItemInsert`, then adds that returned item into the sale cart. The cashier experiences it as a sale line, but the owner should treat it as an exception workflow.
| Field or behavior | Current app behavior | Operator meaning |
|---|---|---|
| Name | Uses the typed note or the fallback name Quick sale. | Always type a useful name for audit and receipt clarity. |
| Quantity | Starts at 1. | Use it for one amount line, not stock counting. |
| Price | Amount becomes MRP and selling price. | The amount is what the customer pays for that quick line. |
| Tax | Uses the shop default tax when tax is enabled, with the amount treated as inclusive. | Check default tax before relying on this feature. |
| SKU/barcode | Instant items are not normal barcode-ready catalog products. | Create a real item when the product must scan or be restocked. |
| Sale history | The line saves inside the sale like other sale lines. | Review Quick Sale names during training and close. |
Tax and Reporting Behavior
The current sale code creates an instant sale item line using the shop's default tax behavior. This is convenient, but it means the owner should check tax defaults before cashiers rely on Quick Sale.
- Review Settings -> Tax before enabling Quick Sale broadly.
- Train staff to avoid Quick Sale when the item should have a specific tax class.
- Review Sales History for unclear Quick Sale names at the end of training day.
- Move recurring Quick Sale lines into real items once they become common.
- If a quick line appears often, create the item with cost, selling price, tax, SKU, barcode and stock controls.
Permissions and Controls
| Control | Recommended owner rule | Where it shows |
|---|---|---|
| Feature switch | Enable only when the shop has a clear use case. | Settings -> Features -> Quick Sale |
| Cashier permission | Allow trusted roles first, then broaden after review. | Employee or role permissions -> Till / POS Actions -> Quick sale / instant items |
| Line naming | Require a specific name for each amount-only line. | Sales History and receipts |
| Daily review | Check Quick Sale lines during close. | Sales History and sales reports |