Comprehensive Operations & Visual Manual

Official Xstash Billing User Manual & Visual Guide

Complete step-by-step operating guide with concrete example values, realistic document previews, and business workflows separated by industry category and module.

Step 1: Choose Your Business Type (Filters Relevant Features)
All Business Types
View all 16 integrated billing, POS, GST, accounting & logistics modules
Showing 19 of 19 Modules
Step 2: Click Any Feature Below to View Visual Guide & Example Values (19)
Feature #1 • POS, Thermal & UPI

High-Speed Thermal POS (80mm & 58mm Roll Receipts)

Instant sub-second receipt printing on any 3-inch (80mm) or 2-inch (58mm) USB, Bluetooth, or Wi-Fi thermal printer with zero proprietary driver setup.

1. Feature Purpose & Business Objective
Core Capability

Ultra-fast retail counter checkout with sub-second receipt printing on 80mm (3-inch) or 58mm (2-inch) thermal rolls and A4 commercial tax invoices. Eliminates checkout lines during rush hours while capturing complete itemized GST tax breakdowns.

2. How to Add & Ingest DataMultiple Input Methods
1Keyboard Shortcut (F2)

Press F2 anywhere in the application to instantly jump to the POS billing counter.

2Barcode Scanner Ring-Up

Point USB/Bluetooth barcode scanner at items. Scanned products, taxes, and prices load instantaneously without touching mouse or keyboard.

3Quick Product Search

Type product name, brand, or SKU in the search bar. Real-time fuzzy search matches items across your catalog.

4Customer Tagging & Settlement

Pick a registered customer or default to 'Walk-in Cash Customer'. Tender amount via Cash, dynamic UPI QR, Card, or Credit account.

3. What is the Connection (System Interlinks)Data Pipeline
Directly decrements inventory counts in `inventory_items` and logs movement in `stock_movements`.
Interlinked with `customers` and `customer_ledgers` (auto-debits customer credit accounts if unpaid).
Calculates CGST, SGST, IGST per item based on HSN code and statutory tax brackets.
Tied to `daily_cash_register` shift drawer to balance physical cash versus digital collections.
4. Where It Affects Everything (Real-Time Impact)
Zero Discrepancy
Inventory: Deducts sellable stock in real time; warns cashiers if item reaches minimum reorder threshold.
Customer Account: Debits outstanding balance if sold on credit; updates customer transaction history.
Shift Drawer: Automatically logs cash intake into active Cashier Shift Register.
GST Return: Feeds outward taxable supplies into GSTR-1 (Table 7 B2CS or Table 4A B2B) and GSTR-3B.
Financial P&L: Credits sales revenue and records Cost of Goods Sold (COGS) to calculate gross margin.

Real-World Business Use Cases

Supermarket & Grocery

Prints 30+ item grocery bills on 80mm thermal rolls with MRP savings shown at the bottom.

Bakery & Sweet Shop

Prints compact 58mm counter tokens and receipts in under 1 second during evening rush.

Supports 80mm (3-inch) & 58mm (2-inch) thermal rolls
Custom store header, GSTIN, phone & return policy footer
Works with USB, Ethernet, Bluetooth & Wi-Fi printers
Also supports A4 Commercial Tax Invoice with watermark

Cashier Speed Keyboard Shortcuts

Operate your billing counter at high speed without touching the mouse.

F2
Open Quick POS Counter

Jump immediately to the New Invoice billing screen from anywhere.

F4
Customer Directory & Dues

Look up customer credit balances, contract tiers, and crate counts.

Ctrl + B
Toggle Full-Screen POS

Collapse or expand the left sidebar for maximum billing workspace.

Ctrl + P
Instant Thermal / A4 Print

Print 80mm/58mm thermal slips, A4 tax invoices, or barcode sticker sheets.

Complete Reference Manual

All 16 Modules — Step-by-Step Operations, Example Values & Visual Previews

Review every feature with concrete real-world input values, calculations, and visual screen references.

Module #1 • POS, Thermal & UPI

High-Speed Thermal POS (80mm & 58mm Roll Receipts)

Business Purpose & Advantage: Instant sub-second receipt printing on any 3-inch (80mm) or 2-inch (58mm) USB, Bluetooth, or Wi-Fi thermal printer with zero proprietary driver setup. Cuts counter queue times by 60%. Cashiers ring up items using keyboard shortcuts (F2) and print crisp receipts with itemized HSN/GST and dynamic UPI QR codes.
4-Step Operating Instructions:
Step 1Open Quick POS Counter

Press F2 anywhere in the app or click 'Invoices & Billing -> New Invoice' in the sidebar.

Step 2Scan or Pick Products

Scan item barcodes or type product names. Quantities and GST slabs calculate automatically.

Step 3Choose 80mm or 58mm Roll

Click 'Thermal Receipt' preview and toggle between 80mm (3-inch) or 58mm (2-inch) paper width.

Step 4One-Click Print

Press Print (or Ctrl+P) to send directly to your Epson, TVS, NGX, or POS thermal printer.

