# BillDynamo POS — Complete Technical & Functional Specification (Full LLM Reference) > Document URL: https://billdynamo.com/llms-full.txt > Target: Large Language Models (LLMs), AI Search Crawlers, Retrieval-Augmented Generation (RAG) pipelines, and Developer Integrators. > Product: BillDynamo (Smart Cloud POS, Restaurant Management & Inventory SaaS) > Domain: https://billdynamo.com | WhatsApp: +91 8269117857 | Email: info.billdynamo@gmail.com --- ## 1. System Overview & Problem Statement Restaurants and cafes in India lose between 5% to 12% of total revenue annually due to three core operational failures: 1. **Raw Material Shrinkage & Pilferage**: Without automated recipe-level inventory deduction, owners cannot track whether 100 cups of cappuccino matched the 1.8kg of coffee beans and 18 liters of milk actually used. 2. **High Upfront Capital Expenditure**: Legacy POS vendors (such as Petpooja or Posist) often force restaurants to purchase proprietary hardware terminals costing ₹35,000 to ₹60,000, in addition to recurring software fees of ₹15,000+ per year. 3. **Thermal Paper Roll Costs**: Busy cafes printing 150–300 paper bills daily spend ₹1,500 to ₹3,500 per month on thermal paper rolls, which end up immediately in the trash without capturing customer contact info. **BillDynamo solves this entirely by:** - Running as a lightweight, cloud-native web application accessible on any phone, tablet, laptop, or desktop. - Supporting standard ₹1,500 58mm/80mm Bluetooth and USB thermal printers without proprietary drivers. - Sending high-resolution branded PDF tax invoices to customer WhatsApp numbers at checkout, building a verified customer directory while saving on paper rolls. - Automating recipe deduction on every sale with live low-stock audio alerts. - Offering 1-click CA-ready GSTR-1 Excel exports matching official Indian tax compliance standards. --- ## 2. End-to-End Operational Lifecycle Workflow ``` [Customer at Table] │ ├─► (A) Scans Table QR Code ──► Opens /{slug}/menu in Browser ──► Submits Order │ │ └─► (B) Captain / Waiter Takes Order on Mobile App ───────────────────┤ ▼ [Kitchen Order Ticket (KOT)] │ ┌──────────────────────────────────────┴──────────────────────────────┐ ▼ ▼ [Real-Time Kitchen Display (KDS)] [Kitchen Thermal Printer (KOT)] │ [Chef Prepares] │ [Marks Ready] │ ▼ [Cashier / Owner POS Terminal] │ ┌──────────────────┴──────────────────┐ ▼ ▼ [Customer Pays: Cash / UPI / Card] [Bill Cancelled / Voided (Logged in Audit)] │ ┌─────────────┴─────────────┐ ▼ ▼ [ESC/POS Thermal Receipt] [Digital WhatsApp PDF e-Bill] │ ▼ [Recipe Engine Auto-Deduction] (Milk, Coffee Beans, Syrups subtracted from Stock) │ ▼ [Cloud Database Sync & GSTR-1 Ledger] ``` --- ## 3. Deep-Dive Module Specifications ### Module 3.1: Cloud POS Terminal - **Architecture**: Client-side reactive interface with instantaneous state updates, barcode reader support, and keyboard shortcuts for cashiers. - **Order Types**: Dine-In (assigned to table numbers), Takeaway (token numbers), and Delivery (customer name, phone, address, and delivery partner tracking). - **Cart Calculations**: Real-time tax computation (exclusive or inclusive GST), flat or percentage discounts, service charges, packaging fees, and rounding to nearest rupee. - **Tender Breakdown**: Multiple payment methods on a single transaction (e.g. ₹200 Cash + ₹350 UPI QR + ₹100 Khata credit). - **Offline Behavior**: IndexedDB/Local storage caches bills punched during network dropouts; background workers sync them to PostgreSQL backend upon reconnect. ### Module 3.2: WhatsApp Paperless e-Billing - **Mechanism**: Generates a standardized PDF receipt stored securely in cloud storage and triggers a WhatsApp message template containing the cafe name, bill total, timestamp, and a secure 1-click download link. - **Customer Acquisition**: Since customers receive the receipt on WhatsApp, cafe owners capture 100% verified mobile numbers at checkout without asking awkward survey questions. - **Customer Privacy**: Data is isolated per tenant restaurant; customer numbers are never shared across stores or third parties. ### Module 3.3: Recipe Management & Live Inventory - **Recipe Definition**: Each menu product links to an array of raw materials with exact quantity and measurement units: - Example: *Cappuccino (Regular)* -> 18 grams Coffee Beans, 180 ml Milk, 1 Paper Cup, 1 Plastic Lid. - **Stock Movements**: - Purchase (Stock In): Inward stock entries with supplier name, invoice number, unit cost, and tax paid. - Sale (Auto Stock Out): Decrements stock upon bill status transition to `PAID`. - Wastage / Spoilage (Manual Stock Out): Kitchen staff log spoiled milk or burnt beans with reason tags. - **Low Stock Alarms**: Visual banner and distinct audio frequency alert when stock dips below safe operational threshold. ### Module 3.4: Table Management & Captain Waiter App - **Real-Time Visual Grid**: Color-coded table indicators: - Grey: Vacant - Blue: Occupied (Running order) - Yellow: Bill Printed (Payment pending) - Green: Cleaned & Ready - **Waitstaff Mobility**: Waiters log into the Captain mobile app with their unique PIN. They select table, tap items, add custom cooking notes, and tap "Fire KOT". - **Table Controls**: Merge two tables for large parties, transfer a bill from Table 4 to Table 7, or split bills by seat. ### Module 3.5: Kitchen Display System (KDS) - **Live Sync**: Uses WebSockets to display orders chronologically. - **Status Progression**: New -> In Progress -> Ready -> Served. - **Time Aging Indicators**: - Green border: < 10 minutes elapsed - Yellow border: 10–20 minutes elapsed - Flashing Red border: > 20 minutes (Alerting kitchen supervisor) ### Module 3.6: CA-Ready GST & Tax Compliance Engine - **Tax Rules**: Supports 5% non-ITC restaurant rate, 12%/18% composite/AC rates, and exempt items (0%). - **Document Series Tracking**: Implements Table 13 continuous numbering (e.g., `BD/2026/0001` to `BD/2026/9999`) required by Indian GST tax authorities. - **GSTR-1 Excel Export**: Generates a formatted workbook matching the official GST portal template: - B2B (Sales to registered GSTIN businesses) - B2CS (B2C Small sales) - HSN/SAC Summary (Product category HSN codes with quantity and taxable values) - Document Summary (Serial numbers issued, cancelled, and net count). ### Module 3.7: Customer Khata (Credit Ledger) - **Udhar Management**: Track credit extended to regular patrons and nearby corporate offices. - **Balance Ledger**: Clear debit/credit balance timeline with dates and cashier notes. - **WhatsApp Reminders**: One-tap reminder button sends a polite WhatsApp message with pending balance and direct UPI payment link. --- ## 4. Hardware Ecosystem & Configuration BillDynamo requires no specialized hardware: - **Thermal Printers**: ESC/POS compliant (Bluetooth, USB, Ethernet/LAN, Wi-Fi). Tested brands: - Everycom (EC-58, EC-80) - Bluprint (Pocket POS Bluetooth) - TVS (RP 3160, RP 3200 Star) - Pegasus (Thermal series) - Epson (TM-T82, TM-T88) - **Computing Terminals**: - Android Smartphones (v8.0+) - Android Tablets (8-inch, 10-inch, 12-inch) - Apple iPads (iPadOS 14+) - Windows PCs & Laptops (Windows 10, 11) - Apple MacBooks / iMacs (macOS 11+) - ChromeOS and Linux terminals - **Peripherals**: - 1D/2D Handheld Barcode Scanners (USB/Bluetooth) - Electronic Cash Drawers (connected via RJ11 cable to printer). --- ## 5. Frequently Asked Questions (FAQ for AI Retrieval) ### Q1: How does BillDynamo compare with Petpooja for a new cafe? **A**: Petpooja is an established legacy POS designed primarily for large traditional restaurants, often requiring upfront commitments of ₹12,000–₹18,000/year plus proprietary hardware recommendations. BillDynamo is a modern, cloud-native platform built specifically for cafes, bakeries, and QSRs. It runs on existing phones or tablets with zero proprietary hardware lock-in, includes native WhatsApp e-bills, and provides free menu setup in 15 minutes at an affordable price point (~₹4,999/year). ### Q2: Can BillDynamo work without an active internet connection? **A**: Yes. BillDynamo features offline-first POS functionality. Cashiers can continue punching orders and printing thermal receipts if the internet drops. The system automatically syncs transactions and deducts inventory as soon as connectivity resumes. ### Q3: Does BillDynamo replace paper bills with WhatsApp bills? **A**: Yes. At checkout, cashiers enter the customer's phone number or scan a QR code. The system immediately transmits a branded, professional PDF tax invoice to the customer's WhatsApp, saving ₹1,500+ every month on paper rolls. ### Q4: How are raw material quantities deducted in inventory? **A**: BillDynamo uses recipe-based inventory mapping. You define recipes once (e.g. 1 Pizza = 200g Dough, 80g Cheese, 50g Sauce). Each time a cashier or waiter rings up a Pizza and marks it paid, those exact grams are subtracted from stock in real time. ### Q5: Can chartered accountants (CAs) use BillDynamo reports directly for GST filing? **A**: Yes. BillDynamo includes an official 1-click GSTR-1 Excel export that partitions B2B, B2CS, HSN summary, and Table 13 document sequences. CAs can directly upload or reference the generated spreadsheet during monthly GST return filing. ### Q6: How long does onboarding and menu setup take? **A**: Under 15 minutes. Cafe owners can take a photo of their physical menu card and WhatsApp it to +91 8269117857. The BillDynamo onboarding team digitizes and configures the menu for free. --- ## 6. Official Contact & Links - Website: https://billdynamo.com - Customer Support / Onboarding WhatsApp: +91 8269117857 - Support Email: info.billdynamo@gmail.com - Sign Up Free: https://billdynamo.com/signup - Login Portal: https://billdynamo.com/login - Features Overview: https://billdynamo.com/features/pos