An active TSS subscription
e-Invoicing in TallyPrime runs through the connected services, and connected services need a live Tally Software Services subscription. If yours has lapsed, nothing on this page will work until it is renewed.
GST compliancee-Invoice and e-way bill, set up properly
GST e-invoicing in TallyPrime - setup, e-way bills and the errors in between
Done properly, e-invoicing is invisible: you save a sales voucher and the IRN and QR code come back before you have finished reaching for the printer. Done badly, it is a fortnight of portal rejections about HSN codes and units nobody has looked at in five years. The difference is almost entirely in the preparation. This page covers what you need before you start, how the daily flow works, and what the common errors actually mean.
In plain terms
What e-invoicing actually is
E-invoicing is not a new kind of invoice and it is not a government-designed billing screen. You raise the invoice in TallyPrime exactly as you always have. What changes is that the invoice details are reported to the Invoice Registration Portal, which validates them and sends back an Invoice Reference Number and a digitally signed QR code. Those two things are what make the document a valid e-invoice, and they need to appear on the copy you hand your customer.
The knock-on benefit is that the reported data flows into the GST system, so the invoice is already known to the portal when your returns come around. The knock-on cost is that your master data is now being validated by somebody else. A unit of measure your staff invented years ago, an HSN code left blank on an old item, a party GSTIN typed with one wrong digit - all of it passed quietly through Tally for years and none of it passes the portal.
That is why a good e-invoicing rollout is mostly a master data cleanup, and why we do that cleanup before switching anything on rather than discovering it invoice by invoice at the billing counter.
Before you start
Four things e-invoicing needs from you
Miss any one of these and the first invoice will fail. Get all four right and the rest is genuinely routine.
API credentials from the portal
Your GSTIN has to be registered on the e-invoice portal, and an API user created there so TallyPrime can talk to it on your behalf. This is a one-time job and it is where most people get stuck.
Correct GST setup in your company
GSTIN, registration type, state and the applicability date all have to be right in the company GST details. e-Invoicing switched on with a wrong state or an incomplete address fails at the portal, not in Tally.
Clean masters
Valid HSN or SAC codes on your stock items, units that match the official UQC list, and party GSTINs that are correct and active. The portal validates all of this and rejects anything that does not fit.
If e-invoices stopped generating overnight and nothing else changed, check your subscription before anything else. How TSS renewal works and what lapses without it
Setup
Getting e-invoicing live in five steps
- 1
Confirm applicability
e-Invoicing applies to businesses above a notified aggregate turnover threshold, and that threshold has come down in stages since it began. We check where your turnover puts you against the current notification before switching anything on.
- 2
Register on the e-invoice portal
Your GSTIN is enabled on the portal and an API user is created for it. Those credentials are what TallyPrime uses to log in - keep them; they are yours, not ours.
- 3
Enable it inside TallyPrime
e-Invoicing is turned on in the company GST details along with the applicability date, and the same is done for e-way bill if you move goods.
- 4
Clean up masters
HSN or SAC on every item, units mapped to valid UQC codes, party GSTINs verified, addresses and pin codes complete. Doing this first turns a week of portal rejections into a quiet go-live.
- 5
Test, then go live
We raise a real invoice with you watching, confirm the IRN and QR code come back and print correctly on your format, and then hand the process to your billing staff.
Day to day
What billing looks like once it is running
Your staff should not have to think about any of this. If they do, the setup is wrong.
Raise the sales invoice
Enter the sales voucher exactly as you always have. Nothing about your billing routine changes.
IRN comes back at save
With e-invoicing configured, TallyPrime sends the invoice to the portal as you save it and receives the Invoice Reference Number and the signed QR code in return.
e-Way bill in the same step
Where the consignment needs one, the e-way bill can be generated along with the e-invoice rather than as a separate visit to another portal.
Offline when you need it
If the connection or the portal is down, invoices can be exported as JSON, uploaded to the portal and the signed response imported back into TallyPrime. Nothing is lost.
A note on e-way bills
An e-way bill is a different document with a different trigger. e-Invoicing is about who you are billing; the e-way bill is about goods physically moving, and it becomes necessary once the consignment value crosses the notified limit - commonly fifty thousand rupees for movement between states, with each state setting its own rules and exemptions for movement inside its own borders. Validity runs on distance, so a delivery across the district and a truck to another state do not get the same window.
The practical point is that TallyPrime can request both in one action where both are needed, and the vehicle details can be filled in when the transport is actually arranged. Businesses that dispatch daily feel this more than anyone - it removes an entire second round of data entry on another portal.
Troubleshooting
Common e-invoice errors and what they mean
Portal error messages are terse and unhelpful by design. Here is the plain translation of the ones we see most.
| What the portal says | What it usually means |
|---|---|
| Invalid or inactive GSTIN of the recipient | The party GSTIN in your ledger is mistyped, cancelled or suspended. Verify it before billing rather than at save time. |
| HSN code not found or invalid | The stock item has no HSN, or one that the portal does not recognise. Check the digit length required for your turnover band. |
| Invalid unit of measure | The portal only accepts units from the official UQC list. A free-text unit such as a custom abbreviation will be rejected every time. |
| Duplicate IRN for this document | An IRN already exists for that invoice number and date. Usually it means the first attempt did succeed at the portal even though Tally did not show it. |
| Taxable value and tax amount mismatch | Rounding, a manual override on the tax ledger, or a discount entered in a way that does not reconcile to the line values. |
| Incomplete address or pin code | Missing state, pin code or address lines on either party. The portal validates address fields far more strictly than Tally does. |
| Authentication or token failure | API credentials changed, expired, or TSS has lapsed. Check the subscription first - it is the most common cause of a login that stopped working overnight. |
Notice how many of these are master data, not software. That is also why businesses that have just moved from another accounting package hit them hardest - units and HSN codes carried over loosely will not survive contact with the portal. Our Busy to Tally migration validates units against Tally's official UQC list during conversion for exactly this reason. If you are stuck on a recurring error today, our support team can look at it over a screen-share.
FAQ
e-Invoicing in Tally, answered
Does e-invoicing apply to my business?
It applies to businesses above a notified aggregate turnover threshold, and that threshold has been reduced in stages since e-invoicing started - from very large taxpayers at launch down to much smaller ones now. Because the notification changes, check your current position against your aggregate turnover rather than relying on what applied last year. We will check it with you at no charge.
Which invoices need an IRN?
Broadly, business-to-business supplies, along with credit notes, debit notes, exports and supplies to SEZ units. Retail sales to unregistered consumers are outside e-invoicing. Your own mix decides how much of your billing is affected.
Do I need TSS for e-invoicing in TallyPrime?
Yes. e-Invoicing uses TallyPrime's connected services, and those require an active Tally Software Services subscription. If e-invoices suddenly stop generating, an expired TSS is the first thing to check.
Do I need a separate GSP or software for e-invoicing?
Not for the normal case. TallyPrime connects to the e-invoice portal directly once your GSTIN is registered there and an API user is created. What you do need is the portal registration done correctly, which is the step most businesses want help with.
Can I generate the e-way bill and e-invoice together?
Yes. Where the consignment requires an e-way bill, TallyPrime can request it along with the e-invoice so you are not entering the same invoice on two portals. Part B details such as the vehicle number can be added when the transport is arranged.
When is an e-way bill required?
For the movement of goods above the notified consignment value - commonly fifty thousand rupees for inter-state movement, with states free to set their own rules and exemptions for movement within the state. Validity is tied to the distance to be covered, so a long haul gets more days than a local delivery.
Can I cancel an e-invoice after generating the IRN?
An IRN can be cancelled on the portal within a limited window after generation - twenty-four hours - and it must be cancelled in full, not amended. After that window the correction has to be handled through a credit note, which is why it is worth getting the invoice right the first time.
Why does my e-invoice keep failing with an error?
Almost always a master data problem rather than a Tally problem: a party GSTIN that is wrong or inactive, a stock item without a valid HSN, a unit that is not on the official UQC list, or an incomplete address. Send us the error text and we will tell you which one it is.
What if the portal or my internet is down at billing time?
You can still bill. TallyPrime supports an offline route where invoices are exported as JSON, uploaded to the portal when it is reachable, and the signed response imported back so your vouchers carry the IRN. It is more steps, but nothing is lost.
Can you add the IRN and QR code to our existing invoice format?
Yes. If you use a custom printed format, the IRN, acknowledgement details and the signed QR code need a place on it. That is TDL work and we do it as part of the e-invoicing setup or separately if your format came from someone else.
Get e-invoicing working without the portal rejections
We check whether it applies to you, register the GSTIN, clean up the masters that the portal will reject, configure TallyPrime and stay on the phone through your first live week. Remote across India, on site around Himmatnagar.
Tally 3 Star Authorised Partner - 10+ years - 1000+ businesses across India - support in English, Hindi and Gujarati
Keep reading