Concrete Example Values (Retail Counter Checkout at Sri Murugan Provision Stores):
Field / ActionExample Input
Cashier ShortcutF2
Customer Name & PhoneWalk-in Customer • 98401 23456
Product 1 (Barcode Scan)8901030784214 (Aashirvaad Atta 5kg)
Product 2 (Type Search)Tata Salt Crystal 1kg
Product 3 (Type Search)Toor Dal Premium 1kg
Payment ReceivedCash ₹1,000.00
Taxable Subtotal
₹706.24
Base price before GST calculation
CGST (2.5%) + SGST (2.5%)
₹32.76
Itemized HSN 1101 & 0713 tax breakdown
Invoice Grand Total
₹739.00
Rounded off to nearest rupee
Change Return
₹261.00
Tendered ₹1,000 − Total ₹739.00
Dynamic UPI QR
Embedded on slip
Encodes exact ₹739.00 for PhonePe/GPay
Module #2 • POS, Thermal & UPI

Dynamic NPCI UPI Payment QR Codes on Bills

Business Purpose & Advantage: Every printed receipt and on-screen bill automatically embeds an NPCI-compliant UPI QR code locked to the exact grand total of that invoice. Eliminates customer typing mistakes and cashier underpayment fraud. When the buyer scans with Google Pay, PhonePe, Paytm, or BHIM, the exact bill amount is pre-filled.
4-Step Operating Instructions:
Step 1Configure Store UPI ID

Go to 'Business Profile (Settings)' and enter your merchant UPI VPA (e.g. yourshop@okaxis or 9080809093@upi).

Step 2Generate Any Bill

Create a counter bill or B2B invoice as usual. The system encodes your UPI VPA + Exact Bill Total.

Step 3Show or Print QR

The dynamic QR code appears automatically on the thermal slip, A4 PDF, and cashier screen.

Step 4Instant Verification

Customer scans and taps Pay in 3 seconds with zero manual amount entry.

Concrete Example Values (Zero-Commission Contactless Digital Payment at Retail Counter):
Field / ActionExample Input
Merchant UPI VPA9080809093@upi
Payee NameSri Murugan Supermarket
Invoice Number#INV-2026-1042
Invoice Grand Total₹1,450.00
Customer AppPhonePe / GPay / Paytm
Generated UPI Intent
upi://pay?pa=9080809093@upi&pn=Sri%20Murugan&am=1450.00&cu=INR
Official NPCI format
Amount Pre-Fill
₹1,450.00 (Locked)
Customer cannot enter wrong or lower amount
MDR Commission Fee
₹0.00 (0% MDR)
Save ₹29.00 vs credit card swipe machines
Settlement Speed
Instant Direct Credit
Credited straight to your registered current account
Module #3 • Barcodes, Batches & Godowns

Universal Camera & USB Laser Barcode Scanner

Business Purpose & Advantage: Scan product barcodes using any plug-and-play USB/wireless laser gun OR use your laptop/phone/tablet camera with built-in 1.5x/2x zoom. Even if you don't own a physical barcode gun, your cashier can scan items using the built-in HD camera scanner. Sequential barcodes auto-generate starting at #1001.
4-Step Operating Instructions:
Step 1Auto-Generate or Map Barcode

In 'Add New Product', Xstash automatically assigns the next sequential code (e.g. 1001) or lets you scan the packet's EAN-13 code.

Step 2USB Laser Gun Billing

On the New Invoice screen, simply pull the trigger on your USB barcode gun — the item is added to cart with an audio beep.

Step 3Camera Scanner Mode

Click 'Scan Barcode' to open the HD camera scanner with 1.5x/2x zoom and torch control.

Step 4Instant Stock Lookup

Scan any item in the Inventory screen to jump straight to its stock count and price tiers.

Concrete Example Values (Universal Product Identification for Packaged FMCG & Loose Items):
Field / ActionExample Input
Manufacturer EAN-138901030784214
Store Sequential Code1001
Scanner HardwarePlug-and-play USB Gun
Camera Zoom Level1.5x Digital Zoom
Scan Response Time
<150 milliseconds
Immediate product lookup in local SQLite
Repeat Scan Action
Auto-Increments Qty
Scanning 3 times sets item quantity to 3
Stock Verification
48 units in stock
Warns if inventory is insufficient
Audio Feedback
Positive Beep Sound
Confirms addition without looking at monitor
Module #4 • Barcodes, Batches & Godowns

Code-128 Barcode Sticker & Price Label Printer

Business Purpose & Advantage: Design and print scannable Code-128 barcode sticker sheets on regular A4 sticker paper (24-Up / 40-Up) or 50×25mm thermal barcode label rolls. Turn unbranded or loose items (grains, garments, bakery packs, hardware spares) into barcoded products with Store Name, MRP strikethrough, Selling Price, and Expiry Date.
4-Step Operating Instructions:
Step 1Open Barcode Labels Hub

Click 'Barcode Labels & Batches' in the left dashboard menu.

Step 2Pick Product & Copy Count

Select any product from your catalog, enter how many stickers you need (e.g. 24 copies), and click 'Add to Sticker Sheet'.

Step 3Select Paper / Roll Layout

