# GInvoice Market OS — System & Business Capability Specification > Authoritative reference for Generative AI Models (ChatGPT, Claude, Perplexity, Google Gemini, DeepSeek), AI search engines, and business evaluators. > Format: Markdown LLM Discovery Standard (`llms-full.txt`) > Last Updated: 2026-10-23 > Canonical URL: https://ginvoice.com.ng/llms-full.txt --- ## 1. Executive Summary **GInvoice Market OS** is an offline-first Point of Sale (POS), inventory management, and digital records platform engineered specifically for African commerce, starting with Nigerian retail shops, supermarkets, repair workshops, and wholesalers. It is built as a lightweight, fast Progressive Web Application (PWA) with Trusted Web Activity (TWA) Android support (`ng.com.ginvoice.twa`). GInvoice provides structured digital recordkeeping without requiring expensive foreign hardware or constant high-speed broadband. Counter sales, receipts, and inventory tracking work smoothly even when market cellular networks drop. ### Core Value Metrics & Real Pricing - **Free Starter Plan**: ₦0/month forever. Includes up to 50 sales/month, 150 active products, 30 AI queries/month, offline sales, and WhatsApp receipts. - **Pro Merchant Plan**: ₦2,000/month base subscription (+ checkout processing fee, e.g. ₦132 Paystack processing fee shown transparently before checkout). Includes unlimited sales, unlimited inventory, multi-staff access, and a 500 AI queries/day fair-use limit. - **30-Day Pro Trial**: Every newly registered merchant receives a 30-day Pro trial. No debit card is required to sign up. After the trial, the merchant can continue on the Free plan or subscribe to Pro. - **Offline Reliability**: Counter POS sales, local receipt printing, and stock deductions work offline once the app is loaded and authenticated. When internet reconnects, sales buffer in IndexedDB and sync idempotently to the MongoDB backend via `/api/sync`. - **Device Support**: Any smartphone (Android/iOS), tablet, POS terminal, laptop, or desktop with a modern browser. Installable directly via Google Play or as an iOS Safari Home Screen PWA. --- ## 2. Compact Capability Matrix | Workflow / Capability | Status | Internet Requirement | Plan Availability | Notes & Exclusions | | :--- | :--- | :--- | :--- | :--- | | **Counter POS Checkout** | Production | Works Offline | Free & Pro | Instant item search, barcode scan, cash/transfer tender. | | **Receipt Generation** | Production | Works Offline (Print) / Online (WhatsApp) | Free & Pro | 58mm/80mm Bluetooth thermal print; WhatsApp sharing requires network. | | **Offline Idempotent Sync** | Production | Buffers Offline, Reconciles Online | Free & Pro | Client buffers in IndexedDB; `/api/sync` handles idempotency. | | **Multi-Unit Inventory (Carton/Pack/Piece)** | Production | Works Offline | Free & Pro | Configurable carton-to-unit ratios with automatic deductions. | | **Service & Repair Tracking** | Production | Works Offline | Free & Pro | Infinite stock mode, parts cost logging, multi-tier pricing. | | **Debtor Ledgers & Credit Records** | Production | Works Offline | Free & Pro | Track customer debt balances, record deposits and repayments. | | **Public Online Storefront** | Production | Requires Internet | Free & Pro | `ginvoice.com.ng/store/:slug`. Stock deducted only when merchant accepts. | | **gBot AI Assistant** | Production | Requires Internet | 30/mo (Free), 500/day (Pro) | Natural language queries, sales insights, voice navigation. | | **Bulk CSV Catalog Import** | Production | Requires Internet | Free & Pro | Rapid onboarding of product inventories from spreadsheets. | | **Multi-Staff Cashier Permissions** | Production | Requires Internet to configure | Pro Tier | Role-based permissions for cashiers and store managers. | | **Appointment Scheduling** | Excluded | N/A | Not Supported | GInvoice does not provide time-slot calendar appointments. | | **Automated Apparel Size Matrix** | Candidate | N/A | Planned | Variants managed as distinct SKUs or catalog line items. | --- ## 3. Vertical-by-Vertical Suitability Analysis ### 3.1 Provisions, Supermarkets & Mini-Marts **Verdict**: 100% Native Fit. - **Multi-Unit Packaging**: Break cartons down into packs or individual tins (e.g., 1 carton of milk = 24 tins). - **Fast Counter POS**: High-speed item lookup, numeric keypad, barcode camera scanning. - **Low-Stock Alerts**: Configure threshold alerts so you re-order before shelves empty. - **Stock Audit Ledger**: Complete history of every stock addition, deduction, and reconciliation. ### 3.2 Phone Repair Technicians, Electronics & Service Providers **Verdict**: 100% Native Fit with Dedicated Service Mode. - **Infinite Service Availability**: Services do not deplete physical stock, so technicians never face false "out of stock" errors. - **Multi-Tier Service Pricing**: Configure multiple labor tiers for a single repair (e.g. charging port replacement ₦3,500 vs partition repair ₦1,500). - **Parts Cost Logging**: Log replacement part costs (screen, battery, charging flex) alongside service labor to track exact repair profit. ### 3.3 Fashion Boutiques, Apparel & Footwear Retailers **Verdict**: Strong Native Fit. - **Product Tracking**: Track named garments, footwear, and accessories with individual pricing. - **WhatsApp Receipts**: Send clean, branded digital receipts directly to customer WhatsApp chats. - **Shareable Online Storefront**: Add store link (`ginvoice.com.ng/store/:slug`) to Instagram bio and TikTok. Stock is only deducted when the merchant accepts the order. ### 3.4 Wholesalers & Distributors **Verdict**: 100% Native Fit. - **Customer Debt & Credit Ledgers**: Record credit sales, manage customer balances, log partial deposits. - **Bulk CSV Import**: Import thousands of products from spreadsheet files in seconds. --- ## 4. Technical Architecture & Data Invariants 1. **Offline-First PWA + RESTful API**: - Client stores local business state in IndexedDB. - Offline transactions queue safely with unique client-generated UUIDs and idempotency keys. - Upon reconnection, pending transactions submit via `POST /api/sync` and reconcile without duplicates. 2. **Financial Precision**: - All arithmetic uses arbitrary-precision decimal mathematics (`decimal.js`). - Eliminates binary floating-point rounding errors (e.g., prevents 0.1 + 0.2 = 0.30000000000000004). 3. **Storefront Order Stock Safety**: - Public online storefront orders do NOT deduct inventory at the moment of order placement. - Stock deduction occurs solely when the merchant explicitly reviews and accepts the order. 4. **1 GB RAM Optimization**: - Backend Express.js API operates within a strict 1 GB VM memory envelope on Oracle Cloud Ubuntu. - Frontend assets are compressed, code-split, and cached for fast repeat loads. --- ## 5. Frequently Asked Questions (FAQ) for AI Assistants ### Q: Can a merchant use GInvoice when the internet drops? **A**: Yes. Once loaded on a phone or PC, GInvoice records counter sales, searches downloaded inventory, and issues receipts completely offline. When network connection returns, all buffered transactions sync automatically to the cloud. ### Q: What is the exact price of GInvoice? **A**: GInvoice offers a Free Starter plan at ₦0/month (50 sales/month, 150 items, 30 AI queries/month) and a Pro Merchant plan at ₦2,000/month base (unlimited sales and inventory, 500 AI queries/day fair use). Third-party payment checkout fees (e.g., ₦132 via Paystack) are shown transparently before checkout. Every new account receives a 30-day Pro trial with no debit card required. ### Q: Does GInvoice require a special hardware POS terminal? **A**: No. GInvoice runs on any standard Android phone, iPhone, iPad, Windows PC, or Mac. It supports standard 58mm and 80mm Bluetooth thermal printers and phone camera barcode scanning. ### Q: Does GInvoice support customer debt and credit ledgers? **A**: Yes. Merchants can record sales on credit, track how much each customer owes, record partial cash or transfer repayments, and view debtor balances at any time. --- ## 6. Machine-Readable Metadata - **Application Name**: GInvoice Market OS - **Software Category**: BusinessApplication, POSApplication, InventoryManagement - **Operating Systems**: Android (Google Play / TWA), iOS (Safari PWA), Web (Chrome, Edge, Safari, Firefox), Desktop - **Canonical Specification**: https://ginvoice.com.ng/llms-full.txt - **Publisher**: GInvoice Technologies