Tax Rule
A tax rule is the logic that determines which tax rates apply to a transaction, based on what is being sold, who is buying, and where the supply takes place.
Also called Tax template · Tax category · Tax configuration · Rate determination
Why it exists
Because the correct tax on a transaction is a function of several facts the system already knows, and asking a human to compute it is asking them to be wrong occasionally and undetectably.
What it means to the business
Tax rules are where compliance either becomes automatic or becomes a monthly reconstruction. Configured as determination — derived from item, party and place — the return is a report. Configured as selection — a dropdown someone picks from — the return is an investigation, and every past period is only as correct as the least careful person who raised an invoice in it.
Draft. Configured, not yet in effect.
State 1 of 3
Tax Rule governed by GSTIN.
Open GSTINIt works until someone picks wrong, and nothing catches it because the invoice is internally consistent. Determination should be derived from the item, the party and the place of supply — and only overridden with a reason.
Rules that must hold
- Tax is determined by the transaction, not chosen by the user. A rate someone types in is a data-entry decision masquerading as a tax position.
- The determination depends on at least three inputs: the item's classification, the counterparty's status, and the place of supply.
- A tax rule change applies from a date forward. Retroactively editing a rule silently restates transactions already filed.
What commonly goes wrong
It gets set up for the common case and left there, because the common case is 95% of transactions and it works. The remaining 5% — inter-state, exports, reverse charge, exempt goods — are handled by someone overriding the default from memory. That person leaves, and the error rate becomes whatever their successor guesses.
Edge cases
- Reverse charge, where the buyer remits tax the supplier would normally collect and the invoice shows no tax at all.
- Composition-scheme suppliers, who charge no GST and pass on no credit — your cost is the full invoice.
- Exports and SEZ supplies, zero-rated with or without payment of tax, each with a different refund path.
- Mid-year statutory rate changes, where the applicable rate depends on the transaction date rather than the posting date.
- Bill-to and ship-to in different states, where place of supply follows a specific rule rather than the delivery address.
How ERPNext models it
| DocType | Note |
|---|---|
| Tax Rule | Maps party, item group and place of supply to a template. This is the determination layer that stops users choosing. |
| Sales Taxes and Charges Template | The rate set itself. Referenced by rules rather than selected on transactions. |
| Item Tax Template | Item-level overrides for goods taxed differently from their group — the exception mechanism. |
Last reviewed 2026-08-14
Machine-readable versionWe implement this for a living — that’s where the mistakes above come from. See the service or request a discovery briefing