India GST, e-invoice and e-way bill: find your answer
GST, e-invoice, e-way bill, TDS and the GST returns in ERPNext come from the India Compliance app. Its
full documentation is at docs.indiacompliance.app.
This page lists the questions support receives most often, with a short answer and a link to the full one.
Setup
How do I set up GST? Install India Compliance, then set the company's GSTIN on its address, the GST
accounts in GST Settings → Accounts, and the tax templates.
GST setup
How do I turn on e-invoice and e-way bill? In GST Settings → General, turn on Enable API
Features, Enable e-Invoicing and the e-way bill options, then add credentials.
GST Settings
Do I pay for the GST APIs? On Frappe Cloud, API access is included, as long as the site is not logged
in to an India Compliance Account. On a self-hosted site, you buy credits.
GST API errors: credentials, GSTIN, "API credits exhausted"
One company with GST registrations in several states? Add an address with its GSTIN for each state.
Transactions pick the GSTIN from the company address.
GST for multiple branches
HSN codes, and the HSN validation? Set the HSN/SAC code on each item. GST Settings can require it and
check its length. GST setup: HSN codes
New Income Tax Act 2025 TDS and TCS sections? Update India Compliance to get the new Tax Withholding
Categories, then select them on suppliers. TDS setup
GST on invoices
Why is GST wrong, missing, or a few paisa off? Usually Place of Supply, GST accounts, the Item Tax
Template setting or rounding. Why is GST wrong or missing on my invoice?
Reverse charge (RCM) purchases? Add the reverse charge accounts in GST Settings and mark the purchase
invoice as reverse charge. Reverse charge
Ineligible input tax credit? India Compliance moves ineligible GST to the company's Default GST
Expense Account. ITC ineligibility
Exports, SEZ, nil-rated and zero-rated supplies? Turn on Enable SEZ / Overseas Transactions in GST
Settings and set the customer's GST Category to Overseas or SEZ.
Sales transactions
GST on advance payments, and reversal of ITC?
Other GST transactions
Input Service Distributor (ISD)? ISD
e-Invoice
e-Invoice shows Failed, has no IRN, or cannot be cancelled after 24 hours?
e-Invoice shows Failed, has no IRN, or cannot be cancelled
How do I generate or cancel an e-invoice?
Generating e-Invoice
Credentials or "API credits exhausted" errors? GST API errors
Testing without real invoices? Use sandbox mode.
Sandbox
e-Way bill
Generate, update Part B or the vehicle, extend, cancel, or for stock transfers and job work?
e-Waybill
Address, PIN code or HSN errors when generating?
Transaction validations
GST returns
An invoice is missing from GSTR-1, or totals do not match?
Why is my invoice missing from GSTR-1, or why don't the totals match?
Generate, compare and file GSTR-1? GSTR-1
GSTR-3B, and why can't I change an invoice after GSTR-3B is filed? India Compliance sets the ITC
Claim Period and blocks changes to periods already filed.
GSTR-3B and ITC Claim Period
Match purchase invoices with GSTR-2A and GSTR-2B?
Purchase Reconciliation
Invoice Management System (IMS)? GST IMS
GSTR-9, GSTR-6 or GSTR-7? Not generated by India Compliance. Use the GST reports (GST Sales Register,
GST Purchase Register, GST Balance) as the base, and file on the GST Portal.
GST reports
Errors after an update or a site move
TypeError or other errors after updating ERPNext or India Compliance? The apps must be on matching
versions: update both to the latest release of the same major version (for example both version-16).
Errors after an update
Encryption key error after moving the site? Enter the GST credentials again.
Encryption key error after moving a site