📝 GST Setup & Filing

Set your GSTIN (do this first)

1. Go to Admin → Company Setup
2. Fill GSTIN (15 chars, e.g. 27AAAAA0000A1Z5). System validates format + auto-detects your State Code (first 2 digits).
3. Set PAN (chars 3-12 of GSTIN), Legal Business Name, Trade Name
4. Save. GSTIN now prints on every invoice + drives intra-vs-inter-state tax split.

GST rates (0/5/12/18/28%)

Every tenant is pre-seeded with all 5 GST slabs at Tax → GST Rates. Just assign the right slab to each item.

HSN codes (mandatory above ₹1.5cr turnover)

4-digit HSN for turnover ₹1.5-5cr; 6-digit for > ₹5cr; 8-digit for exports.

• Set per-item on Item form → HSN Code field
• Bulk-assign at Items → Item List → tick items → Bulk Actions → Set HSN
• Saathi tip: type "HSN for basmati rice" — she'll suggest 1006 30 20

Intra vs Inter-state (auto-detected)

Solvexa compares Store StateCode vs Customer/Vendor StateCode:

• Same state (Intra-state) → CGST + SGST (equal halves of the slab rate)
• Different states (Inter-state) → IGST (full slab rate)

GSTR-1 export (monthly outward supplies)

1. Reports → GST Returns → GSTR-1
2. Pick Month (defaults to previous month before 11th, current after)
3. Click ▶ Generate. You'll see: B2B invoices (registered buyers), B2C-Large (inter-state to unregistered > ₹2.5L), B2C-Small (rate-wise rollup), HSN Summary, Document Series
4. Click ⤓ NIC GSTR-1 JSON — downloads a file conforming to NIC v1.4 offline utility schema. Upload directly at gst.gov.in.

GSTR-3B (monthly summary)

Same page — click the GSTR-3B tab. Shows:

• 3.1(a) Outward supplies — total taxable + CGST/SGST/IGST
• 4(A) ITC available — from purchases (auto-summed from Purchase Invoices)
• Net tax payable = Output − ITC. Carry-forward if ITC > output.

E-Invoice (IRN generation)

Mandatory for businesses with turnover > ₹5cr. Every B2B invoice needs an IRN (Invoice Reference Number) from NIC portal + printed QR code.

1. Configure once at Admin → E-Invoice Settings: Provider (Mock for testing, Cygnet/IRIS/ClearTax for live), GSP credentials, Company GSTIN, IsActive = 1
2. Once active, EInvoiceAutoWorker polls every 30s. It auto-generates IRN for every posted B2B SI + POS bill with a customer GSTIN.
3. Printed invoice shows IRN, Ack No, Ack Date, and the signed-QR code — customer scans to verify.

E-Way Bill (goods > ₹50,000)

Required for all inter-state movement of goods valued > ₹50,000 (₹1L in some states). Applies to sales AND stock transfers between your own stores.

1. Configure at Admin → E-Way Bill Settings: NIC API base URL, GSP creds. Or leave IsActive = 0 for simulated 12-digit EWB numbers.
2. EWayBillAutoWorker sweeps every 60s. Generates EWB for Transfer Shipments + high-value SIs.
3. Delivery challan (Print → TRANSFER_SHIPMENT) now shows the EWB number, valid-until date, vehicle no.

GST Split Audit (catch mis-tagged tax)

Occasionally a draft invoice gets the wrong tax split (e.g. Karnataka customer tagged CGST+SGST instead of IGST). Solvexa detects this automatically.

1. Go to Admin → GST Split Audit. See a list of documents where the computed tax split disagrees with the state-code rule.
2. For Draft documents: click Fix Draft Line — sproc corrects and re-computes. Zero risk.
3. For Posted documents: manual reversing JV required (a CA-safe workflow, not automated).