Vendventory Documentation
v1.0.0 Changelog

POS Overview

POS is the counter-sales part of Vendventory. Staff use it to sell items, take payment, print receipts, do returns and exchanges, manage the cash drawer, and move stock between stores.

Most important rule: before a cashier can sell, the app must already have a valid store, terminal, and open register session.

What POS includes

Counter sale pages
  • POS Terminal: the main selling screen.
  • Sales History: old sales, payment state, and receipt access.
  • Receipt screen: print, reprint, or share the receipt.
  • Returns and Exchanges: fix a sale after the customer comes back.
Customer and pricing pages
  • Customers: customer details, loyalty points, and store credit.
  • Customer Groups: groups like VIP, retail, wholesale, or general.
  • Pricing: store prices, special prices, promotions, and tax rules.
  • Coupons and Loyalty Rules: discount codes and points rules.
Control and manager pages
  • Stores & Terminals: setup of branches and counters.
  • Register Sessions: open shift, cash movement, close shift.
  • Drawer Reconciliation: compare counted cash with expected cash.
  • Manager Inbox: pending refunds, voids, drawer reviews, and follow-up work.
Branch and extended flows
  • Assisted Orders: take advance payment now and hand over the item later.
  • Manager Inbox: one place for manager approvals and follow-up work.
  • Branch Replenishment: ask for stock from warehouse or another branch.
  • Analytics and End of Day: manager summary, cashier totals, and close-day checks.
  • Scanner and device tokens: handheld and scanner support for faster selling.

Simple module map

1. POS Terminal
  • This is where the cashier sells.
  • The cashier picks the store, terminal, and session, then adds items and payment.
  • Example: customer brings 2 items, cashier scans them, takes payment, and finishes the sale.
2. Sales History
  • This is where staff find old sales.
  • Use it when someone wants a receipt again, a manager wants to check a sale, or an online payment is still pending.
3. Returns and Exchanges
  • Use Returns when the customer gives an item back and wants money back.
  • Use Exchanges when the customer gives one item back and takes another item instead.
  • Example: customer returns small size and takes large size. The app shows the extra amount to collect.
4. Customers and Customer Groups
  • Use Customers for names, phone, notes, loyalty, and store credit.
  • Use Customer Groups when prices or coupons depend on labels like VIP or general.
5. Pricing, Coupons, and Loyalty
  • These pages control who gets what price or discount.
  • Example: VIP customer gets a better price, coupon code works only in one branch, or loyalty points reduce the bill.
6. Register and Drawer pages
  • These pages control the cashier shift and the cash drawer.
  • Open the shift, record cash in/out, close the shift, then review the cash difference.
7. Manager and branch pages
  • Manager Inbox is for approvals and follow-up work.
  • Branch Replenishment is for moving stock where it is needed.
  • Analytics and End of Day are for daily review.
8. Assisted Orders and online payments
  • Use Assisted Orders when the customer pays now but will collect later.
  • Use online payments when the branch takes hosted checkout through Stripe, PayPal, JazzCash, or Easypaisa.

Common POS rules

Plain-language rules staff should know
  • If there is no open register session, checkout will stop.
  • If the store does not have released stock, the item cannot be sold from that store.
  • If price, coupon, or loyalty rules depend on the customer or branch, the app checks those before finishing the sale.
  • If the payment method is Card Machine, the machine approval happens outside the app first, then the cashier records the safe proof in POS.
  • If the refund, discount, void, or drawer difference is too large, manager review may be required.
  • If the payment method is online, the sale may wait for payment confirmation instead of finishing immediately.
If staff gets stuck: open POS Errors & Fixes. It explains the common POS messages in simple English with examples.

Simple POS flow chart

Step 1
Open the shift
Make sure the cashier has the correct store, terminal, and open register session.
Step 2
Add products
Scan or select items and check quantity, price, and tax.
Step 3
Apply customer rules
Customer, customer group, coupon, loyalty, and store rules affect the bill here.
Step 4
Take payment
Cash can finish directly. Card Machine uses the external machine first, then POS records safe proof.
Step 5
Complete the sale
POS creates the sale, updates stock, and gives the receipt.
Step 6
Handle follow-up
Use Sales History, Returns, Exchanges, Manager Inbox, or End of Day if something needs review later.
Payment note: Card Machine in the current build means the branch uses a real machine outside the app, then records the approved result inside the app. It is not direct machine control.
POS Payments & Card Machine

Open this if you want a simple explanation of cash, card machine, manual card, wallet, bank transfer, and hosted gateway flow.

Open POS Payments
Register Sessions & Drawer

Read this next if you want simple field-by-field help for opening a drawer, adding cash movements, closing a shift, and checking shortage or extra cash.

Open Register Sessions & Drawer
POS Errors & Fixes

Open this if you want the common POS errors explained in plain English with examples and simple next steps.

Open POS Errors & Fixes
Assisted Orders

Open this if you want the plain-language version of sell now, deliver later.

Open Assisted Orders
Manager Inbox

Open this if you want to understand where approvals and follow-up work are handled.

Open Manager Inbox
Branch Replenishment & End of Day

Use these pages when you want to understand stock movement between branches and daily closing review.

POS Demo Flow & Logins

Read this next if you want demo emails, demo password, store names, and the best click path for showing the app to someone.

Open Demo Flow & Logins
Storefront, Sales Orders, and Accounting

These pages explain the customer-facing order side and the journal side that sit next to POS.

Common POS errors

What the most common errors usually mean
  • Open a register session before checking out sales: the cashier is on the right screen, but the shift is not open yet.
  • The selected store does not have enough unreserved stock: the item may exist in the company, but not in that branch for sale right now.
  • The coupon code is not available for this customer group: the code is real, but this customer does not match the rule.
  • Payment rows must cover the POS sale total: the entered payments do not fully match the bill.