SENBA help

Step-by-step guides for getting started, billing, inventory, GST returns, invoice design, devices and reports. Also available inside the app under Help β€” no internet needed there.

πŸš€ Getting started 🧾 Billing πŸ“¦ Inventory πŸ›οΈ GST & reports β—‰ Accounting 🍽 Restaurant POS βš™ Settings

πŸš€ Getting started

Install SENBA, sign in, and record your first sale.

Install and sign in
  1. Run the SENBA installer for your OS and launch the app.
  2. On first launch the database is created automatically; if the browser does not open, go to http://127.0.0.1:5000/ yourself.
  3. Sign in as admin / admin123 β€” you will be asked to change the password immediately.
  4. Rename "My Business" under Settings β†’ Company Profile, then activate your license.

πŸ’‘ Keep the black server window open while you work β€” closing it stops the app.

Set up your company
  1. Settings β†’ Company Profile: enter business name, address, GSTIN (if registered), state, and invoice prefixes.
  2. Manage Users: create one login per staff member; give counter staff only the permissions they need.
  3. Backup & Restore: confirm automatic backups are on before entering live data.

πŸ’‘ No GSTIN yet? Leave it blank β€” the app files you as unregistered and skips GST billing until you add it.

Your first sale bill
  1. Sales β†’ New sale bill: pick the customer (or type a 10-digit mobile to create a walk-in customer).
  2. Add items by typing in Item / Description (3+ letters trigger search) or by scanning a barcode in the scan box.
  3. Check totals, record counter payment if money changed hands, then Save & Finalize.
  4. Print or share the bill from the saved-bill panel.

πŸ’‘ Draft bills affect nothing until finalized β€” stock, ledger and GST all wait for Finalize.

🧾 Billing

Sale bills, purchase bills, parties, and payments.

Create a sale bill
  1. Sales: pick customer, series, and date; add one or more lines.
  2. Each line needs a description, quantity and rate; HSN, discount and tax default from the item master.
  3. Counter payment (optional): enter amounts per method β€” Cash/UPI/Card/Cheque or Credit. Split rows auto-balance.
  4. Save & Finalize posts stock, ledger and GST in one step.

πŸ’‘ Counter payment shows only when enabled in Settings and only for new final invoices β€” record payments on old bills from Money.

Use the Counter Terminal
  1. Open Counter Terminal from the sidebar (retail trades). Restaurant/hotel businesses use Restaurant POS instead.
  2. Turn on POS Billing Mode in Settings β†’ Security & Preferences for scanner-first entry and MRP pricing.
  3. Scan a barcode or search an item; Enter adds it, and scanning the same item again raises its quantity.
  4. Save & Finalize; when counter payment is enabled the Record Receipt window opens for Cash/UPI/Card.

πŸ’‘ The terminal is locked to billing β€” staff cannot wander into masters or settings from it.

Record a purchase bill
  1. Purchases β†’ New bill: pick the supplier and enter their bill number and date.
  2. Add lines with quantity, rate and tax exactly as the supplier charged.
  3. Finalize to update stock cost (moving average) and input tax credit.

πŸ’‘ The MRP column on purchase lines updates the item master β€” useful when the supplier changes printed prices.

Scan a supplier bill
  1. Purchases β†’ Scan Bill: upload a photo/scan or a PDF. PDFs are rendered in the browser first 3 pages.
  2. Text is read offline by the bundled Tesseract engine; a configured Bill Scan AI key handles tricky layouts, then the local parser and supplier rules fill the review form.
  3. Check supplier, bill number, date, line items, taxable value and grand total on the review screen, then save through the normal purchase flow.
  4. On a phone, choose Phone upload: scan the QR, photograph the bill, and the filled draft appears on the computer.

πŸ’‘ Add a new supplier layout in Settings β†’ Email & AI β†’ Bill recognition rules β€” no rebuild or update needed.

Customise the invoice design
  1. Open Invoice Designer (admin) from the sidebar.
  2. Start from a preset β€” Standard, Services (SAC), Compact (A4), Export / SEZ, POS / Retail, Tally, Marg or Pharmacy β€” or edit the current design.
  3. Adjust header layout, colours, item columns, labels, fonts, paper, and section order; the preview is the print layout.
  4. Save it as a template, then Apply to invoices. Browser print, PDF download, email and WhatsApp all use the same design.

πŸ’‘ Presets carry their own header: Colored/Rose/Export centered, Minimal/Midnight/Compact left, Forest/Services boxed.

Parties and items
  1. Parties: one master for customers and suppliers β€” name, phone, GSTIN and state decide B2B vs B2C automatically.
  2. Items: name, HSN/SAC, unit, tax rate and prices. Set gst_type to services for SAC-based lines.
  3. Use Item Lists for quick repeat assortments (e.g. monthly kit).