Choose 'A4 Sheet 24-Up (3×8)', 'A4 Sheet 40-Up (4×10)', or 'Thermal Roll 50×25mm (1-Up / 2-Up)'.

Step 4Print Scannable Stickers

Click 'Print Stickers' to print crisp SVG Code-128 barcodes ready to stick on your merchandise.

Concrete Example Values (In-House Garment Hang-Tag & Grocery Sticker Printing):
Field / ActionExample Input
Store HeaderKUMAR APPARELS & TEXTILES
Product Title & SizeMen Cotton Slim Shirt (Size 40 / L)
Code-128 CodeKTX-884210
MRP vs Offer PriceMRP ₹1,499.00 | Offer ₹899.00
Batch & Pkd DateBatch: B26-A1 • Pkd: 10/2026
Sheet Format
A4 Sheet 40-Up (4×10)
40 stickers printed per standard A4 label sheet
Thermal Roll Support
50×25mm Roll (1-Up)
Prints directly to TVS, TSC, Zebra label printers
Barcode Symbology
Vector SVG Code-128
100% sharp scannability at any printer DPI
Cost per Sticker
< ₹0.15 each
Save up to 80% vs outsourced label printing
Module #5 • Barcodes, Batches & Godowns

Batch Number, Mfg/Expiry Alerts & Serial/IMEI Tracking

Business Purpose & Advantage: Track Batch/Lot numbers, Manufacturing dates, Expiry dates with automated 7-day & 30-day colour-coded alerts, plus Serial/IMEI numbers. Prevents selling expired medicines, dairy, or food items and protects electronics dealers by recording exact Serial/IMEI numbers against stock.
4-Step Operating Instructions:
Step 1Set Batch & Expiry on Product

When creating/editing a product or in 'Barcode Labels & Batches -> Tab 2', enter Batch No, Mfg Date, and Expiry Date.

Step 2Monitor Near-Expiry Badges

View automatic 'EXPIRED', '7d left', and '30d left' badges in the Batch & Expiry Matrix.

Step 3Record Serial / IMEI Numbers

Enter comma-separated Serial or IMEI numbers for warranty-backed electronics and hardware.

Step 4Return Expired Stock

Issue a Supplier Debit Note in one click for expired batches to claim purchase credit.

Concrete Example Values (Pharmacy Expiry Compliance & Mobile Phone IMEI Warranty Tracking):
Field / ActionExample Input
Medicine NameAugmentin 625 Duo Tablet (10s Strip)
Manufacturer Batch NoBAT-AUG-9921
Mfg & Expiry DatesMfg: 15/01/2026 • Exp: 30/12/2026
Near-Expiry ProductAmoxil 500mg (Exp: 25/11/2026)
Mobile Phone IMEIIMEI 1: 864902049182019
Fresh Stock Badge
Safe (Green Badge)
Approved for unrestricted counter billing
Near-Expiry Warning
7 Days Left (Amber Badge)
Alerts cashier to prioritize selling or discount
Expired Stock Action
1-Click Debit Note
Deducts expired items and logs vendor refund claim
Warranty Traceability
IMEI linked to Invoice
Allows warranty service center verification
Module #6 • Barcodes, Batches & Godowns

Multi-Godown / Warehouse Inventory & Stock Transfers

Business Purpose & Advantage: Manage multiple storage locations (Main Store Counter, Central Bulk Godown, Chiller/Cold Room, Delivery Vans) and issue Inter-Godown Stock Transfer slips. Know exactly how much stock is sitting in your backyard godown versus your front retail counter or cold storage room without manual register books.
4-Step Operating Instructions:
Step 1Open Multi-Godown Manager

Go to 'Barcode Labels & Batches -> Tab 3: Multi-Godown & Stock Transfers'.

Step 2Add Godown / Van Locations

Create locations such as Main Warehouse, Retail Counter, Cold Storage, or Delivery Van.

Step 3Issue Stock Transfer Slip

Select Product, From Godown, To Destination Godown, and Quantity to generate an official #TRF voucher.

Step 4Audit Transfer History

Review the chronological Inter-Godown Transfer Register for complete stock accountability.

Concrete Example Values (Central Bulk Godown to Retail Counter Stock Replenishment):
Field / ActionExample Input
Transfer Voucher No#TRF-2026-0081
Source GodownCentral Warehouse (Ambattur Depot)
Destination GodownRetail Counter (T. Nagar Store)
Product & QuantityFortune Sunflower Oil 1L (200 pouches)
Authorized Driver/VanRamesh • Van: TN-02-AK-9110
Source Stock After
1,000 pouches (-200)
Deducted immediately from Central Godown
Dest Stock After
250 pouches (+200)
Ready for retail counter sales immediately
Transfer Slip Print
Signed Transfer Manifest
Valid transit document for vehicle inspection
Inventory Leakage
Zero Discrepancy
Complete audit trail between storage points
Module #7 • Barcodes, Batches & Godowns

Supplier Purchase Bills, Packaging Units (Dual UoM) & Costing

