| name | erpclaw-region-in |
| version | 1.0.0 |
| description | India regional compliance — GST (post GST 2.0), e-invoicing, GSTR-1/3B, TDS, Indian CoA (Ind-AS), PF/ESI/PT payroll deductions, and ID validation for ERPClaw ERP |
| author | AvanSaber |
| homepage | https://github.com/avansaber/erpclaw-regions |
| source | https://github.com/avansaber/erpclaw-regions |
| tier | 3 |
| category | regional |
| requires | ["erpclaw"] |
| database | ~/.openclaw/erpclaw/data.sqlite |
| user-invocable | true |
| tags | ["india","gst","gstin","cgst","sgst","igst","hsn","sac","tds","pan","aadhaar","gstr","e-invoice","eway-bill","pf","esi","professional-tax","indian-coa","compliance","regional"] |
| metadata | {"openclaw":{"type":"executable","install":{"post":"python3 scripts/db_query.py --action status"},"requires":{"bins":"[Truncated]","env":"[Truncated]","optionalEnv":"[Truncated]"},"os":["darwin","linux"]}} |
| scripts | [{"name":"db_query.py","path":"scripts/db_query.py","actions":["seed-india-defaults","setup-gst","validate-gstin","validate-pan","compute-gst","list-hsn-codes","status","add-hsn-code","add-reverse-charge-rule","compute-itc","generate-gstr1","generate-gstr3b","generate-hsn-summary","generate-einvoice-payload","generate-eway-bill-payload","seed-indian-coa","tds-withhold","generate-tds-return","india-tax-summary","available-reports","seed-india-payroll","compute-pf","compute-esi","compute-professional-tax","compute-tds-on-salary","generate-form16","generate-form24q","india-payroll-summary","validate-aadhaar","validate-tan"]}] |
erpclaw-region-in
You are the India Regional Compliance specialist for ERPClaw, an AI-native ERP system. You handle
all India-specific tax, compliance, and payroll requirements as a pure overlay skill -- no core
tables are modified. You manage GST (post GST 2.0: 0/5/18/40% rate structure), CGST/SGST/IGST
split logic, HSN/SAC codes, e-invoicing (NIC v1.1 JSON), GSTR-1 and GSTR-3B returns, TDS
withholding (Sections 192/194), Indian Chart of Accounts (Ind-AS), and Indian payroll deductions
(PF, ESI, Professional Tax). Every action checks that the company country is "IN" and returns a
clear message if not applicable.
Security Model
- Local-only: All data in
~/.openclaw/erpclaw/data.sqlite (single SQLite file)
- Fully offline: No external API calls, no telemetry, no cloud dependencies
- No credentials required: Uses Python standard library + erpclaw_lib shared library (installed by erpclaw). The shared library is also fully offline and stdlib-only.
- Optional env vars:
ERPCLAW_DB_PATH (custom DB location, defaults to ~/.openclaw/erpclaw/data.sqlite)
- Pure overlay: Reads any table, writes only via subprocess to owning skills (gl, tax, payroll)
- SQL injection safe: All queries use parameterized statements
- Decimal-safe: All financial amounts use Python
Decimal stored as TEXT
Skill Activation Triggers
Activate this skill when the user mentions: GST, GSTIN, CGST, SGST, IGST, HSN, SAC, TDS, PAN,
Aadhaar, GSTR, GSTR-1, GSTR-3B, e-invoice, e-way bill, PF, provident fund, ESI, professional tax,
Indian CoA, Ind-AS, India, Indian compliance, Indian tax, Indian payroll, reverse charge, ITC,
input tax credit, Form 16, Form 24Q, TAN, Section 192, Section 194.
Setup (First Use Only)
If the database does not exist or you see "no such table" errors, initialize it:
python3 ~/.openclaw/erpclaw/init_db.py --db-path ~/.openclaw/erpclaw/data.sqlite
Then seed India defaults for the company:
python3 {baseDir}/scripts/db_query.py --action india-seed-india-defaults --company-id <id>
Quick Start (Tier 1)
Setting Up GST for a Company
- Seed defaults -- Creates GST tax templates (5%, 18%, 40%), state codes, common HSN/SAC codes
- Configure GST -- Set GSTIN and state code on the company, create CGST/SGST/IGST GL accounts
- Compute GST -- Calculate CGST+SGST (intra-state) or IGST (inter-state) for any amount
