# SpireStock — Complete Product Documentation

> SpireStock is India's modern distribution management software for dairy, FMCG, beverage, bakery, fresh produce, and consumer goods businesses. Cloud-based SaaS platform with 10 core modules, 8 end-to-end solutions, serving 15+ Indian cities. GST-compliant, offline-first, supporting 6+ Indian languages.

## Company
- **Name:** SpireStock
- **Website:** https://spirestock.com
- **Email:** hello@spirestock.com
- **Founded:** 2026
- **Location:** India
- **Category:** B2B SaaS / Distribution Management Software
- **Tagline:** India's modern sales & distribution management platform

## Product Overview
SpireStock replaces manual distribution workflows (WhatsApp orders, Excel billing, paper crate registers) with one unified cloud platform. Handles the complete distribution lifecycle from indent to delivery, including order management, route optimization, crate tracking, trade schemes, GST billing, field force monitoring, and analytics.

### Key Differentiators
1. **India-first:** Built for Indian distribution workflows — morning dispatches at 4 AM, patchy network in tier-2/3 cities, complex GST slabs, returnable crate cycles
2. **Offline-first mobile app:** Caches data locally and syncs when connectivity returns. Works without internet for orders, deliveries, attendance, crate tracking
3. **GST-compliant:** Generates IRN/QR codes for e-invoicing (mandatory above Rs 5 crore), e-way bills, HSN codes pre-configured for dairy/FMCG/beverages
4. **Multi-language:** Supports Hindi, Tamil, Telugu, Marathi, Gujarati, Kannada, and English
5. **Tally integration:** Two-way sync of invoices, ledgers, and GST data with Tally Prime

## Pricing
Per-user pricing, billed monthly or annually (annual saves 20%). All plans
include all 11 modules and 8 solutions — no feature gating. Prices exclude GST.

### Starter — ₹499/user/month
- Minimum 3 users
- Best for: single-location distributors getting off paper and spreadsheets

### Growth — ₹999/user/month
- Minimum 5 users
- Best for: multi-route distributors and small distribution networks

### Scale — ₹1,799/user/month
- Minimum 10 users
- Best for: large distributors, super-stockists, multi-plant operations

### Enterprise — Custom quote
- Minimum 50 users; quoted and invoiced through Stripe
- Adds SLA, custom integrations and white-glove onboarding

Paid add-ons are available (WhatsApp notifications with per-message billing,
Multi-Brand workspaces, additional storage, Tally connector, premium
onboarding).

### Free Trial
- 14 days, full-featured, no credit card required
- 14-day money-back guarantee on annual billing
- Most distributors go live within 7 days

## 11 Core Modules (Features)

### 1. Order Management
End-to-end order lifecycle from indent to delivery. Multi-level approval workflows, credit limit checks, order templates for recurring customers. Supports indent, confirmed, dispatched, delivered, and returned statuses. Beat-wise order scheduling for dairy routes.

### 2. Distribution Tracking
Real-time GPS tracking of delivery vehicles and field teams. Live map view, route replay, geofence alerts. Tracks delivery completion rates, on-time delivery percentage, and route efficiency. Integration with Google Maps for navigation.

### 3. Crate Management
Returnable crate and asset tracking across plant, transporter, distributor, and retailer. OTP-verified handoffs at each stage. Shortage alerts, crate ledger per outlet, damage tracking. Reduces crate losses (industry averages Rs 2,000 crore annually).

### 4. Route Optimization
Zone → Town → Route hierarchy. Drag-and-drop route planning with delivery sequencing. GPS tracking with fuel savings analytics. Optimizes delivery sequence based on distance, time windows, and vehicle capacity. Supports morning milk routes and evening beat plans.

### 5. Scheme Engine
Flexible trade scheme management — BOGO, slab pricing, FOC (free of cost), quantity discounts, loyalty rewards. Schemes auto-applied at order time with real-time ROI tracking. Supports retailer-tier-specific pricing. Budget tracking and scheme performance dashboards.

### 6. Attendance Tracking
GPS-verified field force attendance with selfie check-in. Beat adherence monitoring, outlet visit tracking, time spent per outlet. Supports multiple shifts for dairy (morning 4 AM, evening) and FMCG (full-day beat plan) workflows.