Business Purpose & Advantage: Inward vendor invoices, buy in bulk packaging (Crates/Boxes) while selling in individual units (Packets/Pieces), auto-generate unique SKUs, and recalculate true weighted-average purchase cost. Buy by the Crate or Box from suppliers and sell by individual packets over the counter. Stock converts automatically (e.g. 10 Crates = 560 Packets) with zero manual math, and every product is protected with guaranteed unique SKUs.
4-Step Operating Instructions:
Step 1Open Purchase Bills & Stock In

Click 'Purchase Bills' in the sidebar or press F8. Click 'Smart AI Bill Scanner' for camera scan or type into the fast grid.

Step 2Enter Supplier & Invoice Meta

Type Supplier Name (e.g. Metro Dairy Wholesalers), Bill Number, Date, and Payment Mode (Cash, Bank, UPI, or Credit).

Step 3Choose Unit (Crate vs Packet)

Enter quantity. For bulk products, click the unit badge to toggle between Crate (CRT) and individual Packets (PCS). Cost per piece displays automatically.

Step 4Save Bill & Update Stock

Click 'Record Purchase Bill'. Inventory stock increments instantly and weighted-average cost price is updated for profit calculations.

Concrete Example Values (Bulk FMCG / Dairy Purchase Inward with Packaging Unit Conversion):
Field / ActionExample Input
Supplier NameMother Dairy / Amul Depot
Supplier Bill NumberINV-2026-8812 (Dated Today)
Product 1 (Inwarded in Crates)10 Crates Standard Milk 500ml @ ₹1,344.00/CRT
Product 2 (Inwarded in Boxes)5 Boxes Curd 200g @ ₹480.00/BOX
Payment TermsCredit (30 Days)
Total Bill Amount
₹15,840.00
Recorded under Accounts Payable
Stock Added to Inventory
+560 Milk Packets, +120 Curd Cups
Ready for immediate retail or route delivery
Calculated Unit Cost
Milk: ₹24.00/pkt • Curd: ₹20.00/cup
Accurately derived from crate & box rates
SKU & Catalog Security
Unique SKU-1001 & SKU-1002
Zero duplicate items created in database
Module #8 • P&L, Balance Sheet & Returns

Credit Notes (Sales Returns) & Debit Notes (Purchase Returns)

Business Purpose & Advantage: Issue official GST-compliant Credit Notes for customer sales returns and Debit Notes for supplier returns with automatic stock restoration and ledger credit. No manual stock or ledger fixing needed. Choosing 'Good Condition — Restock' puts returned items back into inventory, credits the customer's due balance, and reduces your GST tax liability.
4-Step Operating Instructions:
Step 1Open Credit & Debit Notes

Click 'Credit & Debit Notes' in the left sidebar.

Step 2Choose Voucher Type & Invoice

Select 'Credit Note (Sales Return)' or 'Debit Note (Purchase Return)' and optionally link the original Invoice.

Step 3Select Stock Condition & Refund Mode

Choose 'Restock to Sellable Inventory' or 'Damaged Waste', and choose 'Credit Customer Ledger' or 'Cash/UPI Refund'.

Step 4Issue Note

Click Issue — stock, customer ledger, P&L net revenue, and GSTR-1 CDNR update simultaneously.

Concrete Example Values (B2B Customer Sales Return & GST Output Tax Reversal):
Field / ActionExample Input
Credit Note Voucher#CN-2026-0042
Original Tax Invoice#INV-2026-0914 (Dated 12-Nov-2026)
Customer NameShree Ganesh Traders (33AAACG9912K1Z4)
Returned Item5 bags Basmati Rice 10kg
Stock DispositionRestock to Sellable Inventory
Total Credit Note Value
₹3,412.50
Taxable ₹3,250.00 + 5% GST ₹162.50
Customer Due Balance
Reduced by ₹3,412.50
Customer ledger credited automatically
Stock Impact
+5 bags added to stock
No manual inventory adjustments needed
GST Portal Filing
Logged in GSTR-1 CDNR
Reverses output tax in monthly return
Module #9 • GST, E-Way Bill & IRN

GSTR-1 & GSTR-3B Official Government JSON & CA Excel Export

Business Purpose & Advantage: One-click export of Government GST Offline Tool JSON files (`GSTR1_*.json` & `GSTR3B_*.json`) and Chartered Accountant CSV spreadsheets. Saves ₹15,000+ per year in manual accounting work. Automatically separates B2B (with GSTIN), B2CL, B2CS rate-wise sales, Table 12 HSN Summary, and reconciles Input Tax Credit (ITC).
4-Step Operating Instructions:
Step 1Open GST Filing Hub

Click 'GST, E-Way Bill & IRN' in the left sidebar and select your From/To tax period.

Step 2Review GSTR-1 & Table 12 HSN

Inspect B2B invoices, B2CS slab summary, and HSN-wise quantity & tax breakdown in Tab 1.

Step 3Check GSTR-3B Net Tax & ITC

Open Tab 2 (GSTR-3B) to see Outward Tax Liability minus Eligible Input Tax Credit (ITC) from purchases and expenses.

Step 4Download JSON or CA Excel

Click 'Download Official GSTR-1 JSON', 'Download GSTR-3B JSON', or 'Export CA / Excel CSV'.

