Tally + GST Integration: generate IRN & e-Way Bill from Tally Prime
Connect Tally Prime or Tally ERP 9 to WhiteBooks and start generating IRN, signed QR codes, and e-Way Bills directly from your sales vouchers. No schema changes, no manual portal uploads — the TDL add-on reads existing vouchers and posts the IRN / EWB data back to Tally automatically through the certified GSP channel.
Who this is for
- SMBs running Tally Prime as their primary accounting system who need to file e-Invoice (IRN) from August 2023 onwards.
- Distributors and manufacturers who generate dozens or hundreds of EWBs per day and want to eliminate the NIC-portal copy-paste.
- CAs and tax practitioners managing multiple Tally companies (and GSTINs) under one client roof.
- Any business whose CBIC e-Invoicing turnover threshold has been crossed (INR 5 crore for B2B from August 2023).
What you get
- One-click IRN generation from any sales / delivery voucher — IRN, AckNo, and signed QR post back to the voucher.
- Bulk operations — multi-select up to 1,000 vouchers in Day Book and push them as a single batch.
- e-Way Bill generation, Part-B update (when vehicle is assigned), extension, and cancellation — same workflow.
- Automatic IRN on print — your customer-facing invoice prints with the IRN, QR, and AckNo embedded.
- Multi-GSTIN — one Tally setup can map to multiple GSTINs with per-GSTIN reconciliation.
- GSTR-1 push — vouchers flow into GSTR-1 in WhiteBooks Cloud; reconcile against GSTR-2B for ITC.
Prerequisites
- Tally Prime (any release) or Tally ERP 9 Release 6.6+.
- A registered GSTIN with active e-Invoicing enablement (CBIC turnover threshold met).
- A free WhiteBooks developer account — sign up at /about/contact-us.
- About 1–2 hours of admin time for a single-GSTIN setup.
Setup steps
- Sign up. Create a free WhiteBooks developer account at /about/contact-us. Verify your business GSTIN. Sandbox credentials (
client_id+client_secret) arrive within one business day. - Install the TDL add-on. Download
WhiteBooks-Tally-Connector.tdlfrom your developer dashboard. Copy it into Tally's TDL folder (typically%TALLY%/TDL) and load it viaF11→ TDLs / Add-Ons → Load TDL Files on Startup = Yes. No schema changes to your Tally data. - Configure credentials. Open Gateway of Tally → Configure → WhiteBooks API. Paste your
client_idandclient_secret. Pick environment: Sandbox (test) or Production (live). - Map GSTINs. Map each Tally company to its GSTIN. For multi-GSTIN setups, map each ledger to the relevant GSTIN; reconciliation runs per-GSTIN automatically.
- Generate your first IRN. Create a sales voucher as you normally would. Click Generate IRN in the voucher footer. The IRN, AckNo, and signed QR post back to the voucher in <2 seconds.
- Print with IRN embedded. Print the voucher. The customer-facing invoice now carries the IRN, AckNo, and QR code automatically.
- Bulk mode. In Day Book, multi-select vouchers and choose Generate IRN (Bulk) or Generate EWB (Bulk). Up to 1,000 vouchers per batch with per-row status; rejected rows show the IRP / NIC error code for one-click re-submission.
- Switch to production. When ready, switch the environment to Production in Gateway of Tally → Configure. Your GSTIN registration on GSTN does not need to change — only the gateway.
Sample REST call (under the hood)
The TDL add-on calls the WhiteBooks e-Invoice API under the hood. If you want to integrate Tally with something custom (e.g. a SharePoint dashboard, a billing portal), the same endpoint is available directly:
# Generate IRN for a single invoice (sandbox)
curl -X POST https://apisandbox.whitebooks.in/einvoice/api/v1/generate-irn \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "Version":"1.1", "TranDtls":{"TaxSch":"GST","SupTyp":"B2B"},
"DocDtls":{"Typ":"INV","No":"INV-001","Dt":"12/04/2026"},
"SellerDtls":{"Gstin":"29AAAAA0000A1Z5"},
"BuyerDtls":{"Gstin":"27BBBBB0000B1Z5"},
"ItemList":[ ... ],
"ValDtls":{"AssVal":1000,"IgstVal":180,"TotInvVal":1180} }'FAQs
Does WhiteBooks work with Tally Prime?
Yes. The Tally Connector ships as a TDL add-on for Tally Prime (all releases) and Tally ERP 9 (Release 6.6+). No schema changes to your Tally data — the connector reads existing sales / delivery vouchers and posts IRN / EWB / QR data back to the voucher.
Does it support bulk IRN from Tally?
Yes. Multi-select vouchers in Day Book and push them to the IRP in a single batch — up to 1,000 vouchers per call with per-voucher status. Rejected rows show the IRP error code for one-click re-submission.
Does the IRN print on the Tally invoice?
Yes. Once generated, the IRN, AckNo, and signed QR code post back to the Tally voucher and print on the customer-facing invoice automatically. No manual entry.
How long does setup take?
Typical setup is 1–2 hours: copy the TDL into Tally, load via F11, paste your WhiteBooks credentials, map GSTINs, and generate a test IRN against the sandbox. Single-GSTIN customers usually go live the same day.
Is GSP certification required?
GSP certification is required of the gateway, not the Tally user. WhiteBooks holds GSP certification, so every IRN, EWB, and GST return your Tally generates flows through the official GSTN / IRP / NIC channel — no manual portal uploads.