# Sale Tax Config

<p class="doc-lead">Sale Tax Config assigns default taxes to sale transactions by sale type, item group, and item. Tax rows defined here apply when no line-level override exists.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<div class="doc-toc-links">
<a href="#/sales/sale-tax-config?id=overview">Overview</a>
<a href="#/sales/sale-tax-config?id=fields">Fields</a>
<a href="#/sales/sale-tax-config?id=how-it-works">How It Works</a>
<a href="#/sales/sale-tax-config?id=actions">Actions</a>
<a href="#/sales/sale-tax-config?id=faq">FAQ</a>
<a href="#/sales/sale-tax-config?id=related">Related</a>
</div>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview &amp; List View</h2>

Go to <b>Sales → Settings → Sale Tax Config</b> from the left menu.

Tax accounts must already exist under Accounts → Settings → Taxes. This screen is an inline table — add rows at the bottom and delete existing rows with the trash icon. There is no separate edit form.

<b>List columns</b>

| **Column** | **Description** |
|------------|-----------------|
| Sale Type | <a href="#/sales/sale-types">Sale Type</a> scope for the tax row. |
| Item Group | Optional scope by item group. |
| Item | Optional scope by single item. |
| Taxes | One or more sale taxes applied when the row matches. |

<b>Sale Tax Config</b>

<img src="sales/images/sale-tax-conf.webp" alt="Sale Tax Config" loading="lazy">

<hr class="doc-section-divider">

<h2 id="fields">Fields</h2>

| **Column** | **Description** |
|------------|-----------------|
| Sale Type | <a href="#/sales/sale-types">Sale Type</a> (Form Type) this tax row applies to. Required for matching. |
| Item Group | Optional. Narrows the rule to items in this group. |
| Item | Optional. Narrows the rule to one item. Most specific when all three are set. |
| Taxes | One or more tax types from Accounts (e.g. CGST, SGST, VAT). |

<hr class="doc-section-divider">

<h2 id="how-it-works">How It Works</h2>

When an item line is added on a sale bill, the system resolves taxes in this order:

<ol>
<li><b>Item-specific row</b> — sale type + item match</li>
<li><b>Item group row</b> — sale type + item group match (when no item row)</li>
<li><b>Sale type only row</b> — sale type with blank item group and item</li>
<li><b>Item master taxes</b> — default taxes on the item record when no config row matches</li>
</ol>

<p>If the sale type has <b>Require tax for every item</b> enabled, save is blocked when the resolved tax list is empty.</p>

<p><b>Connected reports:</b> Tax amounts flow into <a href="#/sales/reports/sale-report">Sale Report</a>, <a href="#/sales/reports/month-wise-einvoice-summary">Month Wise Einvoice Summary</a>, <a href="#/sales/reports/bill-item-wise-sale-report">Bill Item Wise Sale</a>, and accounts tax reports. Sale types with <b>Exclude in tax reports</b> are omitted from tax summaries.</p>

<hr class="doc-section-divider">

<h2 id="actions">Actions</h2>

| **Action** | **Description** |
|------------|-----------------|
| Add (+) | Saves a new row from the bottom blank line |
| Delete (trash) | Removes a configuration row |

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>Do I need a row for every item?</b><br>
No. Use sale-type-only or item-group rows for broad defaults. Add item rows only for exceptions.

<b>Can one row have multiple taxes?</b><br>
Yes. Select multiple taxes in the Taxes column (e.g. CGST + SGST).

<b>What happens if tax is missing on approve?</b><br>
When the sale type requires tax on all items, approve is blocked until every line has tax. Configure defaults here to avoid manual entry errors.

<b>Which row takes priority?</b><br>
More specific rows win: item-level over item-group over sale-type-only. Add exception rows only where the default tax differs.

<b>Does this override tax entered on the bill?</b><br>
Defaults apply when a line has no tax selected. Users can still change tax on the bill if permitted — unless the sale type enforces tax on all items.

<b>Do I need a separate config per sale type?</b><br>
Yes, when tax treatment differs by document type (e.g. export vs domestic). Link each row to the correct <a href="#/sales/sale-types">Sale Type</a>.

<hr class="doc-section-divider">

<h2 id="related">Related Topics</h2>

<ul>
<li><a href="#/sales/sale-types">Sale Types</a></li>
<li><a href="#/sales/sale-invoice">Sale Invoice</a></li>
<li><a href="#/sales/sale-settings">Sale Settings hub</a></li>
</ul>
