diff --git a/app/modules/documents/agent_package.py b/app/modules/documents/agent_package.py
index f1fc288..26f6601 100644
--- a/app/modules/documents/agent_package.py
+++ b/app/modules/documents/agent_package.py
@@ -4,7 +4,7 @@ import io
from pathlib import Path
import zipfile
-ERP_LOCAL_AGENT_VERSION = "1.15.1"
+ERP_LOCAL_AGENT_VERSION = "1.16.0"
ERP_LOCAL_AGENT_NAME = "ERP Local Agent"
RUNTIME_ROOT = Path(__file__).resolve().parent / "local_agent_runtime"
_DETERMINISTIC_ZIP_TIMESTAMP = (2026, 1, 1, 0, 0, 0)
diff --git a/app/modules/documents/local_agent_runtime/erp_local_agent/__init__.py b/app/modules/documents/local_agent_runtime/erp_local_agent/__init__.py
index 479976a..ca33d77 100644
--- a/app/modules/documents/local_agent_runtime/erp_local_agent/__init__.py
+++ b/app/modules/documents/local_agent_runtime/erp_local_agent/__init__.py
@@ -1,2 +1,2 @@
-__version__ = "1.15.1"
+__version__ = "1.16.0"
AGENT_NAME = "ERP Local Agent"
diff --git a/app/modules/documents/local_agent_runtime/erp_local_agent/accounting_store.py b/app/modules/documents/local_agent_runtime/erp_local_agent/accounting_store.py
index 86a8822..7accf31 100644
--- a/app/modules/documents/local_agent_runtime/erp_local_agent/accounting_store.py
+++ b/app/modules/documents/local_agent_runtime/erp_local_agent/accounting_store.py
@@ -1077,6 +1077,61 @@ class LocalAccountingStore:
).fetchall()
return [dict(row) for row in rows]
+
+ def chart_of_accounts_snapshot(self, client_id: int, *, tally_guid: str) -> dict:
+ if not self.exists(client_id):
+ raise ValueError("Accounting storage is not initialized for this client.")
+ guid = str(tally_guid or "").strip()
+ if not guid:
+ raise ValueError("Tally company GUID is required.")
+
+ mapping = self.get_active_mapping_by_guid(client_id, guid)
+ with self.connect(client_id) as db:
+ groups = [
+ dict(row)
+ for row in db.execute(
+ """SELECT master_guid AS guid, name, parent, reserved_name,
+ is_revenue, is_deemed_positive, payload_json
+ FROM tally_groups
+ WHERE tally_guid=?
+ ORDER BY name COLLATE NOCASE""",
+ (guid,),
+ ).fetchall()
+ ]
+ ledgers = [
+ dict(row)
+ for row in db.execute(
+ """SELECT master_guid AS guid, name, parent,
+ opening_balance, closing_balance, is_billwise_on,
+ tax_type, gst_applicable, gst_registration_type,
+ gst_type_of_supply, hsn_code, is_revenue,
+ is_deemed_positive, payload_json
+ FROM tally_ledgers
+ WHERE tally_guid=?
+ ORDER BY name COLLATE NOCASE""",
+ (guid,),
+ ).fetchall()
+ ]
+
+ import json as _json
+ for row in ledgers:
+ try:
+ payload = _json.loads(row.get("payload_json") or "{}")
+ except Exception:
+ payload = {}
+ row["party_gstin"] = str(payload.get("party_gstin") or "")
+ row.pop("payload_json", None)
+
+ for row in groups:
+ row.pop("payload_json", None)
+
+ return {
+ "tally_guid": guid,
+ "company_name": str(mapping.get("company_name") or ""),
+ "groups": groups,
+ "ledgers": ledgers,
+ }
+
def historical_learning_evidence(self, client_id: int, *, tally_guid: str, date_from: str = "", date_to: str = "", voucher_scope: str = "purchase") -> dict:
"""Return neutral aggregated historical ledger facts from the local .act store.
diff --git a/app/modules/documents/local_agent_runtime/erp_local_agent/commands.py b/app/modules/documents/local_agent_runtime/erp_local_agent/commands.py
index b82ab09..08c5fbb 100644
--- a/app/modules/documents/local_agent_runtime/erp_local_agent/commands.py
+++ b/app/modules/documents/local_agent_runtime/erp_local_agent/commands.py
@@ -35,6 +35,8 @@ class AgentCommandProcessor:
result = self._unmap_company(payload)
elif action == "accounting_sync_masters":
result = self._sync_masters(payload)
+ elif action == "accounting_chart_of_accounts":
+ result = self._chart_of_accounts(payload)
elif action == "accounting_sync_transactions":
result = self._sync_transactions(payload)
elif action == "accounting_historical_evidence":
@@ -76,7 +78,7 @@ class AgentCommandProcessor:
return {
"name": "ERP Local Agent", "version": __version__,
"tally_capability": True, "accounting_act_capability": True,
- "tally_mapping_capability": True, "tally_master_sync_capability": True,
+ "tally_mapping_capability": True, "tally_master_sync_capability": True, "chart_of_accounts_capability": True,
"tally_transaction_sync_capability": True,
"historical_learning_read_capability": True,
"purchase_posting_preflight_capability": True,
@@ -322,6 +324,21 @@ class AgentCommandProcessor:
return evidence
+
+ def _chart_of_accounts(self, payload: dict[str, Any]) -> dict[str, Any]:
+ # Read-only: refresh the existing master snapshot, then return Groups/Ledgers.
+ sync_result = self._sync_masters(payload)
+ client_id = int(payload.get("client_id"))
+ tally_guid = str(payload.get("tally_guid") or "").strip()
+ chart = self.store.chart_of_accounts_snapshot(
+ client_id,
+ tally_guid=tally_guid,
+ )
+ return {
+ **sync_result,
+ "chart_of_accounts": chart,
+ }
+
def _resolve_open_company(self, payload: dict[str, Any]) -> tuple[dict[str, Any], str]:
requested_guid = str(payload.get("tally_guid") or "").strip()
if not requested_guid:
diff --git a/app/modules/documents/local_agent_runtime/erp_local_agent/tally.py b/app/modules/documents/local_agent_runtime/erp_local_agent/tally.py
index 23f027f..8e661c7 100644
--- a/app/modules/documents/local_agent_runtime/erp_local_agent/tally.py
+++ b/app/modules/documents/local_agent_runtime/erp_local_agent/tally.py
@@ -114,7 +114,7 @@ class TallyLiveConnector:
"collection": "ARRRAccountingLedgers",
"type": "Ledger",
"tag": "LEDGER",
- "fetch": "Name,GUID,Parent,OpeningBalance,ClosingBalance,IsBillWiseOn,TaxType,GSTApplicable,GSTRegistrationType",
+ "fetch": "Name,GUID,Parent,OpeningBalance,ClosingBalance,IsBillWiseOn,TaxType,GSTApplicable,GSTRegistrationType,GSTTypeOfSupply,HSNCode,PartyGSTIN,GSTIN,GSTRegistrationNumber,IsRevenue,IsDeemedPositive,IsActive",
},
"voucher_types": {
"collection": "ARRRAccountingVoucherTypes",
@@ -1095,6 +1095,10 @@ class TallyLiveConnector:
"gst_registration_type": _child_text(element, "GSTREGISTRATIONTYPE"),
"gst_type_of_supply": _child_text(element, "GSTTYPEOFSUPPLY"),
"hsn_code": _first_text(element, ("HSNCODE", "GSTHSNCODE")),
+ "party_gstin": _first_text(
+ element,
+ ("PARTYGSTIN", "GSTIN", "GSTREGISTRATIONNUMBER", "GSTNO", "GSTNUMBER"),
+ ),
"is_revenue": _child_text(element, "ISREVENUE"),
"is_deemed_positive": _child_text(element, "ISDEEMEDPOSITIVE"),
"is_billwise_on": _child_text(element, "ISBILLWISEON"),
diff --git a/app/ui/app.py b/app/ui/app.py
index 8c9b202..5a4d1cd 100644
--- a/app/ui/app.py
+++ b/app/ui/app.py
@@ -50,6 +50,7 @@ from app.modules.accounting.internal_model_ui import router as accounting_intern
from app.modules.accounting.sales_ui import router as accounting_sales_income_ui_router
from app.modules.accounting.sales_learning_ui import router as accounting_sales_learning_ui_router
from app.modules.accounting.sales_menu_ui import router as accounting_sales_menu_ui_router
+from app.modules.accounting.chart_ui import router as accounting_chart_ui_router
from app.modules.registrations.ui import router as registrations_ui_router
from app.modules.credential_vault.ui import router as credential_vault_ui_router
from app.modules.client_identity.ui import router as client_identity_ui_router
@@ -86,6 +87,7 @@ def mount_ui(app: FastAPI) -> None:
app.include_router(accounting_sales_income_ui_router)
app.include_router(accounting_sales_learning_ui_router)
app.include_router(accounting_sales_menu_ui_router)
+ app.include_router(accounting_chart_ui_router)
app.include_router(work_tracker_ui_router)
app.include_router(billing_ui_router)
app.include_router(platform_billing_ui_router)