hisaabkhata
Ctrl K
Verified Production Field Standard Operating Procedure

HisaabKhata & HissabKhata Master Operating Manual

The authoritative end-user field manual for Store Managers, Counter Cashiers, Accounts Executives, and Operations Teams. Master daily reconciliation, prevent cash leakage, accelerate loan recovery, and execute flawless data entries.

100% End-User Centric Real-Time Running Balance Multi-lingual Voice Recognition Cash vs. Bank Reconciliation

Section 1: Value for Money & 10x ROI

How HisaabKhata / HissabKhata Pays for Itself on Day 1

Measurable Returns

In standard retail, workshop, and business counter operations, traditional paper notebooks ("Khatas") or unorganized spreadsheets cause unseen financial leakage, forgotten customer debts, cash drawer mismatches, and chaotic month-end closures. HisaabKhata replaces guesswork with bulletproof ledger precision.

4+ Hours Saved Daily

Instant voice entries and automated passbook calculations eliminate manual ledger tallying and evening cash re-counting, saving staff 120+ hours per month.

100% Debt & Credit Recovery

Built-in due-date alerts highlight overdue customer and vendor loans on the dashboard, preventing forgotten credit balances and bad debt write-offs.

Zero Drawer Cash Leakage

Strict segregation between Cash in Hand and Bank / UPI Balance ensures staff instantly catch unrecorded drawer withdrawals.

Project & Job Profitability

Tag transactions to specific jobs, branch stores, or projects to identify unprofitable accounts before cash runs out.

Business Problem Old Paper / Excel Reality HisaabKhata Solution Monthly Monetary Impact
Forgotten Customer Credit Scribbled on loose slips; customers forget, money lost. Centralized Debts Ledger with due dates and settlement tracking. + ₹15,000 to ₹50,000 recovered/month
Cash Drawer Discrepancies Physical cash doesn't match register at 9 PM closing. Separate real-time Cash Balance updated on every entry. + ₹5,000 to ₹12,000 leakage prevented
Staff Entry Friction Staff skip recording small ₹50 - ₹200 tea/courier expenses. 5-second Voice Entry in Hindi/Gujarati/English. + ₹4,000 petty cash accounted
Month-End Audit Delays Accountant takes 3 days to reconcile paper statements. 1-Click Passbook CSV Export and formatted Print. 3 Full Workdays reallocated to sales

Section 2: Data Flow Impact Matrix

Where Data is Entered ➔ Which Modules are Affected ➔ Final Financial Impact

Ledger Topology

Every form in HisaabKhata connects directly to the core double-entry-style ledger engine. Understanding this matrix ensures staff realize why selecting the right Payment Method (Cash vs Bank) and Category matters.

Touchpoint / Form Data Entered Ledgers & Modules Updated Direct Financial & Balance Impact
Log Income (Dashboard / Passbook) Amount, Category, Payment Method (Cash/Bank), Project, Date • Passbook Ledger (+ Credit)
• Dashboard Income Metric
• Selected Category Inflow
• Selected Project Ledger
Increases Total Balance and increases either Cash Balance (if Cash) or Bank Balance (if Bank). Increases Monthly Surplus.
Log Expense (Dashboard / Passbook) Amount, Category, Payment Method (Cash/Bank), Project, Date • Passbook Ledger (- Debit)
• Dashboard Expense Metric
• Category Donut Chart
• Project Expense Breakdown
Decreases Total Balance and deducts directly from physical cash drawer or bank account. If budget is set, triggers budget consumption.
Log Debt (Lend) Person Name, Total Amount, Due Date, Description • Debts Module (Money Lent)
• Overdue Alert Engine
Creates an outstanding Receivable Asset. Does not affect Passbook until repayment installment is recorded.
Log Debt (Borrow) Person Name, Total Amount, Due Date, Description • Debts Module (Money Borrowed)
• Overdue Alert Engine
Creates a Payable Liability. Tracks upcoming debt obligation without distorting monthly business revenue.
Debt Repayment Entry Debt ID, Installment Amount, Date, Payment Method (Cash/Bank), Notes • Debts Balance (Decreased)
• Automatic Passbook Transaction under Debt Settlement
• Cash / Bank Balance
Reduces outstanding debt balance. Automatically generates a matching Income (if lent debt returned) or Expense (if borrowed debt paid) in the Passbook.
P2P Transfer (Direct Send) Recipient User Email, Amount, Note • Sender Passbook (- Expense)
• Recipient Passbook (+ Income)
• Transfer History Thread
Immediate bilateral ledger settlement. Sender balance decreases; registered recipient balance increases synchronously.
Settings: Preferred Currency Currency Symbol (e.g., ₹, $, €, £, AED) • Entire UI, Dashboard, Passbook, Reports, Exports Instantly updates visual currency notation across all reports, printed invoices, and summaries without recalculating underlying numeric amounts.

