# Commission On Transaction

<p class="doc-lead">Commission / Bonus on Transaction links a <a href="#/sales/sale-invoice">Sale Invoice</a> to employee commission and bonus lines. On approve, the system validates totals against <a href="#/payroll/payroll-settings-config?id=commission">Payroll Settings maximum commission %</a> and auto-creates <a href="#/payroll/additional-payment">Additional Payment</a> lines for the pay run. An active commission record blocks cancellation of the linked sale invoice.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Getting started</span>
<div class="doc-toc-links">
<a href="#/payroll/commission-on-transaction?id=overview">Overview &amp; List View</a>
<a href="#/payroll/commission-on-transaction?id=quick-start">Quick Start</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">Form reference</span>
<div class="doc-toc-links">
<a href="#/payroll/commission-on-transaction?id=header-fields">Header Fields</a>
<a href="#/payroll/commission-on-transaction?id=commission-lines">Commission Lines</a>
<a href="#/payroll/commission-on-transaction?id=validation">Validation &amp; Limits</a>
</div>
</div>
<div class="doc-toc-section">
<span class="doc-toc-group-title">More</span>
<div class="doc-toc-links">
<a href="#/payroll/commission-on-transaction?id=actions-status">Actions &amp; Status</a>
<a href="#/payroll/commission-on-transaction?id=additional-payment">Additional Payment Link</a>
<a href="#/payroll/commission-on-transaction?id=sale-invoice-block">Sale Invoice Cancel Block</a>
<a href="#/payroll/commission-on-transaction?id=example">Worked Example</a>
<a href="#/payroll/commission-on-transaction?id=related">Related &amp; Reports</a>
</div>
</div>
</div>

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

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

Go to <b>Payroll → Commission On Transaction</b> (ERP route: <code>employeeAdditionalPaymentOnTransaction</code>).

The list shows every commission-on-transaction record with the linked sale invoice, customer, totals, and status.

<b>List columns</b>

| **Column** | **Shows** |
|------------|-----------|
| Id | System reference. |
| Number # | Document number. |
| Date | Transaction date. |
| Sale Invoice | Linked sale invoice bill number. |
| Customer | Customer on the invoice. |
| Invoice Amount | Total invoice value. |
| Commission Total | Sum of commission amounts across all employee lines. |
| Bonus Total | Sum of bonus amounts across all employee lines. |
| Status | Draft, Approved, or Cancelled. |

<b>Quick filter tabs</b>

| **Tab** | **Shows** |
|---------|-----------|
| Default | All except cancelled. |
| Approved | Status Approved (additional payments created). |
| Draft | Saved but not approved. |
| Cancelled | Cancelled records. |

<b>Advanced Filters</b>

Id, Sale Invoice, Customer, Employee, Branch, Date, Status, Created Date.

<b>List row actions</b>

| **Action** | **Available when status is** |
|------------|------------------------------|
| Edit | Draft |
| Delete | Draft |
| View | All statuses |

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

<h2 id="quick-start">Quick Start — Create Commission On Transaction</h2>

<h3>1. Navigate</h3>
Go to <b>Payroll → Commission On Transaction</b> and click <b>New</b>.

<h3>2. Link sale invoice</h3>
<ul>
<li>Select the <b>Sale Invoice</b> for which commission or bonus is being allocated.</li>
<li>The system loads invoice amount, customer, branch, and discount totals from the invoice.</li>
</ul>

<h3>3. Add employee lines</h3>
In the <b>Commission Lines</b> section, add one row per employee:
<ul>
<li><b>Employee</b> — who receives the commission or bonus.</li>
<li><b>Commission %</b> and <b>Commission Amount</b> — percentage and calculated or entered commission.</li>
<li><b>Bonus %</b> and <b>Bonus Amount</b> — optional bonus percentage and amount.</li>
</ul>