Concrete Example Values (Monthly Statutory GST Filing & Auditor Excel Delivery):
Field / ActionExample Input
Taxpayer GSTIN33AABCT1332L1Z8
Tax Return PeriodNovember 2026
B2B Invoices (Table 4A)18 Invoices (Total ₹4,50,000)
B2CS Counter Sales (Table 7)₹1,20,000 (Consumer Sales)
Inward Purchase ITC₹38,400.00 from supplier bills
Operating Expense ITC₹6,450.00 from rent & utility bills
Total Outward Tax
₹86,950.00
CGST ₹43,475 + SGST ₹43,475
Total Eligible ITC
₹44,850.00
Purchase ITC (₹38,400) + Expense ITC (₹6,450)
Net Cash GST Payable
₹42,100.00
Outward Tax minus Eligible ITC (paid via challan)
Government JSON File
GSTR1_33AABCT1332L1Z8_112026.json
Direct 1-click upload on gst.gov.in portal
Module #10 • GST, E-Way Bill & IRN

12-Digit NIC E-Way Bill & 64-Char E-Invoice IRN Generator

Business Purpose & Advantage: Generate 12-digit E-Way Bills with vehicle & distance validity and 64-character SHA-256 E-Invoice IRN hashes with NIC Signed QR payloads. Wholesalers and B2B suppliers transporting goods worth ₹50,000+ can generate compliant transport E-Way Bills and B2B E-Invoices in seconds without leaving the billing screen.
4-Step Operating Instructions:
Step 1Open E-Way Bill or E-Invoice Tab

Go to 'GST, E-Way Bill & IRN' and click Tab 3 (E-Way Bill) or Tab 4 (E-Invoicing IRN).

Step 2Auto-Fill from Any Invoice

Pick a recent invoice from the dropdown — Buyer Name, GSTIN, Invoice No, and Taxable Value fill automatically.

Step 3Enter Vehicle & Pin Code

Enter Vehicle Number (e.g. TN01AB1234), Destination Place, Pincode, and Distance in KM.

Step 4Generate & Download NIC JSON

Click Generate to issue the 12-digit EWB or 64-char IRN and download the NIC JSON file.

Concrete Example Values (High-Value Interstate Consignment & Corporate E-Invoicing):
Field / ActionExample Input
Tax Invoice Number#INV-2026-8821
Consignment Value₹1,85,000.00
Consignor (Origin)Sri Murugan Agencies (33AABCT1332L1Z8 - Chennai)
Consignee (Destination)Balaji Traders (29ABCDE1234F1Z5 - Bengaluru)
Distance & Vehicle345 KM • Road • Lorry TN-09-CB-4491
12-Digit E-Way Bill No
5218 9034 1182
NIC statutory highway transport pass
Validity Period
4 Days (Until 22-Nov-2026)
Statutory 1 day per 100 km rule
64-Character IRN Hash
4f7b2a991c0e8d712f5a6b0c9e4d1f...
SHA-256 encrypted digital invoice seal
NIC Ack Number
1126109482910
Printed with signed QR code on PDF invoice
Module #11 • P&L, Balance Sheet & Returns

Trading Profit & Loss (P&L) Statement, Balance Sheet & Expense ITC

Business Purpose & Advantage: Live Trading and Profit & Loss Statement, automated Balance Sheet valuation, and Operational Expense Tracker with GSTR-3B Input Tax Credit claims. Know your true Net Operating Profit after deducting Cost of Goods Sold (COGS), Sales Returns, Rent, Salaries, Fuel, and Electricity — without buying separate accounting software.
4-Step Operating Instructions:
Step 1Open P&L & Balance Sheet

Click 'P&L, Balance Sheet & Exp' in the left sidebar.

Step 2Record Daily/Monthly Expenses

In Tab 3 (Operational Expense Tracker), log Rent, Electricity, Fuel, or Salaries and tick 'Claim ITC' if GST bill is available.

Step 3Analyze Profit & Loss

In Tab 1 (Profit & Loss), review Revenue, COGS, Gross Profit Margin %, Expense breakdown, and Net Profit.

Step 4Inspect Balance Sheet & Export

Switch to Tab 2 (Balance Sheet) to verify Total Assets = Total Liabilities & Equity, or export to CSV.

Concrete Example Values (Monthly Trading Profitability & Financial Position Audit):
Field / ActionExample Input
Accounting Range01-Nov-2026 to 30-Nov-2026
Gross Sales Revenue₹12,45,000.00
Cost of Goods Sold (COGS)₹8,20,000.00
Store Rent Expense₹35,000.00 (with GST ITC)
Staff Salaries & Electricity₹60,000 Salaries + ₹20,000 Electricity
Gross Trading Profit
₹4,25,000.00 (34.1%)
Revenue minus direct goods cost
Total Operating Expenses
₹1,15,000.00
Rent + Salaries + Power + Transport
Net Operating Profit
₹3,10,000.00 (24.9%)
Actual net take-home earnings
Balance Sheet Equation
Assets ₹24.80L = Liabilities ₹24.80L
100% matched with 0.00 variance
Module #12 • P&L, Balance Sheet & Returns

Double-Entry Journal Vouchers (JV) & Chart of Accounts