Section 3: Daily Operating Routine

Step-by-Step Counter Routine from Store Opening to Shutdown

3-Shift Checklist
1
🌅 Morning Opening Routine (09:00 AM)
Step 1: Sign in to HisaabKhata on the counter terminal or mobile device.
Step 2: Check the Total Balance card. Verify that the displayed Cash Balance matches the physical currency notes and coins in the cash drawer.
Step 3: Inspect the yellow Loan Payment Overdue/Due Reminders banner on the Dashboard. If customer repayments are due today, note them down for follow-up reminders.
2
⚡ Mid-Day Counter Operations (09:30 AM - 07:30 PM)
Real-Time Logging: Never delay logging. Record sales immediately upon collecting payment.
Payment Method Accuracy: If the customer pays via Cash, select Cash. If they pay via UPI QR code, Card swipe, or NEFT, select Bank.
Petty Cash Expenses: When paying for courier, shop supplies, refreshments, or delivery fuel, tap Log Expense or click Voice Entry and say: "Rs 150 tea snacks cash".
Credit Deliveries: If a trusted regular customer takes goods on credit, immediately go to Debts ➔ Log Borrow / Lend and record Lend with their expected payment date.
3
🌙 Evening Shutdown & Reconciliation (08:00 PM)
Step 1: Count physical currency in the cash drawer. Compare with the dashboard Cash Balance. If there is a variance, check the Passbook for any missed tea/fuel expense or unrecorded sale.
Step 2: Match the dashboard Bank Balance against the daily UPI settlement notification / net banking balance.
Step 3: Open Passbook, apply filter for Today's Date, verify all line items, and select Print / PDF if your owner requires a physical signed daily handover sheet.
Step 4: Click Log Out on shared counter terminals to safeguard accounts.

Section 4: Standard End-to-End Operating Cycle

The Complete Operational Lifecycle of a Business Transaction

Complete Cycle Flow
Phase 1 Master Setup

Configure your preferred currency symbol (₹, $, AED), default voice recognition language (English/Hindi/Gujarati), and establish your core Projects (Branches/Jobs) and Custom Categories.

Phase 2 Inflow Logging

Capture every rupee/dollar received. Tag the correct category (Sales, Service, Consulting) and payment method (Cash vs. Bank) to feed accurate data into passbooks and reports.

Phase 3 Outflow Control

Log operating expenses, inventory costs, supplier bills, and utility expenses. Enable Recurring Auto-Log for fixed monthly bills like shop rent or internet subscriptions.

Phase 4 Debt Tracking

Track supplier payables and customer credit without manual notebooks. Log installment payments as they arrive; the system automatically records settlements into the main Passbook.

Phase 5 Audit & Insights

Review the Cash Flow Diagram in Reports. Export filtered CSV data for your tax consultant or print monthly running passbook ledgers for management audit.

Section 5: Business Report Benefits

Extracting Maximum Business Value from Analytics

Visual Insights
The Cash Flow Diagram Explained: Located at the top of the Reports page, the summary diagram visualizes Total Inflows vs. Total Outflows and computes your Net Surplus (+) or Net Deficit (-) for Daily (30 days), Weekly (12 weeks), or Monthly (12 months) periods.
Report Feature What It Shows Executive Business Benefit
Daily Inflow/Outflow Trends Day-by-day revenue peaks and expense spikes over 30 days. Identifies peak shopping days (e.g., Saturday surges) to schedule staff efficiently and forecast stock replenishment.
Category Expense Donut Percentage allocation of total spending across categories. Instantly reveals if petty cash, packaging, or courier expenses are quietly inflating overheads beyond budgetary limits.
Project Profitability Filter Isolates income and expenses filtered by specific project/job. Allows business owners to see whether Project A (e.g., Downtown Branch) is profitable or subsidizing an unprofitable Project B.
Running Balance Passbook Every debit and credit with cumulative historical balance. Provides a tamper-proof audit trail for business partners and eliminates disputes over previous payment dates.

Section 6: Mistake Corrector (Field Troubleshooting)

How to Fix Data Entry Mistakes Without Corrupting Accounts