πŸ’‘ A wrong HSN or goods/services flag follows the item everywhere β€” fix it in the master, not per bill.

Payments, receipts and credit
  1. Money β†’ Receipt records money received against a bill; Payment records money paid out.
  2. Apply Credit links advances and credit notes to open bills, oldest first.
  3. The Docs list shows Paid / Partial / Unpaid per bill from these links.

πŸ’‘ Editing a bill never auto-pays it β€” record money separately in Money.

Keyboard shortcuts and command palette
  1. Press Ctrl+K (Cmd+K on Mac) anywhere to open the command palette; type a page or action name, Enter to jump.
  2. On any bill: Alt+S (Cmd+S on Mac) or Ctrl+Enter saves and finalizes; Alt+N starts a new bill.
  3. On the Dashboard: Alt+N new sale, Alt+P new purchase, Alt+I new item, Alt+L new party.

πŸ’‘ The palette only lists pages your login can open β€” counter staff see billing, not settings.

πŸ“¦ Inventory

Stock levels, batches, godowns and counts.

Check stock
  1. Stock page: on-hand quantity and value per item, searchable by name, SKU or barcode.
  2. Open an item for batch-wise and godown-wise breakup (when tracked).
  3. Negative stock is blocked unless explicitly allowed in Settings.

πŸ’‘ A sale that fails on stock tells you which item and how short β€” adjust quantity or purchase first.

Batches, expiry and godowns
  1. Enable batch tracking per item to auto-assign oldest-first (FEFO) on sales.
  2. Expiry page lists soon-to-expire batches for clearance action.
  3. Enable godowns in Settings to track the same item across warehouses.

πŸ’‘ Purchase lines capture batch and expiry β€” enter them at goods-inward, not later.

Stock count and adjustments
  1. Do a physical count, then post a stock adjustment for differences with a reason.
  2. Adjustments revalue inventory and post to the stock-adjustment head.
  3. Every adjustment is audit-logged with who and when.

πŸ’‘ Count high-value items monthly, everything else quarterly β€” small frequent counts beat annual surprises.

πŸ›οΈ GST and reports

Returns, e-way bills, e-invoices and books.

Prepare GSTR-1
  1. Returns β†’ GSTR-1: pick month, review B2B / B2C / export tables from your final bills.
  2. Fix party GSTIN and place-of-supply errors flagged in the tables first.
  3. Export the JSON/CSV for the portal when totals agree with your books.

πŸ’‘ Cancelled bills stay visible in returns (as cancellations) β€” they are not deleted, by GST design.

Prepare GSTR-3B
  1. Returns β†’ GSTR-3B: outward and inward supplies summarize from the same finalized data.
  2. Compare input credit with GSTR-2B before filing; reverse ineligible credit via ITC Reversal.
  3. Lock the period in Settings after filing to prevent backdated edits.

πŸ’‘ Paise-level differences between GSTR-1 and 3B are usually per-line rounding β€” the tables tie by design.

E-way bills and e-invoices
  1. E-Way Bills: generate for goods movement above the threshold from an eligible bill.
  2. E-Invoices (IRN): available when enabled and turnover rules apply to the company.
  3. Both need portal credentials configured in Settings first.

πŸ’‘ Services never trigger e-way bills by themselves β€” only goods consignment value counts.

Books and backup
  1. Reports: trial balance, P&L, balance sheet, stock and GST summaries read live from the ledger.
  2. Backup & Restore: download compressed backups regularly; test a restore on a second machine yearly.
  3. Invoices are never deleted β€” cancel or credit-note them so the number series stays intact.

πŸ’‘ Before filing, take a backup β€” a filed period plus a backup is the only safe combination.

Filing countdowns on the dashboard
  1. The dashboard lists upcoming GSTR-1 / GSTR-3B due dates with days left β€” red means 3 days or less.
  2. Quarterly (QRMP) businesses see quarter-end dates; composition dealers see CMP-08 plus the annual GSTR-4.
  3. Dates come from Settings (registration type + filing frequency); unregistered businesses see nothing.

πŸ’‘ Use the Open GST Returns link under the countdowns to jump straight to filing.

β—‰ Accounting

Chart of accounts, journals, and financial reports.

Chart of accounts and journal entries
  1. Accounting β†’ Chart of Accounts: income, expense, asset, liability and equity heads come pre-seeded; add shop-specific heads as needed.
  2. Bills, payments and stock movements post journal entries automatically β€” you rarely type one by hand.
  3. For corrections, post a manual journal (debit one head, credit another) with a clear narration.

πŸ’‘ Every rupee in reports traces back to journal lines β€” if a report looks wrong, the journal tells you which bill caused it.

