UC-07 · Draw netting

A draw is an advance against future commission. Earned commission nets against the agent’s draw balance. The app applies the cap first, then nets the draw against the capped amount, with a floor at $0.

Expected result: with a $1,000 draw balance, an agent who earns $800 gets a draw offset of $800, a net payable of $0, and a remaining draw balance of $200.

Setup

  1. On the Commission Setup card, turn Draw Enabled on.
  2. Give the agent a $1,000 draw: on Payment Batches, choose Create Draw Advance, select the agent, and enter 1,000. The advance raises the agent’s Draw Balance to 1,000 and records a negative obligation in the ledger.
  3. Assign the agent to a customer (as in UC-01).

Earn commission

Post a sale that earns the agent $800 of commission (for example, $16,000 at 5%).

Result

When the commission entry posts, the app derives the net payable as cap → draw → floor:

Step Value
Commission Amount 800.00
Cap deduction 0.00
Draw Offset Amount 800.00
Net Payable Amount 0.00

The agent’s Draw Balance falls from 1,000 to 200.00. The entry nets to $0, so it carries nothing into a payment batch. The app recovers the remaining $200 of draw from the agent’s next earnings.

Notes

  • The draw does not make the net payable negative. The offset stops at the earned (post-cap) amount, and the remainder carries forward.
  • The draw-balance update is atomic with the ledger entry. A failure leaves no partial state.
  • The draw advance entry itself nets to $0 net payable. A payment batch therefore does not gather it.

→ Related: Payments → Draw advances · Commission Setup → caps & draws