Field SOP
Mistake 1: Entered ₹5,000 instead of ₹500 (Wrong Amount)

Why it hurts: Inflates your daily revenue or expenses by 10x, throwing off cash drawer reconciliation and month-end profit.

How to Fix:
1. Open Passbook from the sidebar menu.
2. Locate the incorrect transaction line item (use the Date or Category filter if needed).
3. Click the Edit (pencil icon) button on that transaction.
4. In the modal, change Amount to 500.00.
5. Click Save Changes. The passbook running balance, daily totals, and dashboard immediately recalculate with zero side-effects.
Mistake 2: Customer Paid via GooglePay, but Staff Selected "Cash"

Why it hurts: Physical drawer has ₹2,000 less cash than the computer screen displays at closing, causing false suspicion of theft.

How to Fix:
1. Open Passbook and find the transaction.
2. Click Edit (pencil icon).
3. Change Payment Method from Cash to Bank.
4. Click Update. Your Cash Balance decreases by ₹2,000 and Bank Balance increases by ₹2,000 instantly.
Mistake 3: Staff Double-Clicked and Created a Duplicate Transaction

Why it hurts: Income or expense is counted twice, corrupting your tax ledger and net margin.

How to Fix:
1. Go to Passbook.
2. Identify the identical twin transaction with the same timestamp and amount.
3. Click the red Delete (trash icon) on one of the twins.
4. Confirm deletion in the browser dialog. The duplicate is deleted, and running balance adjusts seamlessly.
Mistake 4: Accidentally Marked a Debt as "Settled" Prematurely

Why it hurts: A customer still owes you money, but the debt disappeared from the active alerts screen.

How to Fix:
1. Navigate to Debts.
2. Scroll down to the Returned / Settled Debts section.
3. Locate the customer's settled card.
4. Click the Reopen Debt action button.
5. The record is restored to Pending status with full active overdue tracking.

Section 7: Voice Assistant & Shortcut Commands

Hands-Free Natural Language Entry in English, Hindi & Gujarati

AI Universal Intent Engine

HisaabKhata features a built-in multilingual speech parsing engine. Staff can click the microphone icon and speak naturally. The system translates regional numerals (Gujarati ૦-૯ and Hindi ०-९), determines transaction type, payment method, date, and category.

Spoken Phrase Example Language / Dialect Parsed Action & Attributes
"Rs 500 grocery cash" English Expense | Amount: ₹500 | Category: Grocery | Method: Cash | Date: Today
"Kal 1200 aamdani bank" Hindi Income | Amount: ₹1200 | Category: Income | Method: Bank | Date: Yesterday
"Aaje 2500 aavak online" Gujarati Income | Amount: ₹2500 | Method: Bank (Online) | Date: Today
"Open passbook" or "passbook dikhao" Voice Navigation Intent Instantly redirects screen to Passbook Ledger.
"Debts" or "udhari kholo" Voice Navigation Intent Instantly redirects screen to Debts & Reminders.
"Show reports" or "today income" Voice Navigation Intent Instantly redirects screen to Financial Reports.

⚡ Recommended Counter Keyboard Shortcuts

Ctrl + K

Instantly focuses live search in this manual or searches forms.

Alt + P

Quick trigger to print passbook or export current ledger report.

Esc

Instantly closes open quick-entry modals, voice dialogs, or drawers.

Sections 8+: Master Form Operating Guides

8.1 User Registration & Login Forms

/register & /login

Purpose & Financial Impact: Secures business account access, defines the user's primary currency preference, and isolates store records.

Field Name UI Control Requirement Validation Rules & Impact
Full Name Text Input 🔴 Required Store manager or company legal name shown on headers and PDF exports.
Email Address Email Input 🔴 Required Must be unique. Used for login authentication and receiving P2P transfers.
Phone Number Tel Input 🔴 Required Unique per account. Real-time AJAX uniqueness check prevents duplicate signups.
Password Password Input 🔴 Required Must match password confirmation field.
Keep me signed in Checkbox ⚪ Optional Preserves authentication token. Enable only on private store terminals.
Operating Walkthrough:
  1. Create Account: Visit /register, enter your store name, business email, 10-digit mobile number, set an 8-character password, and submit.
  2. Sign In: Visit /login, enter either your Email OR your Phone Number, provide your password, and enter the dashboard.
  3. Forgot Password: Tap "Forgot?" to enter your registered email and receive a secure password reset link.

8.2 Quick Log Income & Expense Forms