Trial balance, P&L and balance sheet
  1. Reports β†’ Trial Balance: every head with debit/credit totals β€” debits must equal credits, always.
  2. Profit & Loss shows income minus expenses for the period; Balance Sheet shows what the business owns vs owes.
  3. Filter by date range and company; export for your accountant when needed.

πŸ’‘ Run the trial balance monthly β€” an out-of-balance book means a half-posted entry that needs fixing before filing.

TDS, ITC reversal and reconciliation
  1. TDS / TCS page: track tax deducted on payments and receipts; Income Tax TDS lives under its own section.
  2. ITC Reversal: reverse ineligible input credit (personal use, exempt supplies) before filing GSTR-3B.
  3. Bank Reconciliation: match bank statement lines to book entries so the bank balance is real, not assumed.

πŸ’‘ Reconcile the bank every month β€” unmatched lines are usually unrecorded charges or double-entered receipts.

🍽 Restaurant POS

Counter billing, tables, kitchen display and day close.

Run counter and table sales
  1. Restaurant POS: open a table or start a counter sale, add items from the menu with quantities.
  2. Send the order to the kitchen (KOT) β€” the Kitchen screen picks it up instantly.
  3. Settle to a bill when the customer pays; counter payment methods work the same as retail sales.

πŸ’‘ KOTs fire per order round, not per item β€” batch a table’s additions before sending.

Kitchen display and day close
  1. Kitchen screen: incoming KOTs appear in order; mark items preparing, ready and served.
  2. Customer display (if configured) shows order status to waiting guests.
  3. At day close, settle all open tables first β€” unsettled tables carry into the next day’s list.

πŸ’‘ An unsettled table still holds its stock reserved β€” close it before running the day’s stock count.

βš™ Settings

Company profile, users, numbering, devices and backups.

Company profile and users
  1. Settings β†’ Company Profile: business name, address, phone, GSTIN, state and logos used on every bill.
  2. Manage Users: one login per staff member with role and permissions β€” counter staff get billing only, managers get reports and settings.
  3. Each user changes their own password; admins can reset a forgotten one.

πŸ’‘ Never share the admin login at the counter β€” an action under the wrong user poisons the audit trail.

Numbering, taxes and locks
  1. Settings β†’ Documents & Series β†’ Numbering Format: invoice/purchase prefixes, yearly restart, and per-series counters.
  2. Tax settings: state of supply defaults, composition flag, and TDS mode β€” set once, reviewed yearly.
  3. After filing, set the books-lock date so backdated edits are blocked for the filed period.

πŸ’‘ Changing a prefix mid-year splits the number series β€” do it only at a financial-year boundary.

Devices, backup and integrations
  1. Printers: choose A4/thermal paper size, printer target and spooler options; test with one bill before a rush.
  2. Customer display, barcode scanner and POS billing mode live under their own Settings sections β€” enable only where the hardware exists.
  3. Backup & Restore: confirm automatic backups run daily and know where the files land; WhatsApp and email need their credentials configured before first send.

πŸ’‘ After any settings change, print one test bill β€” paper, taxes and numbering are cheapest to verify before customers queue.

Customer display
  1. Web display: open /customer?user=<login-id> on a second monitor or tablet β€” no login needed.
  2. On the shop PC: Settings β†’ Security & Preferences β†’ My Customer Display, choose the COM port/baud and use Test.
  3. When the app runs on a VPS, choose This browser (Web Serial) and Connect display from the shop PC (Chrome/Edge over HTTPS).
  4. Settled bills show the bill number, amount and a UPI QR when a VPA is configured.

πŸ’‘ Serial ports are machine-local: a remote server cannot open the shop PC’s COM port, so use Web Serial there.

License activation and check-in
  1. Enter the licence key from your purchase email on first run, or later from License / Manage License.
  2. The app checks in automatically at startup and every 6 hours; the 30-day online check-in renews without asking for the key again.
  3. Without internet, keep working through the offline grace period; the current status and days left are shown in Manage License.
  4. Renew or upgrade by entering the new key; a revoked key blocks business actions after the next successful check-in.

πŸ’‘ Keep the server clock correct β€” large clock changes can trip the licence tamper checks.

Appearance and landing screen
  1. Settings β†’ Appearance: Theme (this device) β€” System, Light, Dark, Slate, Navy, Forest, Lavender, Sepia, Paper, High contrast, Midnight, Ocean, Rose and Vuestic light/dark. Printouts always stay black-on-white. Table density lives here too.
  2. Settings β†’ Security & Preferences β†’ My Preferences β†’ Screen after login: Dashboard, New Sale Bill, Counter Terminal, or Restaurant POS. Restaurant/hotel trade defaults to Restaurant POS.
  3. Density (this device): Compact fits more table rows per screen; Comfortable is the default.

πŸ’‘ Theme and density are per device, not per user β€” the counter PC and your phone keep their own.