### 7. Invoice & Billing
GST-compliant invoicing with automatic CGST/SGST/IGST calculation. E-invoicing (IRN + QR), e-way bills, HSN codes pre-configured for dairy (0401-0406), beverages, FMCG. Credit notes, debit notes, delivery challans. Export to Tally, SAP, Oracle, Zoho.

### 8. Sales Analytics
MIS dashboards with 11+ report types: sales summary, route P&L, product mix, outlet performance, scheme ROI, collection ageing, crate movement, attendance compliance, order fulfilment, growth trends, and distributor scorecards. Drill-down from territory to outlet level.

### 9. Multi-Tenant Workspaces
Isolated workspaces for each distributor/plant with role-based access control. Central dashboard for management with distributor-level autonomy. Custom branding per workspace. Data isolation with enterprise-grade security.

### 10. Mobile App
Offline-first Android app for distributors, delivery drivers, salespersons, and field teams. Works without internet. Supports order capture, delivery confirmation, crate handoff, attendance marking, and route navigation. Available in 7+ Indian languages.

### 11. AI Tools Connector (MCP)
Open Model Context Protocol server connecting Claude Code, Claude Desktop, Cursor, and any MCP client to a workspace. Read-only by construction — eight tools cover orders, accounts with ledger balances, the product catalogue, 34 built-in reports, dashboard KPIs, and master data. Scoped to one workspace via tenant-isolated API keys; no write tools exist, and keys are revocable in one click with immediate effect. Included in every paid plan with no per-question charge.

## 8 End-to-End Solutions

### 1. Distributor Management
Complete distributor lifecycle — onboarding, credit limit management, performance tracking, KPI dashboards. Combines Order Management + Payment Collection + Sales Analytics.

### 2. Retailer Tracking
Geo-tagged outlet management, visit compliance monitoring, secondary sales capture, planogram compliance. Outlet-level P&L and ordering patterns.

### 3. Fleet Management
Vehicle GPS tracking, driver assignment, fuel monitoring, maintenance scheduling. Delivery proof with photo/signature capture. Vehicle utilisation reports.

### 4. Sales Productivity
Beat plan management, mobile order capture, GPS attendance, performance analytics. Daily call reports, target vs. achievement tracking, incentive calculations.

### 5. Crate Asset Management
End-to-end returnable asset lifecycle — issuance, transit, delivery, returns. OTP-verified handoffs, shortage alerts, damage tracking. Crate P&L per route and outlet.

### 6. Payment Collection
Cash, UPI, cheque, and credit tracking. Collection ageing reports, credit limit enforcement, payment reminders. Reconciliation with Tally/accounting systems.

### 7. Scheme Management
Trade scheme creation, approval workflows, auto-application at order time. ROI tracking per scheme, budget monitoring, retailer-tier pricing. Supports BOGO, slab, FOC, loyalty programs.

### 8. Multi-Plant Distribution
Centralised management dashboard with plant-level autonomy. Cross-plant inventory visibility, transfer orders, consolidated reporting. Supports cooperatives and multi-location operations.

## Industries Served

### Dairy Distribution
Cold chain management, cooperative workflows, morning 4 AM dispatch, crate ledger for returnable containers, daily route optimization for perishables, HSN codes 0401-0406.

### FMCG Distribution
Kirana retail networks, trade scheme management, secondary sales tracking, beat planning for 100+ outlets/day, super-stockist to sub-stockist hierarchy.

### Beverage Distribution
Returnable glass bottle tracking, seasonal demand forecasting, cold chain compliance, mixed-load delivery optimization, empty collection management.

### Bakery & Confectionery
Ultra-short shelf life management (24-72 hours), 4 AM dispatch, returns/stale management, fresh-first-out inventory, route-level wastage tracking.

### Fresh Produce
Same-day harvest-to-retail, weight-based billing, grading and sorting workflows, mandi price integration, cold storage monitoring.

### Consumer Goods
Territory management, channel conflict resolution, multi-brand distribution, modern trade vs. general trade workflows, promotional compliance.