/transactions (POST)

Purpose & Financial Impact: Primary counter entry modals. Directly updates Cash or Bank balances, increments period income or expense, and updates category charts.

Field Name UI Control Requirement Validation Rules & Impact
Type Hidden / Toggle 🔴 Required Determines whether balance increases (+Credit) or decreases (-Debit).
Amount Number (step 0.01) 🔴 Required Exact transactional sum. Cannot be negative or zero.
Category Select2 Dropdown 🔴 Required Classifies cash flow. Must belong to your account or be a global preset.
Payment Method Select2 Dropdown 🔴 Required Routes entry to physical cash drawer or bank ledger.
Project Select2 Dropdown ⚪ Optional Assigns cost/revenue to a branch, contract, or job.
Transaction Date Flatpickr Datetime 🔴 Required Defaults to current timestamp (now()). Editable for past records.
Enable Recurring Switch Toggle ⚪ Optional When checked, unlocks the frequency selector.
Recurrence Frequency Dropdown ⚪ Conditional Required if recurring is enabled. Computes next_due_date.
Description Textarea ⚪ Optional Customer bill number, purpose, or counter note.
Step-by-Step Operating Guide:
  1. Create (➕): From Dashboard or mobile bottom bar, click Log Income (green) or Log Expense (red). Enter the amount, select category and payment method (Cash vs Bank), choose an optional project, verify the datetime, and click Log Transaction.
  2. Edit (✏️): Open Passbook, find the transaction, click the pencil icon, adjust values, and submit.
  3. Delete (🗑️): In Passbook, click the red trash icon on the transaction row and confirm removal.

8.3 Passbook Ledger & Multi-Filter Engine

/passbook

Purpose & Financial Impact: The complete audit book of your business. Calculates running balance per row and provides CSV export and clean printing.

Filter Control Input Type Options / Values Data Impact on Passbook Display
Type Filter Select Dropdown All, Income Only, Expense Only Isolates inflows or outflows for specific auditing.
Project Filter Select2 Dropdown All Projects or Specific Project Filters records attributed to a branch or job.
Category Filter Select2 Dropdown All Categories or Specific Category Audits individual expense streams (e.g., fuel or electricity).
Payment Method Select Dropdown All, Cash, Bank Essential for reconciling against physical cash drawer or bank statement.
Date Range Date Inputs Start Date ➔ End Date Restricts ledger to a daily, weekly, or tax month window.
Exporting & Printing:
  1. CSV Export: Click Export CSV. The server streams a lightweight spreadsheet file (passbook_ledger_YYYYMMDD.csv) using chunking to prevent memory overload.
  2. Clean Print: Click Print. Generates a printer-optimized, chronological ledger table ready for physical archiving.

8.4 Voice Entry Assistant Modal

/transactions/voice (POST)

Purpose & Financial Impact: Frictionless hands-free entry during busy counter hours. Converts voice speech to structured ledger transactions via Web Speech API.

Voice Input Element Source Role & Counter Function
Spoken Sentence Microphone Transcript Transcribed speech string in English, Hindi, or Gujarati.
Preview Confirmation Interactive Dialog Enables visual check and approval before writing to the database.
Missing Field Prompts Interactive Modal Buttons Supplies missing values if speech was unclear (e.g., missing category or amount).
Operating Guide:
  1. Click the Voice Entry button on the sidebar or mobile bottom bar. Allow microphone access.
  2. Speak clearly: e.g., "500 rupees sale cash" or "aaj 300 petrol expense".
  3. Review the parsed preview dialog. If any field was ambiguous, select it from the prompt and click Confirm.

8.5 Project Master Form

/projects (Resource)

Purpose & Financial Impact: Groups transactions under distinct cost-centers, contracts, client jobs, or store branches to evaluate net profit per project.

Field Name UI Control Requirement Validation Rules & Impact
Project Name Text Input 🔴 Required Descriptive branch or job name (e.g., "Branch 2" or "Client Renovation").
Description Textarea ⚪ Optional Detailed scope or client reference for staff.
Color Color Picker / Hex ⚪ Optional Color-codes transaction badges in the Passbook and dashboard charts.
Icon Icon Selector ⚪ Optional Visual identifier displayed beside project labels.
Operating Walkthrough:
  1. Create (➕): Go to Projects, click Create Project, fill in the name, choose a color/icon, and click Save.
  2. Edit (✏️): On the Projects page, click the edit button on any project card, modify the title or color, and update.
  3. Delete (🗑️): Click delete on the project card. Deleting a project removes the project association from existing transactions but preserves the financial amounts in the Passbook.