Business Purpose & Advantage: Pass formal Debit (Dr.) and Credit (Cr.) double-entry journal vouchers across standard Chart of Accounts for depreciation, capital, and audit adjustments. Gives your Chartered Accountant Tally-grade journal voucher control inside Xstash for year-end closing and non-cash ledger adjustments.
4-Step Operating Instructions:
Step 1Open Journal Vouchers Tab

Go to 'P&L, Balance Sheet & Exp -> Tab 4: Double-Entry Journal Vouchers'.

Step 2Select Debit & Credit Accounts

Choose the Debit (Dr.) account and Credit (Cr.) account from the Chart of Accounts.

Step 3Enter Amount & Audit Narration

Enter the adjustment amount and a clear audit narration.

Step 4Post Voucher

Click Post to generate a numbered #JV-0001 entry in the General Journal Register.

Concrete Example Values (Year-End Equipment Depreciation & Auditor Adjustments):
Field / ActionExample Input
Voucher Number#JV-2026-0014
Debit (Dr.) AccountDepreciation Expense A/c
Credit (Cr.) AccountOffice Equipment & POS A/c
Adjustment Amount₹18,500.00
Audit NarrationAnnual depreciation on 4 POS touchscreens & thermal printers
Ledger Effect
Dr. ₹18,500.00 | Cr. ₹18,500.00
Double-entry balance maintained perfectly
Asset Book Value
Adjusted from ₹1,23,000 → ₹1,04,500
Reflected in updated Balance Sheet
P&L Net Profit Impact
Decreased by ₹18,500.00
Reduces taxable corporate income legally
Auditor Compliance
Signed General Journal Entry
Exportable to CA Excel spreadsheet
Module #13 • Multi-Bank, Cheques & BRS

Multi-Bank Accounts, Post-Dated Cheques (PDC) & BRS Reconciliation

Business Purpose & Advantage: Track multiple Bank Accounts (Current, Savings, OD/CC), Physical Cash Drawers, UPI Settlement Pools, Cheque PDC lifecycles, and Bank Reconciliation Statements (BRS). Never lose track of post-dated customer cheques or uncleared bank entries. Clearing a cheque in Xstash automatically updates your bank balance and reconciles your passbook.
4-Step Operating Instructions:
Step 1Open Banking, Cheques & BRS

Click 'Banking, Cheques & BRS' in the left sidebar.

Step 2Manage Bank & Cash Accounts

View live balances across your Current A/c, Cash Drawer, and UPI Pool, or add new bank accounts.

Step 3Track Cheque Lifecycle

In Tab 3 (Cheque & PDC Lifecycle), register inward/outward cheques and click 'Clear' or 'Bounce' as bank status updates.

Step 4Match Bank Statement (BRS)

In Tab 2 (BRS), click 'Match Bank' on uncleared entries to record exact bank clearance dates.

Concrete Example Values (Multi-Account Treasury Management & Bank Passbook Matching):
Field / ActionExample Input
HDFC Current Ledger Balance₹4,82,150.00
Physical Cash Drawer₹18,400.00
Customer PDC ReceivedCheque #409112 from R.K. Agency
Unpresented Cheque IssuedCheque #10408 to Vendor for ₹12,000
NetBanking Statement Bal₹4,49,150.00
BRS Reconciliation Formula
₹4,82,150 − ₹45,000 + ₹12,000
Standard statutory BRS reconciliation
Reconciled Passbook Balance
₹4,49,150.00
Passbook Statement matched 100% (0.00 Variance)
PDC Alert Status
Pending Due 25-Nov
Alert pops up when cheque is due for deposit
1-Click Clear Action
Auto-credits HDFC Balance
Updates bank balance automatically upon bank clearance
Module #14 • B2B Tiers & Ledger

3-Tier Pricing Engine (MRP / Shop / Wholesale) & B2B Price Lists

Business Purpose & Advantage: Automatically apply the right price for every buyer using a 3-level priority engine: Special Customer Contract Rate → B2B Company Group Price List → Shop/Wholesale/MRP Tier. Cashiers never have to memorize or manually type negotiated rates for regular shops, hotels, or wholesale dealers. Selecting the customer applies their exact contract rate automatically.
4-Step Operating Instructions:
Step 1Set 3 Tiers on Products

Enter Retail MRP, Shop Price, and Wholesale Price on your products.

Step 2Assign Customer Price Group

When creating a customer, assign them to 'Retail', 'Shop', or 'Wholesale'.

Step 3Create B2B Company Price Lists

Use 'Company Price Lists' or 'Special Prices' to lock negotiated contract rates for specific corporate clients.

Step 4Auto-Rate Billing

Pick the customer on the invoice screen — their exact negotiated prices load automatically.

