Commission returns

Commission has to follow a sale when it is returned or corrected. Bitta Commission never edits an earning: a return or correction request appends a signed delta earning linked to the original; a manual correction adds a new Manual Adjustment fact. This page shows you how to calculate linked returns, resolve credit memos on Unlinked Commission Returns and the Return Matching Workbench, and run governed changes through Commission Manual Corrections and Commission Correction Requests.

Before you start

• Credit memos must be captured as source facts. See Capture posted sales.
• Agree a return policy with finance on Commission Return Policies. Leave the plan blank for the company default; a plan version policy overrides it. Only Active policies are used.

Field	What it does
Unlinked Return Mode	A credit memo without a linked original invoice is rejected (Reject), credited as a negative sale to the salesperson (Credit As Negative Sale), or held for a manual link (Manual Link Required).
Timing Policy	Where a late return or correction is recognized when its original period is closed: Original Period If Open, Current Open Period or Block.
Match Tolerance Percent	How far a credit memo amount may exceed a candidate invoice line before the candidate is dropped.
Require Same Salesperson	Matching only considers invoices with the credit memo's salesperson code.

• Manual corrections and correction requests need a second user to approve them. The requester cannot approve their own.

Calculate a linked return

A credit memo linked to its original accepted invoice is calculated as a return run. It cannot be calculated until you review it.

1. Open Commission Calculation Runs, or the fact's Calculation Run from a batch, and select the return run.
2. Choose Preview and Calculate Return. Review Return Before Calculation shows, per participant and component, the Recognized Entitlement, the Projected Entitlement after the return, the Projected Return Delta and the Projected Eligible Delta. No return earning is posted by the preview.

3. Choose OK. Source, plan, period and original evidence are checked again, and the negative delta earning is written in the original's correction chain.

The return delta is the cumulative entitlement after the return less the cumulative entitlement already recognized, so on a cumulative or tiered plan the whole position is recalculated rather than the original line alone.

To check the result:

• Return Evidence on Commission Source Facts shows the original earning date, correction date, recognized and correct entitlement, the delta and eligible delta, and an evidence hash.
• Correction Links shows the immutable original-to-delta links, with Prior Period Adjustment and the resolved Posting Date when the original period was closed.
• Difference Explanation opens Commission Difference Explanations: the cause, old amount, delta, new amount and any Affected Settlement that had already consumed the original.

Match unlinked returns

1. Open Unlinked Commission Returns. It lists accepted credit memos that have no linked original invoice.

2. Select a credit memo and choose Propose Links. Candidate original invoices are scored on amount, item, salesperson and quantity, and the Return Matching Workbench opens.

3. Review the Match Score and Match Reason Code of each candidate, select the best one and choose Link and Replay. On Correction Run Context, enter the Plan Code, Plan Version No., Period Code and Reason Code, and choose OK.

4. The credit memo is replayed as a linked return. Open Commission Calculation Runs and calculate it as described above.

Reject on a candidate asks for a Reason Code; the credit memo stays in suspense until another candidate is linked. When the return policy allows it, Credit As Negative Sale on Unlinked Commission Returns calculates the credit memo as a negative credit to its salesperson through the normal pipeline instead.

Make a manual correction

Use a manual correction when you must adjust commission that no source document explains.

1. Open Commission Manual Corrections and create a correction.

2. On Commission Manual Correction, choose the Action Type: Add, Subtract, Transfer to another participant, Reclassify to another component, or Release Pending. Fill in the positive Base Adjustment Amount (the action decides the sign and the plan model converts it to commission), an Effective Date inside the selected open period, Reason Code, Evidence Reference, and the participant, plan, version, component and period in the Scope group.

3. A second user chooses Approve.

4. Choose Process. A Manual Adjustment source fact is created and calculated through the commission pipeline, so the result has a full trace. A transfer posts a conserved pair that nets to zero. For Release Pending, Process releases the pending earning in Pending Earning Entry No. instead.

Raise a correction request

Use a correction request when something upstream changed and many earnings are affected. The Request Type is Plan or Rule Correction, Organization Correction, Quota Correction, Backdated Source, Reverse Correction or Credit Override.

1. Open Commission Correction Requests and create a request. Set the Request Type, the Recalculation Mode (Delta Only, Full Replacement or Preview Only), Timing Policy, Effective Date, Reason Code, and the affected plan, participant, quota, source or run.

2. Choose Analyze Impact. The Impact Preview lists every affected earning with its As-Was Amount, whether its period is closed (Period Closed) and whether a settlement already consumed it (Settled).

3. A second user chooses Approve.

4. Choose Queue Recalculation. The items appear on Commission Recalculation Queue and are processed in chunks, earlier chunks first. A Preview Only request is never queued.

5. Let the job queue process them, or choose Process Now. Difference Explanations shows the old and new result of every delta.

Closed periods are never reopened; the timing policy decides where deltas post. When the original period is closed, a delta the policy allows posts as a prior-period adjustment in a later open period, and a negative delta on a settled earning may become recoverable. See Commission clawbacks.

To undo a correction run, choose Reverse Correction Run on Commission Correction Links. It creates a Reverse Correction request; approving and recalculating it appends a new delta, and neither history layer is deleted. Change Events on the request shows the append-only decision log with before and after hashes.

For the reports that list corrections and recoveries, see Commission reports.

What's next

Work the exceptions that runs and corrections raise: Exception handling.