GSTAgent›Help›Tally Bridge

🌉

Tally Bridge

Connect TallyPrime directly to GSTAgent for automatic purchase data sync.

In this guide

What is the Tally Bridge?Downloading and installing Connecting to TallyPrime Syncing purchase data Troubleshooting

What is the Tally Bridge?

The Tally Bridge is a lightweight Windows application that runs on the same computer as TallyPrime. It connects to Tally's local server, extracts purchase vouchers for a selected period, classifies them into ITC categories, and syncs the data to GSTAgent — all without any manual export.

Without Bridge vs With Bridge

Manual Export

Export DayBook from Tally
Upload Excel to GSTAgent
Re-export every month

With Tally Bridge

One-click sync from GSTAgent
Auto-classifies ITC categories
Real-time data, no manual steps

🖼

Tally Bridge architecture diagram

Downloading and installing the Tally Bridge

⚠️ The Tally Bridge must be installed on the Windows computer where TallyPrime is running. It does not work on a different machine.

Download the Bridge

Log into GSTAgent, go to Upload & Reconcile, and click Download Tally Bridge. This downloads GSTAgent_Bridge.py.

Install Python (if not already installed)

The Bridge requires Python 3.8 or later. Download from python.org and install with default settings. Check “Add Python to PATH” during installation.

Install dependencies

Open Command Prompt and run:
pip install requests

Place the Bridge file

Move GSTAgent_Bridge.py to your Desktop or a convenient folder.

🖼

Python installation and PATH setting

Connecting to TallyPrime

Open TallyPrime with your company

Make sure TallyPrime is open and the correct company is loaded. The Bridge reads from whichever company is currently active.

Enable Tally Gateway Server

In TallyPrime: F12 (Configure) → Advanced Config → Enable Tally Gateway Server → Set port to 9000. Keep it enabled while syncing.

Run the Bridge

Double-click GSTAgent_Bridge.py or run from Command Prompt:
python GSTAgent_Bridge.py

Enter your access code

When prompted, enter your GSTAgent subscription access code. This links the Bridge to your account.

🖼

Bridge running in Command Prompt window

💡 The Bridge only needs your access code once. It saves the configuration for future runs.

Syncing purchase data for a period

Run the Bridge

Start GSTAgent_Bridge.py. It will prompt for the date range (e.g. 01/04/2026 to 30/04/2026 for April 2026).

Wait for classification

The Bridge fetches purchase vouchers from Tally, classifies them into categories (GST Purchase, RCM, Capital Goods, Job Work etc.), and uploads to GSTAgent servers.

Load in GSTAgent

In GSTAgent → Upload & Reconcile → click the Tally Integration panel → click Load into Reconciliation. The synced invoices load as your Purchase Register.

Upload GSTR-2B and reconcile

Upload the GSTR-2B as usual and click Run Reconciliation.

🖼

Tally Bridge sync status in GSTAgent portal

💡 The Bridge auto-excludes sales invoices (output GST entries) and only includes inward supply (input GST debit entries) in the Purchase Register.

Troubleshooting Tally Bridge connections

❓ Bridge says "Connection refused"

→ TallyPrime Gateway Server is not enabled or is on a different port. Verify F12 → Advanced Config → Gateway Server is ON and port is 9000.

❓ Bridge fetches 0 vouchers

→ The active company in TallyPrime has no purchase vouchers for the selected period. Verify the company and date range are correct.

❓ Bridge shows REVIEW_NEEDED entries

→ Some entries could not be auto-classified. Add your Anthropic API key in the Bridge config file (~/.gstagent_bridge_config.json) for AI-assisted classification.

❓ Access code rejected

→ Ensure you are entering the correct code (CAS/CAF/CAM prefix). Check the welcome email from contact@gstagent.in.

❓ Sales invoices appearing as purchases

→ Update to the latest Bridge version. Older versions used absolute values on GST amounts. The latest version filters output GST ledger entries correctly.

Was this helpful?

Contact Support