GoFrugal API
GoFrugal is an omnichannel POS and ERP platform for retail, restaurant, and distribution businesses, spanning billing, inventory, purchasing, accounting, CRM/loyalty, and business intelligence. An unofficial API lets you programmatically pull items, stock, rates, sales orders, customers, and reporting data—and push updates like new sales orders, purchase orders, and inventory adjustments back into GoFrugal.
What is GoFrugal?
GoFrugal is an omnichannel POS and ERP platform that streamlines operations for retail, restaurant, and distribution businesses with minimal training. Merchants use GoFrugal to run point-of-sale billing, manage inventory and purchasing, post GST-compliant accounting, drive CRM and loyalty programs, and surface analytics—while connecting to ecommerce, payments, and the ONDC network through its integration layer.
Core product areas include:
- RetailEasy POS billing with mobile checkout via the GoBill application
- Inventory and warehouse management with demand forecasting and auto-replenishment
- Purchase and reorder with auto-pilot reordering, PO creation, and goods receipt
- Integrated GST-compliant accounting and cash flow / shift management
- CRM and loyalty with customer segmentation and offer management
- Business intelligence via the GoAct platform and the WhatsNow owner reporting app
- Cloud POS with VAPT-certified security and GoSecure backup and recovery
Common data entities:
- Items, Matrix Items, Rates (MRP/sale price), Tax, Discounts, Stock
- Sales Orders, Bills/Invoices, Shipments, Delivery details
- Purchase Orders, GRN, Suppliers, Reorder points
- Customers, Loyalty members, Offers, Segments
- Branches/Stores, Reports, Accounting entries
The GoFrugal Integration Challenge
Merchants run daily billing and inventory on GoFrugal, but turning its POS- and store-server-driven workflows into reliable API-driven automation is non-trivial:
- On-premise store servers: APIs are exposed locally (e.g. the WebReporter service on the store server), so reaching them centrally requires tunneling, port forwarding, or cloud bridging across many outlets
- Per-store API keys: X-Auth-Token credentials are issued per installation, so a multi-store chain juggles many keys and rotation schedules
- Partial endpoint coverage: the documented open APIs center on items, stock, and sales orders—customers, loyalty, purchasing, and accounting often live behind the UI or product editions
- Edition and version drift: RetailEasy, ServeEasy, and DigitEasy editions differ, and endpoint availability shifts across product versions and license tiers
- Matrix and tax complexity: matrix items, MRP/sale price tiers, GST tax slabs, and discounts demand careful normalization to integrate cleanly
- Mobile-only data: insights surfaced in WhatsNow and GoBill apps are not always available through the documented REST surface
How Supergood Creates GoFrugal APIs
Supergood reverse-engineers GoFrugal's authenticated store-server APIs and browser flows to deliver a resilient, cloud-reachable API layer across your stores—normalizing items, stock, orders, and customers into one consistent surface.
- Manages per-store X-Auth-Token keys and store-server connectivity behind a single hosted endpoint
- Maintains session continuity with automated refresh and change detection across editions and versions
- Normalizes items, matrix combinations, rates, tax, stock, sales orders, and customers so you integrate once and rely on consistent objects
- Aligns with your edition, license tier, and branch hierarchy to ensure compliant, multi-store access
Use GoFrugal with AI agents: GoFrugal MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your edition, store footprint, and authentication model.
- Supergood Generates and Validates Your API
We deliver a hardened, production-ready GoFrugal adapter tailored to your stores and license tier.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as GoFrugal evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a GoFrugal store server using the per-installation X-Auth-Token API key and establish a session for downstream calls.
Catalog
/itemsList items with rate, MRP, tax, discount, matrix combinations, and branch-level stock details.
Inventory
/stockRetrieve real-time stock levels per item and branch, with filters for store, category, and reorder status.
Sales
/sales_ordersList or retrieve sales orders with customer, shipment, and delivery details across stores.
Sales
/create_sales_orderCreate a sales order with customer, item, quantity, and delivery details posted into the store.
Purchasing
/purchase_ordersPull purchase orders, goods receipts, and supplier records for procurement reconciliation.
Use Cases
Sync catalog, pricing, and stock to ecommerce
- Pull items, matrix combinations, MRP/sale price, and tax slabs from RetailEasy into your storefront - Stream branch-level stock levels to keep online availability accurate - Reconcile discounts and offers across channels for consistent pricing
Automate order and fulfillment flows
- Push online and marketplace orders into GoFrugal as sales orders without manual entry - Pull sales orders, bills, and shipment status for downstream fulfillment tools - Sync delivery details and customer contacts to logistics and notification systems
Centralize multi-store reporting
- Aggregate sales, margins, and inventory across stores into a single warehouse - Surface WhatsNow-style daily summaries and ageing stock alerts in BI tools - Reconcile GST-compliant accounting entries with finance systems
Streamline purchasing and replenishment
- Pull reorder points and auto-replenishment suggestions for procurement workflows - Push purchase orders and goods receipts back into GoFrugal - Sync supplier records and PO status with vendor portals
Technical Specifications
Authentication
Per-store X-Auth-Token API key handled in a managed session, with secure key storage and rotation
Connectivity
Store-server REST APIs (WebReporter service) plus authenticated browser flows, bridged to the cloud across outlets
Response format
Normalized JSON across Items, Stock, Sales Orders, Purchase Orders, and Customer objects
Rate limits
Adaptive throttling tuned per store server to avoid overloading on-premise POS hardware
Session management
Automatic session refresh, key replay handling, and per-installation credential management
Data freshness
Near real-time reads for items, stock, and orders with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging
Webhooks
Event-style callbacks for new bills, sales orders, stock changes, and purchase receipts
Latency
Sub-second reads on cached catalog and stock; multi-second writes when posting orders and purchases
Throughput
Horizontally scaled workers sized to multi-store, high-volume billing operations
Reliability
Retry, backoff, and idempotency keys for order creation and inventory adjustments
Adaptation
Continuous monitoring of GoFrugal editions, version updates, and store configuration drift
Frequently asked questions
Yes. Supergood manages per-store X-Auth-Token keys and store-server connectivity behind a single hosted endpoint, and adapts to RetailEasy, ServeEasy, and DigitEasy editions plus version differences across your outlets.
GoFrugal's WebReporter APIs are typically exposed on the local store server. Supergood bridges those local surfaces to the cloud with secure tunneling, so you call one consistent endpoint instead of configuring port forwarding per outlet.
Yes. The documented open APIs focus on items, stock, and sales orders, but Supergood extends coverage to customers, loyalty, purchasing, and accounting by working against the same authenticated surfaces the application uses.
Matrix item combinations, MRP/sale price tiers, discounts, and GST tax slabs are normalized into consistent objects, so downstream systems receive clean pricing and tax data without parsing edition-specific quirks.
Supergood continuously monitors GoFrugal releases and store configuration drift, then adjusts the adapter automatically so your integration keeps working through version and edition changes.