<h3>4. Save or approve</h3>
<ul>
<li><b>Save</b> — keeps status Draft. No additional payments created.</li>
<li><b>Approve</b> — validates against branch commission limits, creates <a href="#/payroll/additional-payment">Additional Payment</a> lines, and marks the record Approved.</li>
</ul>

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

<h2 id="header-fields">Header Fields Reference</h2>

| **Field** | **Description** |
|-----------|-----------------|
| Date * | Date of the commission transaction. |
| Sale Invoice * | Approved sale invoice to link. Invoice amount and customer are pulled from this document. |
| Customer | Auto-filled from the sale invoice. |
| Branch | Branch from the invoice; used for commission limit lookup. |
| Invoice Amount | Total invoice value (read-only from invoice). |
| Discount Total | Total discount on the invoice (read-only). |
| Notes | Optional remarks. |

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

<h2 id="commission-lines">Commission Lines</h2>

Each line allocates commission or bonus to one employee for the linked invoice.

| **Column** | **Description** |
|------------|-----------------|
| Sl No. | Line number. |
| Employee * | Employee receiving commission or bonus. |
| Commission % | Percentage of invoice amount for commission. |
| Commission Amount | Commission amount (calculated from % or entered manually). |
| Bonus % | Optional bonus percentage. |
| Bonus Amount | Bonus amount (calculated from % or entered manually). |
| Notes | Line-level remarks. |

<p>Commission and bonus can be entered as a percentage (amount auto-calculated) or as a fixed amount. Total commission + bonus across all lines must not exceed the branch limits configured in <a href="#/payroll/payroll-settings-config?id=commission">Payroll Settings → Sale Invoice Commission</a>.</p>

<img src="payroll/images/transaction-wise-commisn-rep.webp" alt="Employee-wise commission breakdown (report view)" loading="lazy">

<p>The <a href="#/payroll/reports/transaction-wise-commission-report">Transaction Wise Commission Report</a> shows the same employee-level breakdown across invoices — useful for verifying allocations before or after approval.</p>

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

<h2 id="validation">Validation &amp; Limits</h2>

On <b>Approve</b>, the system checks commission and bonus totals against the branch limits in <a href="#/payroll/payroll-settings-config?id=commission">Payroll Settings</a>:

| **Setting** | **What is validated** |
|-------------|----------------------|
| Maximum Commission % | Total commission % on the invoice must not exceed this limit for the branch. |
| Commission Bonus % | Total bonus % on the invoice must not exceed this limit for the branch. |

<p>If totals exceed the configured maximum, approval is blocked and an error is shown. Adjust line percentages or amounts, or update the branch limits in Payroll Settings before approving.</p>

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

<h2 id="actions-status">Actions &amp; Status</h2>

<h3>View toolbar actions</h3>

| **Action** | **Description** | **Available when status is** |
|------------|-----------------|------------------------------|
| Approve | Validates limits; creates Additional Payment lines; blocks sale invoice cancel. | Draft |
| Edit | Opens for editing. | Draft |
| Delete | Permanently removes. | Draft |
| Cancel | Reverses the record and reopens linked additional payments if not yet paid. | Approved |

<h3>Statuses</h3>

| **Status** | **Description** |
|------------|-----------------|
| Draft | Saved, not approved. Editable. No additional payments. |
| Approved | Commission validated and additional payment lines created. Sale invoice cancel blocked. |
| Cancelled | Record reversed. Sale invoice cancel allowed again. |

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

<h2 id="additional-payment">Additional Payment Link</h2>

When a Commission On Transaction is <b>Approved</b>, the system automatically creates <a href="#/payroll/additional-payment">Additional Payment</a> records:

<ul>
<li>One additional payment per employee line (or grouped by employee and payment category).</li>
<li><b>Type</b> set to commission / by-transaction.</li>
<li><b>Payment Category</b> from payroll configuration for commission or bonus.</li>
<li><b>Year / Month</b> from the commission date or invoice date.</li>
<li>Line <b>status</b> Approved — ready to be pulled into the next <a href="#/payroll/pay-run">Pay Run</a> for that employee.</li>
<li><b>Payment Transaction</b> reference links back to this commission record and the sale invoice.</li>
</ul>

