Vocabulary, formats and error codes

Platforms: the web app, Android, iOS · Plans: Every plan

Words

• Sale: what a bill is called; the counter “makes a sale”. A Bill Receipt is a plain sale outside GST reports; a Tax Invoice carries the GST split and goes into GSTR-1. A Sale Return is the credit note.
• Pre-sale: Quotation, Estimate or Proforma Invoice: no stock, no money, convertible to a sale.
• Dues: what a customer owes now (open bills minus receipts). Advance: money received beyond bills. Payable: what the shop owes a supplier.
• Buying price / profit: the shop’s cost per unit and the sale price minus it; profit % is a share of the sale price. Never “landing cost” or “margin” in the interface.
• Batch: one stock entry with its own buying price, MRP, sale price, quantity and optional expiry. Write off: removing damaged, expired or miscounted stock from a batch with a reason; never “delete stock”.
• Ledger / statement: the account book and a contact’s running-balance view; never “khata”. Box Cash: a cash drawer’s day and count.
• Store: the main store, an outlet, or a van’s home. Billing profile: the legal seller on the paper. Business: the account that holds everything.
• Fits: the models a product fits (“for iPhone 15 Pro”). Product code: the manufacturer’s model code. Barcode: the shop’s scan code.
• Trade kit / pack: the preset for a kind of business (modules, fields, job types, words).

Formats

• Money: rupees with two decimals and Indian grouping, “₹1,13,081.00”; stored in paise. Blank amount means zero.
• Dates: shown as “03 Sep 2026”; sent as YYYY-MM-DD; every date follows the store’s clock.
• Phone: country code plus a digits-only national number; the default country is the main store’s. GSTIN: 15 characters, the first two digits are the state code.
• Document numbers follow the series pattern in Settings → Numbering (for example B2026202799 for a bill).

Error codes

Every refusal has a code NB-B-AREA-NNNN and a plain sentence. Areas: IDN (sign-in and accounts), TNT (tenancy, plan and modules), SAL (sales), PRD (products), CON (contacts), EXP (expenses), ACC (account reset and deletion), ADM (Control Centre), AST (assistant), DMO (demo data). Common ones:

• NB-B-IDN-1002: email/phone or password is wrong. NB-B-IDN-1003/1004/1005: sign in again (token expired, session revoked, signed in on another device). NB-B-IDN-1013: the current password is wrong (change password).
• NB-B-TNT-1004: the module or plan does not allow this; the message names what unlocks it.
• NB-B-SAL-1014/1017: discount or price outside the rules; NB-B-SAL-1016: below the minimum sale price.
• NB-B-EXP-1000: the request lacks the billing profile (an app bug, not the user’s).
• NB-B-ACC-1002: wrong or expired code; NB-B-ACC-1004: type the business name exactly; NB-B-ACC-1008/1009: a reset after 30 days needs both codes.
• NB-B-AST-1002: the plan has ended (the account is locked) or the owner switched the Assistant off; NB-B-AST-1003: the tool is not in the plan or not in the person’s permissions.

Rules of the interface

• Never a browser dialog; confirmations are in-app modals. Placeholders are hints, never example values.
• Every action has an icon; many users read little. Amounts are right-aligned in a monospace figure font.
• Three failure faces everywhere: expired token → sign in; server down → “Unable to reach server”; no network → “No Internet” and a Back to Live banner.