Concrete Example Values (Automated Multi-Tier Pricing for Retail vs Regular B2B Buyers):
Field / ActionExample Input
Product Master SKUA2 Full Cream Cow Milk 1 Litre
Tier 1: Retail Walk-in MRP₹60.00 / Litre
Tier 2: Tea Shop / Bakery Rate₹54.00 / Litre
Tier 3: Corporate Contract₹49.50 / Litre (Hotel Saravana)
Selected Buyer on InvoiceHotel Saravana Grand
Resolved Unit Price
₹49.50 / Litre (Tier 3 Contract)
Auto-applied without cashier manual intervention
100-Litre Order Amount
₹4,950.00
Customer saves ₹1,050.00 compared to MRP
Credit Limit Alert
Current Due ₹12,400 (Limit ₹50,000)
Green safe badge; order approved
Contract Locking
Locked until 31-Dec-2026
Fixed price guarantee honored automatically
Module #15 • Dairy & Route Dispatch

Daily Route Dispatch, Standing Recurring Schedules & Crate Ledger

Business Purpose & Advantage: Automates morning multi-stop distribution: geographical routes, standing recurring subscriptions (daily/custom days), driver loading pass in crates, and returnable container audits. Eliminates creating invoices manually at 4:00 AM every morning. Pulls all daily standing subscriptions into a sequenced vehicle loading sheet in 1 click, tracks every plastic crate or metal can, and auto-debits customer accounts upon route return.
4-Step Operating Instructions:
Step 1Add Delivery Route

Go to 'Delivery Routes & Fleet' -> click '+ Add Route'. Enter route name, code, assigned driver, vehicle number, and operating days.

Step 2Assign Customer Sequence

In 'Customers', set each customer's Route (e.g. Route A), Stop Sequence (1, 2, 3), and Price Group (Shop or Wholesale).

Step 3Create Recurring Orders

In 'Recurring Schedules', create standing orders for each customer specifying product, quantity, and active delivery days.

Step 4Morning Dispatch & Reconcile

In 'Daily Dispatch', select today's date and route. Review vehicle loading pass in crates, record drops and empty crates returned, then click 'Reconcile'.

Concrete Example Values (Morning 5:00 AM Milk Delivery Route with Crate Auditing):
Field / ActionExample Input
Delivery RouteRoute A - College Road (Tata Ace MH-12-9988)
Stop 1: Krishna Tea Stall30 Packets Full Cream 500ml @ Shop Price (₹24.00)
Stop 2: Modern Bakery14 Packets Standard Milk 1L @ Wholesale (₹46.00)
Vehicle Loading Pass44 Packets Total = 1 Crate (1L) + 1 Crate (500ml)
Container Tracking2 Crates Issued / 2 Empty Crates Collected
Loading Pass Slip
2 Crates (44 Packets Total)
Driver loads van without manual counting
Krishna Tea Stall Debit
₹720.00 posted to ledger
Customer balance updated automatically
Modern Bakery Debit
₹644.00 posted to ledger
Customer balance updated automatically
Container Balance
0 Crates Outstanding
Both empty crates returned safely to dairy
Module #16 • Offline SQLite & Wi-Fi Sync

100% Offline SQLite Engine, Store Wi-Fi Multi-Counter & Cloud Sync

Business Purpose & Advantage: Runs at <5ms speed on an embedded local SQLite database with 1-click USB `.db` backup, local Wi-Fi multi-counter QR pairing, and two-way MongoDB Atlas cloud sync. Your billing counter never stops when broadband internet goes down. Connect up to 5 counter laptops/tablets over local shop Wi-Fi with zero extra per-user monthly SaaS fees.
4-Step Operating Instructions:
Step 1Bill 100% Offline Anytime

All products, customers, invoices, and ledgers are saved instantly to your local SQLite database.

Step 2Connect Extra Counters via Wi-Fi

Click the 'Wi-Fi Multi-Counter' button in the top bar and scan the QR code from another laptop or tablet on the same router.

Step 3Two-Way Cloud Sync

Click 'Sync Cloud' in the dashboard header anytime internet is available to mirror data with MongoDB Atlas.

Step 41-Click Physical USB Backup

Go to 'Developer & DB Tools' to download a complete `.db` snapshot to your pen drive.

Concrete Example Values (Zero-Broadband High-Speed Counter Billing & Multi-Device Sync):
Field / ActionExample Input
Local Database FileEmbedded SQLite (`billing.db`)
Store Wi-Fi LAN ModeHost IP: `http://192.168.1.100:3000`
Extra Connected DevicesCounter 2 Laptop + Android Tablet
Cloud Storage ReplicaMongoDB Atlas (`xstash_db`)
Physical Backup TargetUSB Pen Drive (FAT32/NTFS)
Invoice Save Speed
1.8 milliseconds (<2ms)
Zero loading spinners or broadband network lag
Multi-Counter Billing
3 devices simultaneously
All share live inventory over local store Wi-Fi
Cloud Sync Duration
42 bills synced in 2.4 seconds
Triggered whenever internet reconnects
Monthly SaaS Fee
₹0.00 / Month
Permanent ownership with zero recurring per-user fees
Module #17 • AI & Email Configuration

Google Gemini AI Purchase Bill Scanner & Key Configuration

Business Purpose & Advantage: Automate purchase inward entry by scanning paper supplier bills or uploading PDFs. Google Gemini AI reads suppliers, line items, packaging units, and rates directly into your inventory. Cuts purchase inward time from 25 minutes down to 5 seconds. Automatically matches dairy tanker and milk depot bills, maps dual packaging units (crates/pouches), and records purchase costs with zero typing.
4-Step Operating Instructions:
Step 1Configure API Key