<p>On pay-run approve, linked additional payment lines move to Paid status along with other payroll settlements.</p>

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

<h2 id="sale-invoice-block">Sale Invoice Cancel Block</h2>

<p>While a Commission On Transaction record is <b>Approved</b> (active) for a sale invoice, the linked <a href="#/sales/sale-invoice">Sale Invoice</a> <b>cannot be cancelled</b>. The system blocks cancel to prevent orphaned commission payouts.</p>

<p>To cancel the sale invoice:</p>
<ol>
<li>Cancel the Commission On Transaction record first.</li>
<li>Cancel or adjust any linked Additional Payment lines if they have not been included in an approved pay run.</li>
<li>Then cancel the sale invoice.</li>
</ol>

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

<h2 id="example">Worked Example — Sales Team Commission</h2>

<p><b>Sale Invoice:</b> SI-1042, amount ₹50,000, customer ABC Traders, branch Main. Payroll Settings for Main branch: Maximum Commission % = 5%, Commission Bonus % = 2%.</p>

<b>Commission lines</b>
<ul>
<li>Employee Ravi — Commission 3% = ₹1,500, Bonus 1% = ₹500</li>
<li>Employee Priya — Commission 2% = ₹1,000</li>
</ul>

<b>Totals</b>
<ul>
<li>Commission total: 5% (₹2,500) — within 5% limit ✓</li>
<li>Bonus total: 1% (₹500) — within 2% limit ✓</li>
</ul>

<p>On approve: two Additional Payment records are created (Ravi ₹2,000, Priya ₹1,000). Both appear in the employees' next pay runs. Sale invoice SI-1042 cannot be cancelled until this commission record is cancelled.</p>

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

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

<b>What is the difference from Additional Payment By Commission?</b><br>
Commission On Transaction is created from an approved <a href="#/sales/sale-invoice">Sale Invoice</a> with employee lines tied to that invoice. Additional Payment can also be manual or group-based without a sale link.

<b>Why was my commission rejected on approve?</b><br>
Total commission or bonus percentages may exceed branch limits set on <a href="#/payroll/payroll-settings-config">Payroll Settings — Sale Invoice Commission</a>.

<b>Can I edit commission lines after approval?</b><br>
No. Cancel the Commission On Transaction, adjust linked Additional Payment lines if not yet on an approved pay run, then recreate from the invoice.

<b>Does discount on the invoice reduce commission base?</b><br>
Yes. Commission and bonus percentages apply to invoice amount minus discount amounts configured for commission calculation — see <a href="#/payroll/reports/transaction-wise-commission-report">Transaction Wise Commission Report</a>.

<b>When do additional payments appear on pay run?</b><br>
Approved commission lines are pulled into the employee's next pay run for the commission month. Pay-run approve marks the additional payment line Paid.

<b>Can I create commission from the Field Sale App?</b><br>
No. Commission On Transaction is created on the web from approved sale invoices when payroll commission is enabled.

<b>What happens if I cancel the commission record?</b><br>
Linked Additional Payment lines should be cancelled or adjusted before pay-run settlement. Sale invoice cancel block is lifted after commission cancel.

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

<h2 id="related">Related Topics &amp; Reports</h2>

<ul>
<li><a href="#/payroll/additional-payment">Additional Payment</a> — auto-created on approve</li>
<li><a href="#/payroll/payroll-settings-config?id=commission">Payroll Settings — Sale Invoice Commission</a> — branch commission limits</li>
<li><a href="#/payroll/pay-run">Pay Run</a> — pulls approved additional payment lines</li>
<li><a href="#/sales/sale-invoice">Sale Invoice</a> — source transaction</li>
<li><a href="#/payroll/reports/transaction-wise-commission-report">Transaction Wise Commission Report</a> — invoice-wise commission audit</li>
</ul>