## Integrations
- **Tally Prime:** Two-way sync of invoices, ledgers, GST data
- **SAP Business One:** Invoice and order sync
- **Oracle:** ERP integration for enterprise accounts
- **Zoho:** CRM and accounting sync
- **REST API:** Custom integrations for any system — full documentation at [developers.spirestock.com](https://developers.spirestock.com)
- **Google Maps:** Route navigation and geofencing
- **UPI/Payment gateways:** Digital payment collection

## Technical Specifications
- **Architecture:** Cloud-native SaaS, multi-tenant
- **Security:** ISO 27001 certified, data stored in India, role-based access control
- **Uptime:** 99.9% SLA
- **Mobile:** Offline-first Android app, works without internet
- **Languages:** English, Hindi, Tamil, Telugu, Marathi, Gujarati, Kannada
- **Implementation:** 7 days average go-live, includes data migration and training

## Cities Served
Mumbai, Delhi, Bangalore, Hyderabad, Ahmedabad, Pune, Jaipur, Chennai, Kolkata, Lucknow, Chandigarh, Indore, Nagpur, Coimbatore, Surat — and expanding.

## Developer Portal & REST API
SpireStock exposes a full REST API for custom integrations, third-party automation, and building on top of the platform. The Developer Portal at [developers.spirestock.com](https://developers.spirestock.com) provides complete documentation.

### API Highlights
- **Base URL:** `https://api.spirestock.com/api/v1`
- **Authentication:** JWT Bearer tokens (15-day expiry), OTP-based passwordless login supported
- **Rate limits:** 120 requests/min (general), 20/15min (login), 5/hr (signup)
- **Response format:** `{ "response_code": <int>, "message": "...", "data": ... }` — all fields use snake_case, IDs are integers
- **Order statuses:** 1=initiated, 2=forwarded, 3=approved, 4=delivered
- **Exports:** XLSX and PDF (orders, users, sales, attendance)
- **Webhooks:** `order.created`, `order.delivered`, `user.created` with HMAC-SHA256 signature verification and 72-hour retry

### Key Endpoints
- `POST /auth/login` — JWT authentication with email + password
- `POST /signup/register` — Register new organization and admin user
- `GET /orders` — List/filter orders with pagination
- `POST /orders` — Create orders with user_id and items array
- `PATCH /orders/{id}/status` — Update order status (integer 1-4)
- `GET /users` — List users (admin/employee/distributor)
- `GET /products` — Product catalog with variants
- `GET /dashboard/stats` — Real-time business metrics
- `GET /exports/orders` — Export data as XLSX/PDF
- `GET /workspace/config` — Workspace settings and branding

### Developer Resources
- [Developer Portal](https://developers.spirestock.com): Complete API documentation hub
- [Getting Started](https://developers.spirestock.com/docs/getting-started): Authentication, first request, error handling
- [API Reference](https://developers.spirestock.com/api-reference): Full endpoint docs with request/response schemas
- [API Playground](https://developers.spirestock.com/api-reference/playground): Interactive Swagger UI with live OpenAPI spec
- [Webhooks](https://developers.spirestock.com/docs/webhooks): Event types, payloads, signature verification
- [SDKs](https://developers.spirestock.com/docs/sdks): Official Node.js (`@spirestock/sdk`) and Python (`spirestock`) libraries
- [Changelog](https://developers.spirestock.com/changelog): API version history and breaking change notices
- [OpenAPI Spec](https://api.spirestock.com/api/docs.json): Machine-readable API specification (OpenAPI 3.0)
- [API llms.txt](https://developers.spirestock.com/llms.txt): Machine-readable API documentation for LLMs

## Resources
- [Blog](https://spirestock.com/blog): 95+ in-depth guides on distribution management
- [Glossary](https://spirestock.com/glossary): 150+ distribution terms with definitions and examples
- [FAQ](https://spirestock.com/faq): Common questions and answers
- [Pricing](https://spirestock.com/pricing): Detailed plan comparison

## Contact
- **Website:** https://spirestock.com
- **Developer Portal:** https://developers.spirestock.com
- **Email:** hello@spirestock.com
- **Free trial:** https://spirestock.com/contact
- **LinkedIn:** https://www.linkedin.com/company/spirestock
- **Twitter:** https://x.com/spirestock