Skip to main content

Run a period

A period is the window commission is calculated over — usually a calendar month.

The four states

OPEN  →  COMPUTING  →  REVIEW  →  CLOSED

OPEN — the period is accruing. Deals keep arriving from Pipedrive and commission updates as they do. This is what your reps see live in Pipedrive.

COMPUTING — Lokom is calculating. Every rule in every active plan runs against every qualifying deal in the window. Nothing is writable while this runs.

REVIEW — the numbers exist and are yours to check. This is where the real work happens. → Review and close

CLOSED — locked. Statements are final and exports can be produced from them.

Computing a period

Trigger the compute from the period. On a normal month this is quick; a first run over a large Pipedrive backfill takes longer.

You can re-run a computation while the period is in review — if you fixed a rule, corrected a quota, or a batch of deals landed late. Re-running recalculates from current data.

If any statement has already been validated, Lokom asks you to confirm before re-running, because recalculation can change a number you already signed off. That confirmation is not a formality: re-running after validating means re-reviewing.

If a computation pays nobody

A computation that finishes but pays nothing looks identical to a healthy one, so Lokom raises it instead of showing the usual green result:

Computation paid nobody <N> plans produced no commission, but have paid on this period before. Check the plan's Source and recipient fields before closing.

You only see this when the period has paid on that plan before — a genuinely empty period or a plan's first run stays silent.

It almost always means a rule edit broke a field reference. A rule whose Source, trigger field or recipient no longer resolves is not an error: Lokom skips those deals exactly as configured, and the run completes normally. Open the plan and check the rule you last edited before you close the period.

A rep sees no commission

Late-arriving deals

A deal that closes inside the window but syncs after you computed is a late arrival. Lokom tracks these rather than silently absorbing them, so you can see that the period changed after you last looked at it. Re-compute to pull them in.

Reopening a closed period

An admin can reopen a CLOSED period. This is the escape hatch for a genuine error found after close — a deal attributed to the wrong rep, a rule that was wrong all along.

Reopening invalidates any payroll export produced from that period. That is deliberate: an export is a claim about what you owe, and it must not survive the numbers behind it changing. If payroll has already run on that export, reopening does not undo the payment — you are now reconciling manually. Reopen with that in mind.