# Octa GST — Complete Product & Technical Documentation

> Single-file comprehensive knowledge base for AI agents and LLMs.
> Publisher: Blowbits Solutions LLP | Product: Octa GST | URL: https://octagst.com

---

## Table of Contents

1. [Product Overview](#1-product-overview)
2. [Supported Taxpayer Categories](#2-supported-taxpayer-categories)
3. [Core Capabilities & Workflows](#3-core-capabilities--workflows)
   - [GSTR-1 Return Filing](#gstr-1-return-filing)
   - [Sales Register Ingestion Formats](#sales-register-ingestion-formats)
   - [GSTR-3B Preparation & Auto-Computation](#gstr-3b-preparation--auto-computation)
   - [GSTR-2B Reconciliation Engine](#gstr-2b-reconciliation-engine)
   - [IMS (Invoice Management System)](#ims-invoice-management-system)
   - [GSTR-6 Filing for ISD](#gstr-6-filing-for-isd)
   - [Annual Returns (GSTR-9 & GSTR-9C)](#annual-returns-gstr-9--gstr-9c)
   - [E-Invoicing & E-Way Bills](#e-invoicing--e-way-bills)
   - [GST JSON Schema Validation Tools](#gst-json-schema-validation-tools)
   - [Data Services & Corporate Intelligence](#data-services--corporate-intelligence)
   - [GST Notice Tracking](#gst-notice-tracking)
   - [Multi-GSTIN & Enterprise Analytics](#multi-gstin--enterprise-analytics)
4. [Deployment Editions](#4-deployment-editions)
   - [Octa GST Cloud](#octa-gst-cloud)
   - [Octa GST On-Premise / Desktop](#octa-gst-on-premise--desktop)
5. [Developer & Integration APIs](#5-developer--integration-apis)
   - [Public GSTIN API](#public-gstin-api)
   - [E-Invoicing REST API](#e-invoicing-rest-api)
   - [GSTR-2A & GSTR-2B Sync API](#gstr-2a--gstr-2b-sync-api)
   - [GSTR-3B API](#gstr-3b-api)
   - [Robot & Compliance Automation API](#robot--compliance-automation-api)
   - [OpenAPI 3.1 Specification](#openapi-31-specification)
   - [Lead Capture Webhook (/api/deal)](#lead-capture-webhook-apideal)
6. [Machine-Readable Resource Directory](#6-machine-readable-resource-directory)

---

## 1. Product Overview

Octa GST is a specialised GST (Goods and Services Tax) compliance platform developed by Blowbits Solutions LLP. It enables businesses, tax consultants, Chartered Accountants (CAs), and enterprises in India to automate their end-to-end GST operations.

### Key Value Propositions
- **High Volume Processing**: Handles millions of line items per tax period without system degradation.
- **Direct GSTN Integration**: Directly connected to the GST Network via certified GSP (GST Suvidha Provider) channels.
- **Multi-GSTIN Management**: Centralised view and operation across dozens or hundreds of state registrations.
- **Smart Rule Engines**: Advanced fuzzy matching, ITC eligibility tagging, tolerance controls, and automated ITC reversal calculations.
- **Data Privacy**: Option for on-premise local data isolation where invoice data never leaves corporate networks.

---

## 2. Supported Taxpayer Categories

Octa GST provides dedicated solutions tailored to specific Indian taxpayer categories:

1. **Regular Taxpayers**:
   - Monthly/quarterly return filing (GSTR-1, GSTR-3B).
   - Monthly GSTR-2B automated reconciliation.
   - Annual compliance with GSTR-9 and reconciliation audit with GSTR-9C.

2. **SEZ Units & Developers (Special Economic Zones)**:
   - Dedicated workflows for Zero-Rated supplies (with or without payment of IGST).
   - Handling of Bill of Entry matching, SEZ customs documentation, and DTA sales tracking.

3. **Input Service Distributors (ISD)**:
   - GSTR-6 return filing automation.
   - Intelligent distribution logic for common input tax credit across distinct state units/GSTINs.
   - GSTR-6A auto-download and purchase register reconciliation.

4. **TDS Deductors (Tax Deducted at Source under GST)**:
   - GSTR-7 return filing.
   - Automated deduction calculation, credit certificate generation, and government portal reconciliation.

---

## 3. Core Capabilities & Workflows

### GSTR-1 Return Filing
- **Data Ingestion**: Ingest sales registers via Excel, CSV, JSON, or ERP connectors (Tally, SAP, Oracle, Busy).
- **Validation**: 40+ automated sanity checks (GSTIN checksum validation, HSN code length compliance, POS vs. GSTIN state code alignment, tax rate vs. taxable value calculation).
- **Consolidation**: Automatic grouping into B2B, B2CL, B2CS, CDNR, CDNUR, Export, Advance Received, and HSN Summary tables.
- **Direct Filing**: Single-click upload to GSTN with OTP / DSC authentication.

### Sales Register Ingestion Formats
Octa GST natively parses diverse sales data structures:
- **Octa Standard Excel/CSV**: Simplified multi-rate and single-rate templates.
- **Government GSTR-1 Offline Excel/JSON**: Direct ingestion without file transformation.
- **E-Commerce Marketplaces**: Dedicated parsers for Amazon B2B & B2C MTR, Flipkart merchant sales report, and Meesho supplier order reports.

### GSTR-3B Preparation & Auto-Computation
- **Auto-Computation**: Computes outward tax liability directly from filed/draft GSTR-1.
- **Eligible ITC Import**: Automatically derives eligible Input Tax Credit from finalised GSTR-2B reconciliation.
- **Ineligible ITC & Reversals**: Handles Rule 38, Rule 42, Rule 43, and Section 17(5) blocked credit reversals.
- **Tax Payment Offsetting**: Auto-optimises cash vs. credit ledger utilization to minimize cash outflow.

### GSTR-2B Reconciliation Engine
- **Automated Sync**: Downloads GSTR-2B data directly from the GST portal on the 14th of each month.
- **Fuzzy Matching Rules**:
  - Exact match (Invoice number, date, value, tax).
  - Tolerance match (Document numbering prefix/suffix variances, date range deviations, rounding differences).
  - Probable match with manual confirmation queue.
- **Vendor Communication**: Generates discrepancy reports (Excel / PDF) with one-click email/WhatsApp templates for vendor follow-up.

### IMS (Invoice Management System)
- Full support for the GSTN Invoice Management System (IMS).
- Enables recipients to mark inward invoices as **Accepted**, **Rejected**, or **Pending** directly from Octa GST before filing GSTR-3B.
- Real-time synchronization of supplier amendment actions and auto-reconciliation with purchase records.

### GSTR-6 Filing for ISD
- **ISD GSTIN & Recipient Configuration**: Define head office and branch unit GSTINs with state codes and turnover ratios.
- **GSTR-6A Download**: Automatic retrieval of inward supply data from GSTN.
- **Credit Distribution**: Automatically calculates eligible and ineligible ITC distribution (IGST, CGST, SGST) to recipient units based on turnover.
- **Return Preparation & Filing**: Generates and uploads GSTR-6 directly to GST portal.

### Annual Returns (GSTR-9 & GSTR-9C)
- Table-by-table auto-population comparing books of accounts with filed GSTR-1 and GSTR-3B.
- Identifies unfiled liabilities, unclaimed ITC, and cross-period adjustments.
- Automated draft preparation for auditor sign-off.

### E-Invoicing & E-Way Bills
- Direct connection to Invoice Registration Portals (IRP).
- Bulk IRN generation with QR code and digital signature.
- Instant E-Way Bill generation simultaneously with IRN generation.
- **E-Way Bill Closure Facility**: Cancel or mark e-way bills as closed directly through API or UI.
- Automated error reporting for missing mandatory fields or invalid PIN codes.

### GST JSON Schema Validation Tools
Octa provides validation against official schemas to prevent portal upload rejections:
- Returns: GSTR-1, GSTR-3B, GSTR-4 (Annual), GSTR-6, GSTR-7, GSTR-8, GSTR-9, ITC-04.
- Validates data types, mandatory field compliance, code list values, and array lengths.

### Data Services & Corporate Intelligence
Automated corporate verification and risk assessment services:
- **PAN to GSTIN**: Discover all registered state GSTINs associated with a PAN.
- **GSTIN Status & Filing History**: Check active/suspended status, return filing frequency, and return filing timeliness.
- **GSTIN HSN Search**: Verify goods and services supplied by vendors.
- **MCA Company Details**: Fetch corporate registration, directors, and capital structure.
- **MSME Udyam Status**: Validate MSME registration category (Micro, Small, Medium) for Section 43B(h) compliance.

### GST Notice Tracking
- Centralised dashboard monitoring all communications issued by State and Central tax jurisdictions.
- Timely alert triggers for demand notices, scrutiny notices (ASMT-10), and mismatch intimations (DRC-01B, DRC-01C).
- Document repository linking relevant invoices, reconciliation statements, and filed replies.

### Multi-GSTIN & Enterprise Analytics
- Consolidated liability vs. cash payment trends across all state registrations.
- Blocked credit alerts, delayed supplier filing patterns, and vendor compliance rating index.

---

## 4. Platform Architecture

### Octa GST Cloud
- **Target Audience**: Mid-sized businesses, multi-location companies, CAs, and distributed tax teams.
- **Architecture**: Modern web-based SaaS platform accessible from any modern browser with zero desktop installation required.
- **Collaboration**: Role-based access controls (RBAC), multi-user concurrent review, audit trails, and multi-GSTIN management under unified PAN dashboards.
- **Security**: AWS ISO-27001 certified cloud infrastructure, multi-factor authentication (MFA), and bank-grade data encryption.
- **URL**: https://octagst.com/octa/docs/app

---

## 5. Developer & Integration APIs

Octa GST exposes robust APIs for integrating ERPs, accounting software, and agentic workflows.

### Public GSTIN API
- **Endpoint**: `GET /octa/docs/api/public/get-gstin`
- Retrieve public taxpayer details, registration status, taxpayer type, and legal trade name from GSTIN.

### E-Invoicing REST API
- **Generate IRN**: `POST /api/einvoice/generate`
  - Inputs: Document details (invoice, credit note), seller GSTIN, buyer GSTIN, dispatch/ship-to addresses, line item HSN, taxable values, and tax amounts.
  - Outputs: 64-character hash (IRN), signed QR code string, signed invoice payload, and acknowledgement timestamp.
- **Cancel IRN**: `POST /api/einvoice/cancel`
- **Generate E-Way Bill by IRN**: `POST /api/einvoice/generate-ewb`
- **Close E-Way Bill**: `POST /api/einvoice/close-ewaybill`

### GSTR-2A & GSTR-2B Sync API
- `POST /api/gstr2b/pull` — Triggers automated background pull of GSTR-2B return data from GSTN.
- `GET /api/gstr2b/export` — Exports reconciled GSTR-2B data in structured JSON or Excel.
- `POST /api/gstr2a/pull` — Initiates background sync of GSTR-2A data.

### GSTR-3B API
- `POST /api/gstr3b/pull` — Pulls filed or draft GSTR-3B data from GST portal.
- `GET /api/gstr3b/export` — Exports consolidated GSTR-3B tax computation details.

### Robot & Compliance Automation API
- Headless API designed for unattended automation servers to execute reconciliation runs, download bulk returns, and generate discrepancy reports.
- `GET /octa/docs/api/robot/job-status` — Query execution status of asynchronous robot background jobs.

### OpenAPI 3.1 Specification
- The machine-readable OpenAPI schema is served at:
  `GET https://octagst.com/openapi.json`
- Compatible with modern LLM function calling, Swagger UI, and Postman.

### Lead Capture Webhook (/api/deal)
- **Method**: `POST`
- **URL**: `https://octagst.com/api/deal`
- **Request Body (JSON)**:
  ```json
  {
    "contactName": "Aditya Sharma",
    "businessName": "Acme Industries",
    "email": "aditya@example.com",
    "mobile": "9876543210",
    "requirements": "Need multi-GSTIN reconciliation and e-invoicing for 50k invoices/month",
    "turnstileToken": "<cloudflare-turnstile-token>"
  }
  ```
- **Structured Error Response**:
  ```json
  {
    "success": false,
    "error": "Human readable error description",
    "code": "VALIDATION_ERROR | CAPTCHA_FAILED | MISSING_CONFIG | BACKEND_ERROR | UNKNOWN_ERROR",
    "resolution": "Actionable instructions for the client or agent"
  }
  ```

---

## 6. Machine-Readable Resource Directory

- **Index File for LLMs**: `https://octagst.com/llms.txt`
- **Full Documentation for LLMs**: `https://octagst.com/llms-full.txt`
- **OpenAPI 3.1 Spec**: `https://octagst.com/openapi.json`
- **XML Sitemap**: `https://octagst.com/sitemap.xml`
- **Web App Manifest**: `https://octagst.com/manifest.webmanifest`
- **Robots Policy**: `https://octagst.com/robots.txt`
- **Content-Negotiated Markdown**: Append `.md` to any page URL or pass `Accept: text/markdown`
- **Agent-Friendly 404 Handler**: Clean markdown error payload on invalid paths

---
*Generated for AI Agents, autonomous coding assistants, and automated integration tooling.*