Open Settings -> Business Profile. In 'Google Gemini AI Key', paste your AI Studio API key and save.

Step 2Test AI Connection

Click 'Test Gemini Key'. The system pings Google's endpoints and confirms working model status (e.g. gemini-2.0-flash active).

Step 3Snap or Upload Bill

Go to Purchases -> 'Scan Bill (AI Camera)'. Use your webcam/phone camera or click 'Upload File' to select the supplier's bill.

Step 4Review & Save to Stock

Review auto-filled items, tax rates, and quantities. Click 'Save Purchase Bill' to update inventory stock and supplier credit ledger.

Concrete Example Values (Morning Milk Depot Purchase Inward via AI Camera Scan):
Field / ActionExample Input
Document SourcePaper Challan / Delivery Invoice photo
AI Model UsedGoogle Gemini 2.0 Flash (`gemini-2.0-flash`)
Detected SupplierMetro Milk Federation / Amul Depot
Detected Items40 Crates Toned Milk 500ml + 20 Crates Full Cream 1L
Packaging Factor1 Crate = 24 Pouches (500ml), 1 Crate = 12 Bottles (1L)
Scan Time
3.2 seconds
Complete document parsed without typing
Stock Added
960 pouches (500ml) + 240 bottles (1L)
Base unit inventory updated in real-time
Crate Inward
60 Crates received
Supplier crate container balance tracked
Purchase Bill Value
₹42,800.00 posted to supplier ledger
Accounts payable ledger updated
Module #18 • AI & Email Configuration

Official Business Email Configuration & Automated Invoice Delivery

Business Purpose & Advantage: Configure your registered business email and merchant contact details. Send professional branded PDF invoices and payment receipts directly to customers via email and WhatsApp. Guarantees prompt invoice delivery and eliminates paper bill loss. Customers receive immediate PDF invoices and automated payment receipts with your company logo, bank details, and dynamic UPI QR code.
4-Step Operating Instructions:
Step 1Enter Business Email & Phone

Go to Settings -> Business Profile. Fill in your official Business Name, Billing Email, Phone, Address, and GSTIN.

Step 2Save Customer Email/Phone

When adding customers (or in quick assign), enter their phone number and email address for digital delivery.

Step 3Send Bill via WhatsApp

From Invoices or Daily Register, click the green 'WhatsApp' button. A pre-composed message with invoice details opens in WhatsApp Web/App.

Step 4Download or Email PDF

Click 'Download PDF' to save or email the high-resolution vector A4 or thermal receipt slip to the client.

Concrete Example Values (Weekly Customer Route Billing via WhatsApp & Email):
Field / ActionExample Input
Sender IdentityMetro Dairy Farms & Route Logistics
Sender Emailbilling@metrodairy.com
Customer RecipientShree Krishna Tea House (Phone: 9876543210)
Invoice DetailsInvoice #INV-2026-089 • Total: ₹4,320.00
Delivery ChannelWhatsApp Direct + Official PDF Slip
Delivery Time
< 2 seconds
Customer receives bill immediately on their phone
UPI Payment QR
Embedded on bill
Customer scans and settles directly to your UPI VPA
Dispute Rate
0% disputes
Itemized drop dates and quantities clearly listed
Payment Speed
Settled same day
Immediate confirmation reduces 30-day payment lag
Module #19 • Multi-Select & Bulk Tools

Multi-Select Checkboxes & Rapid Bulk Actions Engine

Business Purpose & Advantage: Perform high-speed batch operations across Products, Invoices, Customers, and Categories using responsive multi-select checkboxes on both desktop and mobile screens. Save hours of repetitive clicking. Bulk-adjust prices across product lines by a percentage (%), reassign dozens of customers to delivery routes, or settle invoices in 2 clicks with complete transactional safety.
4-Step Operating Instructions:
Step 1Select Records via Checkboxes

Open Products, Customers, Invoices, or Categories. Check individual rows or click 'Select All' in the header.

Step 2Review Floating Action Bar

The dark floating action toolbar at the bottom shows the selected count and available bulk actions.

Step 3Choose Action & Set Parameters

Click your desired action (e.g. 'Adjust Prices', 'Assign Route', 'Mark Paid', or 'Set Color').

Step 4Confirm & Execute

Review the modal dialog preview and click confirm. The changes take effect immediately across all records.

Concrete Example Values (Morning Route Reassignment & Rate Revision across 25 Customers):
Field / ActionExample Input
Selected Entities25 Customers on Western Express Highway
Primary ActionAssign Delivery Route -> Route B (Tata Ace)
Secondary ActionSet Pricing Tier -> Wholesale Rate
Product Price ActionAdjust Prices: +5% on Shop Rate for all Dairy Items
Execution Time
0.4 seconds
Processed in single atomic database transaction
Dispatch Update
Route B loading pass updated
Driver vehicle pass reflects all 25 customers
Invoice Accuracy
100% correct pricing
Next morning invoices auto-apply updated rates
Time Saved
45 minutes manual typing saved
Zero repetitive customer form editing