Generating e-way bills from Zoho Books. The GSP step, and the error that quietly blocks it

Zoho Books can generate an e-way bill from inside a sales invoice — but only after a one-time registration on the government e-Way Bill portal that has nothing to do with logging into Zoho Books itself. Get that step wrong and the setup won't look finished. Get past it, and a second, unrelated block can still stop generation with no warning — on a GSTIN that shows as perfectly active everywhere else.

Two one-time setups people conflate

Zoho Books actually needs two separate government-portal connections that look alike and get mixed up constantly: one for e-invoicing (IRN generation under Rule 48(4), covered separately here) and one for e-way bills, which is what this guide is about. Both route through a GSP registration screen that looks near-identical, and both name Zoho as the provider — but they're independent connections with independent credentials. Finishing one does not finish the other.

The GSP registration most guides skip a step on

Before Zoho Books can generate an e-way bill directly, you have to register Zoho Corporation as your GST Suvidha Provider on the government e-Way Bill System — a one-time step done on the government portal, not inside Zoho Books. Zoho's own registration guide lays out the screens:

Zoho's own setup documentation is direct about why Step 4 trips people up: to connect, "you have to enter your GSP credentials to connect Zoho Books with the E-Waybill System website. The GSP credentials are different from your E-Waybill System website credentials." Typing your ordinary e-Way Bill portal password into the Zoho Books connection screen is the single most common reason this doesn't work the first time — nothing on the screen warns you they're different accounts.

Generating an e-way bill from an invoice

Once connected, e-way bills are generated from Sales > e-Way Bills in Zoho Books, working from an existing transaction rather than a blank form. Per Zoho's own generation guide, you select the transaction and fill in what the invoice itself doesn't already carry:

• Document type and sub-type — invoice, credit note or delivery challan; and whether the movement is a supply, export or job work.
• Transporter details — transporter name/ID, distance in km, mode of transport, vehicle type and number, or the relevant transport-document number for rail, air or vessel.

Saving generates the e-way bill and its validity period against the government system directly — there's no separate file to export and upload for a transaction generated this way.

Not every invoice is selectable, and this is where "the button won't let me pick my invoice" support threads usually end up. Zoho's own FAQ gives the exact filter: an invoice appears in the picker only if "the total invoice amount should be greater than or equal to ₹50,000" and "the items associated with the invoice should be goods and must be taxable." A service line item or an invoice under ₹50,000 won't show up — not a bug, just the eligibility filter working as intended.

Worth checking rather than assuming: the intra-State threshold is set by each State's own Rule 138 and is not the same everywhere. Look up your own State's own e-way bill notification before relying on a number for intra-State movement — the state-wise tables that circulate on tax blogs are not something Recoup independently verifies, and starting from the wrong one under- or over-triggers generation for every invoice after it.

The blocked-user error — and why "the GSTIN is active" doesn't help

The most disorienting failure at this stage isn't a credentials problem at all. Zoho's own FAQ names it precisely: "Why am I getting a blocked user error when trying to generate an e-Way bill, even though the GSTIN is active?" The GSTIN can look completely normal on the GST portal — registered, not suspended, not cancelled — and still be refused by the e-way bill system specifically.

The underlying rule is Rule 138E of the CGST Rules, and the counts differ by return type — worth stating precisely rather than as one flat number (position as of 14 September 2026):

• A composition taxpayer (or one availing Notification 02/2019-Central Tax (Rate)) who hasn't filed CMP-08 for two consecutive quarters.
• Any other taxpayer who hasn't filed their return (ordinarily GSTR-3B) for two consecutive tax periods.
• Any other taxpayer who hasn't filed GSTR-1 for any two months or quarters — not necessarily consecutive.
• Anyone whose registration is suspended under Rule 21A(1), (2) or (2A).

Since a 2021 amendment (Notification 15/2021-Central Tax, 18 May 2021, para 2(vi)), the block bites only on that GSTIN's own outward movements — it no longer stops someone else from generating an e-way bill on which the blocked GSTIN is merely the recipient. Zoho's own KB still describes the block as applying "either as a Consignor or a Consignee" — that is the pre-18-May-2021 wording, from before Notification 15/2021-Central Tax narrowed the rule to outward movement only. Treat Zoho's line as a description of how it once worked (or of portal behaviour Zoho hasn't updated its KB to match), not of what the rule currently says.

Fixing it, per Zoho's own guidance:

1. File the missing return(s). Once filed, the e-way bill system picks up the updated filing status from the GST common portal and unblocks the GSTIN automatically — per Zoho's KB, "the next morning" by default (position as of 14 September 2026).
2. Need it sooner? On the e-way bill portal, go to Search > Update Block Status, enter the GSTIN, and select Update — this pulls the latest filing status from the GST portal immediately rather than waiting for the overnight sync.

An e-way bill failure is usually a symptom, not the problem

Neither of the two failures above is really about e-way bills. A blocked GSTIN is a filing-status problem that happens to surface at the e-way bill screen first, because that's the first place in the chain that checks it against a live government system. The same is true of a rejected consignment value or a stale party GSTIN — Zoho Books is correctly reporting a number that was already wrong in the sales register before anyone tried to ship against it.

A GSTIN blocked by two consecutive unfiled GSTR-3B returns doesn't fail quietly for one shipment — it stops every outward e-way bill on that GSTIN until someone notices and files, which is exactly the kind of gap that's painful to catch manually across a live purchase and sales register, especially when the return that lapsed belongs to a different team than the one trying to ship goods that afternoon.

How Recoup fits in

Recoup doesn't register GSPs or generate e-way bills — that's the setup above. What it does is sit upstream: continuously reconciling your ITC against GSTR-2B and flagging the same class of stale GSTIN, mismatched value or unfiled-return risk that also blocks an e-way bill — before it reaches a shipping screen, not after a truck is already waiting at the gate.

Related guides