Admin guide

For administrators and finance users: configure plans, run payouts and keep the ledger healthy.

Setting up Commission Slate

After install, open Commissions and follow the setup wizard:

  1. Sources: turn on Deals, Invoices and/or Sales Orders as commission sources.
  2. Field mapping: map the date, amount, owner and status fields the engine reads on each source.
  3. Periods: choose how commission periods are cut (monthly, quarterly and so on).
  4. First plan: start from a template (solar setter and closer split, distributor invoice percentage, referral partner) or build one from scratch.
  5. Test: pick a real record and run the plan against it to see the commission it would produce before saving anything.
  6. Activate: turn the plan on. Choose Also calculate commission for existing records to backfill commission for records that already exist, instead of starting only from new activity.

If you leave the wizard before finishing, the Plans page shows a “Setup isn’t finished” banner with a Finish setup button that takes you back to where you left off.

Plans

Open Plans and choose a new plan, or pick Start from a template (solar setter and closer split, distributor invoice percentage net of discounts, referral partner). The plan editor has four sections:

  • Details: plan name, source module, and the dates the plan applies from and to.
  • Qualification: which records qualify (for example an invoice with a paid status) and which to treat as void.
  • Basis: the amount commission is calculated on, such as the invoice total, with optional deductions for shipping, tax or costs. You can floor the basis at zero.
  • Rules: who is paid and how. See below.

Plans have effective dates, so you can introduce a new plan going forward without rewriting earlier periods. Every save creates a new plan version; new calculations use the latest version, and each ledger line records the version it was calculated with. Recalculate a date range if you want history to follow the new plan.

Rules, payees, splits and tiers

  • Payees: users, contacts, accounts or vendors. Reps, managers, partners and referrers can all be paid.
  • Amounts: a flat amount, a percentage of the basis, or tiers.
  • Splits: divide one commission between several payees, for example 60% closer and 40% setter.
  • Targeting: limit a rule by person, product or team, and optionally stop evaluating further rules when it matches.
  • Explanation note: an optional sentence that appears in the reason on each generated line.

Use Preview on a plan to dry-run it without saving anything. Pick any real record with the record picker (search by name) and see the resulting lines (payee, rule, basis, rate, amount and reason) as a readable list.

Recalculating a date range

Commissions recalculate automatically when source records change. After changing a plan or correcting data, open Settings and choose Recalculate for the dates you want.

While a line is still unpaid (Pending or Approved), a recalculation corrects it in place. If the record no longer qualifies, the line’s status changes to Clawed Back and its reason records when and why. If only the amount changed, the line is updated and keeps a history entry such as “Updated 2026-11-03: $4,800.00 → $5,000.00 (source amount changed)”.

Once a line has been Paid, nothing on it is rewritten. A separate Adjustment line (amount changed) or Clawback line (no longer qualifies) is posted instead, so paid history and any statement already sent to a payee never change after the fact.

A record with no value in the date field mapped for its source is skipped. Logs shows a Warning naming the record and the field, and the same reason appears on that record’s Commission Breakdown. New setups default the Sales Orders date field to Created Time, which is always filled; existing setups keep the field you mapped, which you can change under Settings → Sources & field mapping.

Settings

Settings holds the configuration created by the setup wizard, which you can change at any time:

  • Sources and field mapping: which modules feed commission and which fields hold amounts, owners, dates and statuses.
  • Periods: how commission periods are cut.
  • Home currency: defaults to your organisation’s currency. Amounts are shown in this currency everywhere, and the currency you choose is kept.
  • Account: your License (Commission Slate is free; there are no paid tiers today), a Support contact you can copy or email, and the installed Version.

Ledger and Commission Breakdown

Ledger lists every commission line with a plain-language reason. Filter by payee, period or status, open a line for its full calculation, and export to CSV. Line types are Earned, Adjustment and Clawback; statuses are Pending, Approved, Paid and Clawed Back.

On a Deal, Invoice or Sales Order, the Commission Breakdown button shows how that record’s commission was worked out, line by line. Administrators see every payee’s amounts on the record.

Payouts

  1. In Statements, select the payee and period and choose Create payout.
  2. The dialog lists the exact lines that will be included. Confirm it; the payout contains exactly the lines you confirm.
  3. When the money has been sent, choose Mark as paid. The payout shows Paid immediately.
  4. If a payout was created in error, choose Void and confirm in the dialog.

A voided payout keeps status Void for audit, and its lines return to Pending so they can be included in a later payout. Nothing is deleted.

A payee can have more than one payout in the same period. Statements lists every one of them (Draft, Paid and Void), and the In draft column shows the total still sitting in draft payouts for that payee.

If a payee’s pending total for the period is zero or negative (for example, a clawback larger than their new earnings), no payout can be created for them until later earnings bring the total above zero.

Commission Slate records payouts; it does not move money.

Statements and printing

Each payout has a statement for the payee. In Statements, click Preview on a payee’s row to see it, or open the payout itself and click Print. Statements are formatted for print; use your browser’s print dialog to print or save as PDF.

Logs

Logs lists errors and warnings from calculations and scheduled checks, each with its source record and message. Fix the underlying issue (often a blank or unmapped field), then retry the calculation and mark the log entry resolved. If something is unclear, include the entry when you contact support.

Rep privacy

Reps see only their own lines: ledger lines and payouts are owned by the payee. To enforce this, set Commission Ledger sharing to Private in Zoho CRM’s Data Sharing Settings (in Setup, search for “Data Sharing”). Administrators and finance users keep full visibility.

Troubleshooting

SymptomLikely causeWhat to do
No commission lines for a recordThe record does not qualify, or no plan covers its dateCheck the plan’s Qualification and effective dates; use Commission Breakdown on the record.
Records skipped during recalculationBlank date fieldCheck Logs for the Warning naming the record and field, fill in the date and recalculate again.
Amounts look wrongBasis or field mapping does not match your dataReview Basis and Field mapping in Settings; use the Test step or Breakdown to inspect a record.
A rep can see others’ linesCommission Ledger sharing is not PrivateSet it to Private in Data Sharing Settings.
Errors in LogsUnmapped or unexpected field valuesFix the data, retry, then mark the entry resolved.
Wizard appears again after reinstallA fresh install always starts at setupComplete the wizard again.

Still stuck? Email [email protected] with your organisation name, a link to the record and a screenshot.