E-Way Bill

Common e-way bill errors and fixes

1 min read Updated 03 Oct 2026 3 views

AI summary

The errors people hit most on the EWB portal and API, and what to do.

1 sections

Error meaning	Why it happens	Fix
GSTIN blocked for EWB generation	GSTR-3B / CMP-08 not filed for 2 periods	File the pending returns; unblocking follows
Invalid GSTIN / GSTIN cancelled	Party master has a wrong or inactive GSTIN	Verify on the GST portal and correct
EWB already generated for this document	Same document type + number + GSTIN used before	Use the existing EWB or correct the document number
Distance exceeds the allowed limit	Entered more than 10% above PIN-to-PIN distance	Enter a distance within the limit
Invalid vehicle number format	Spaces, symbols or wrong pattern	Use format like `MH12AB1234`; temporary numbers start with `TR`
Document date older than 180 days	Base invoice is too old	Issue a fresh document where legally allowed
Cannot cancel — verified by officer / time over	Past 24 hours or verified in transit	Cancellation not possible; keep the record
Cannot extend — outside the time window	Not within 8 hours before/after expiry	Generate a new EWB
Invalid PIN for the state	PIN does not belong to the chosen state	Correct the PIN (use the PIN Lookup tool)
HSN invalid / tax rate mismatch	Wrong HSN or rate	Use a valid HSN and notified rate

Invalid token / session expired: authenticate again.
Invalid decryption: session key changed; get a new token.
Not authorised for this GSTIN: the API user is not linked to that GSTIN on the EWB portal.

Tip: generate the EWB from the e-invoice wherever possible. Fewer fields to type, fewer errors.

Sources

Was this guide helpful?