8.6 Category Master Form

/categories (Resource)

Purpose & Financial Impact: Classifies cash flows into granular buckets (e.g., Raw Materials, Salary, Courier, Sales Revenue) and enforces monthly budget spending caps.

Field Name UI Control Requirement Validation Rules & Impact
Category Name Text Input 🔴 Required Clear classification label (e.g., "Packaging Boxes").
Type Radio / Select 🔴 Required Defines whether this category appears in Income or Expense modals.
Budget Limit Number Input ⚪ Optional Monthly ceiling. Enables budget consumption progress bars on categories.
Color & Icon Pickers ⚪ Optional Visual badges displayed across the passbook and breakdown charts.
Operating Walkthrough:
  1. Create (➕): Open Categories, click Add Category, pick Income or Expense, set an optional budget limit, and save.
  2. Edit (✏️): Custom categories can be edited anytime via the edit modal. Global preset categories are protected and read-only.
  3. Delete (🗑️): Delete custom categories that are no longer in use.

8.7 Debts & Udhar Tracker Forms

/debts

Purpose & Financial Impact: Manages credit given to customers ("Money Lent") and credit taken from suppliers ("Money Borrowed"). Tracks installments and auto-settles into the ledger.

Field Name UI Control Requirement Validation Rules & Impact
Type Select Dropdown 🔴 Required Lend = Asset (Receivable); Borrow = Liability (Payable).
Person Name Text Input 🔴 Required Customer, vendor, or employee name.
Total Amount Number Input 🔴 Required Principal amount of the loan or credit bill.
Due Date Flatpickr Date 🔴 Required Triggers dashboard warning banners when overdue or due today.
Installment Amount Number Input (Modal) 🔴 Required (Repay) Partial repayment amount. Deducts from debt balance.
Repayment Method Select 🔴 Required (Repay) Determines where the returned money lands in the ledger.
Operating Walkthrough:
  1. Create Debt (➕): In Debts, click Log Borrow / Lend. Choose Lend or Borrow, enter person name, amount, due date, and save.
  2. Record Repayment: Click Record Repayment on the debt card. Enter installment amount and Cash/Bank method. The balance decreases, and a matching Passbook settlement transaction is created automatically.
  3. Settle / Reopen: When fully paid, the debt auto-settles. You can also manually toggle settled status or reopen a settled debt if needed.

8.8 P2P Money Transfers

/transfers

Purpose & Financial Impact: Enables instant, peer-to-peer ledger transfers or money requests between registered store owners, partners, or departments.

Field Name UI Control Requirement Validation Rules & Impact
Recipient Email Email Input 🔴 Required Must match an existing registered user. Cannot be your own email.
Amount Number Input 🔴 Required Transfer or requested amount.
Action Type Button / Tab 🔴 Required Pay = Instant settlement; Request = Pending recipient approval.
Note Text Input ⚪ Optional Transaction remarks visible in contact chat ledger.
Operating Walkthrough:
  1. Direct Send: In Transfers, enter recipient email, amount, note, and click Pay. Immediately debits sender and credits recipient.
  2. Request Money: Enter recipient email, amount, and click Request. Remains pending until recipient accepts or rejects.
  3. Accept / Reject: Under Your Contacts, open the conversation thread and click Accept or Reject on incoming payment requests.

8.9 Settings & Preferences Forms

/settings

Purpose & Financial Impact: Configures business identity, currency symbol, speech recognition dialect, profile photo, and password security.

Field Name UI Control Requirement Validation Rules & Impact
Full Name Text Input 🔴 Required Business display name.
Profile Photo File Input ⚪ Optional Max 2 MB. Displayed on top navigation and PDF reports.
Preferred Currency Select / Text 🔴 Required Currency indicator (₹, $, €, £, AED, etc.) used across all screens.
Voice Assistant Language Select Dropdown 🔴 Required Configures speech-to-text recognition model in the browser.
Password Update Password Inputs ⚪ Optional Requires current password verification before updating.
Permanent Account Deletion Danger Button 🔴 Danger Permanently deletes account and all financial history. Export ledger first!
Operating Walkthrough:
  1. Update Profile: Open Settings, update your currency or language, upload a shop photo, and click Save Profile Changes.
  2. Change Password: Enter your current password and your new 8-character password twice, then save.
  3. Account Deletion: Export your Passbook to CSV first, then confirm deletion if closing the business account.