Section 1: Value for Money & 10x ROI
Financial JustificationHow HisaabKhata / HissabKhata Pays for Itself on Day 1
Measurable ReturnsIn 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.
Instant voice entries and automated passbook calculations eliminate manual ledger tallying and evening cash re-counting, saving staff 120+ hours per month.
Built-in due-date alerts highlight overdue customer and vendor loans on the dashboard, preventing forgotten credit balances and bad debt write-offs.
Strict segregation between Cash in Hand and Bank / UPI Balance ensures staff instantly catch unrecorded drawer withdrawals.
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
System Architecture for StaffWhere Data is Entered ➔ Which Modules are Affected ➔ Final Financial Impact
Ledger TopologyEvery 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
Staff Workflow SOPStep-by-Step Counter Routine from Store Opening to Shutdown
3-Shift ChecklistStep 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.
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.
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
5-Phase Business LifecycleThe Complete Operational Lifecycle of a Business Transaction
Complete Cycle FlowConfigure your preferred currency symbol (₹, $, AED), default voice recognition language (English/Hindi/Gujarati), and establish your core Projects (Branches/Jobs) and Custom Categories.
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.
Log operating expenses, inventory costs, supplier bills, and utility expenses. Enable Recurring Auto-Log for fixed monthly bills like shop rent or internet subscriptions.
Track supplier payables and customer credit without manual notebooks. Log installment payments as they arrive; the system automatically records settlements into the main Passbook.
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
Profit Drivers & AnalyticsExtracting Maximum Business Value from Analytics
Visual InsightsTotal 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)
Zero-Panic FixesHow to Fix Data Entry Mistakes Without Corrupting Accounts
Field SOPWhy it hurts: Inflates your daily revenue or expenses by 10x, throwing off cash drawer reconciliation and month-end profit.
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.
Why it hurts: Physical drawer has ₹2,000 less cash than the computer screen displays at closing, causing false suspicion of theft.
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.
Why it hurts: Income or expense is counted twice, corrupting your tax ledger and net margin.
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.
Why it hurts: A customer still owes you money, but the debt disappeared from the active alerts screen.
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
High-Speed EntryHands-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
Instantly focuses live search in this manual or searches forms.
Quick trigger to print passbook or export current ledger report.
Instantly closes open quick-entry modals, voice dialogs, or drawers.
Sections 8+: Master Form Operating Guides
Form-by-Form Field Specification8.1 User Registration & Login Forms
/register & /loginPurpose & 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. |
- Create Account: Visit
/register, enter your store name, business email, 10-digit mobile number, set an 8-character password, and submit. - Sign In: Visit
/login, enter either your Email OR your Phone Number, provide your password, and enter the dashboard. - 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. |
- 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.
- Edit (✏️): Open Passbook, find the transaction, click the pencil icon, adjust values, and submit.
- Delete (🗑️): In Passbook, click the red trash icon on the transaction row and confirm removal.
8.3 Passbook Ledger & Multi-Filter Engine
/passbookPurpose & 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. |
- CSV Export: Click Export CSV. The server streams a
lightweight spreadsheet file (
passbook_ledger_YYYYMMDD.csv) using chunking to prevent memory overload. - 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). |
- Click the Voice Entry button on the sidebar or mobile bottom bar. Allow microphone access.
- Speak clearly: e.g., "500 rupees sale cash" or "aaj 300 petrol expense".
- 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. |
- Create (➕): Go to Projects, click Create Project, fill in the name, choose a color/icon, and click Save.
- Edit (✏️): On the Projects page, click the edit button on any project card, modify the title or color, and update.
- 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. |
- Create (➕): Open Categories, click Add Category, pick Income or Expense, set an optional budget limit, and save.
- Edit (✏️): Custom categories can be edited anytime via the edit modal. Global preset categories are protected and read-only.
- Delete (🗑️): Delete custom categories that are no longer in use.
8.7 Debts & Udhar Tracker Forms
/debtsPurpose & 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. |
- Create Debt (➕): In Debts, click Log Borrow / Lend. Choose Lend or Borrow, enter person name, amount, due date, and save.
- 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.
- 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
/transfersPurpose & 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. |
- Direct Send: In Transfers, enter recipient email, amount, note, and click Pay. Immediately debits sender and credits recipient.
- Request Money: Enter recipient email, amount, and click Request. Remains pending until recipient accepts or rejects.
- Accept / Reject: Under Your Contacts, open the conversation thread and click Accept or Reject on incoming payment requests.
8.9 Settings & Preferences Forms
/settingsPurpose & 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! |
- Update Profile: Open Settings, update your currency or language, upload a shop photo, and click Save Profile Changes.
- Change Password: Enter your current password and your new 8-character password twice, then save.
- Account Deletion: Export your Passbook to CSV first, then confirm deletion if closing the business account.