Updated on
Agent Agreement Versions
Keep each enrolment on the agent commission terms agreed when it was made, change an agent's terms with a new version, and correct or override versions safely.
An agent's commission terms change over time: a new rate for next year, a different bonus, a new payment trigger. Agreement versions make sure each enrolment keeps the terms that were agreed when it was made, so a change to an agent's terms never rewrites the commission on older enrolments.
Before you start
Agreement versions are part of agent commissions. You'll only see them when commissions are switched on for your account and your role can view commissions.
How agreement versions work
- Each agent has a numbered list of agreement versions: V1, V2, V3 and so on.
- A version holds the agent's terms at that point: the Commission Rules that apply and their rates, the Commission Type, the Organisation Bonus, the Payment Trigger and the commission tax settings.
- When an enrolment or application is created, it's linked to the agent's version in effect on that day. It keeps that version, even after the agent moves to a newer one.
- When an application is converted into an enrolment, the enrolment keeps the application's version.
- Commission already raised is never recalculated. Bill lines keep the amount and the version they were raised under.
An example
An agent's V1 pays 20% on tuition. From 1 March you agree 25%, so you create V2 effective 1 March.
| Enrolment created | Version | Commission rate |
|---|---|---|
| 10 February | V1 | 20% |
| 15 March | V2 | 25% |
Commission raised later for the February enrolment, for example on its second instalment, still uses 20%.
Commission rules and versions
Editing a commission rule doesn't change any agent's existing versions. The commission rule screens remind you: "Agents keep the terms of their current agreement version. Changes to commission rules reach an agent when a new agreement version is created on their profile."
So, after changing a rule, create a new version for each agent who should get the change.
The first version
You don't need to create an agent's first version. V1 is created automatically, from the agent's current commission terms, when their first enrolment or application is made. Agents who already had enrolments when agreement versions were introduced were given a V1, and their existing enrolments and applications were linked to it.
Viewing an agent's versions
Open the agent
Open the agent's organisation profile and select the Commissions tab.
Find the Agreement Versions card
The Agreement Versions card lists every version with its Effective Date, Expiry Date, Status, Commission Type, Organisation Bonus, Change Reason, and who created it and when.
See a version's rates
Click a version's row to open its commission rules, with the Percentage, Fixed Rate and Bonus Rate of each. Click it again to close them.
Version statuses
| Status | Meaning |
|---|---|
| Active | In effect today. |
| Scheduled | Its effective date is still in the future. |
| Expired | Its expiry date has passed. |
| Inactive | Switched off with a correction. |
Dates follow your account's timezone
Effective and expiry dates are days on your account's calendar. If your own timezone is different, the dates show the account's timezone next to them, for example 01/03/2027 (Australia/Brisbane).
Changing an agent's terms: create a new version
Create a new version whenever the agent's terms change from a date onwards. You need permission to edit commissions.
Open New Version
On the agent's Commissions tab, select New Version on the Agreement Versions card. The form is filled in from the latest version.
Set the dates
- Effective Date: the day the new terms start. It can't be before today, and it must be after the latest version's effective date.
- Expiry Date (optional): the day the terms end. Leave it blank for no end date.
Set the terms
- Commission Type and Organisation Bonus.
- Payment Trigger: when commission becomes payable (on invoice, as the student pays, on full payment, or on start date). Leave it on Account setting to follow your account's setting.
- Tax Rate and Commission is tax inclusive. Net-based commission carries no tax, so the form tells you these settings won't apply.
Choose the rules and rates
Under Commission Rules, change the Percentage, Fixed Rate or Bonus Rate where needed. Untick Include for any rule this version should leave out. At least one rule must be included.
Give a reason and save
Enter the Change Reason, for example "2027 agreement signed, tuition rate 25%", and select Save.
When you save, the previous version automatically ends the day before the new one takes effect. Until its effective date, the new version shows as Scheduled.
Plan ahead
You can create a version in advance, for example in December for terms starting on 1 January. Enrolments created before 1 January keep the current version.
Fixing a mistake in a version: correct it
If a version was entered wrongly, for example a 25% rate typed as 2.5%, you can correct it in place. A correction changes the version for every enrolment and application linked to it, so it's only allowed until commission has been raised or earned under that version. After that, create a new version instead.
Correcting needs the permission to change agreement versions, which only the Admin role has by default.
Open the correction
On the Agreement Versions card, select Correct This Agreement on the version's row. The button only shows on versions that can still be corrected.
Make the correction
You can change the expiry date, the terms, the rates of the version's rules, and untick Active to switch the version off. The effective date can't be changed, and rules can't be added or removed.
Give a reason and save
Enter the Correction Reason (up to 255 characters) and select Save. The reason is recorded in the audit trail.
Can't correct a version?
If commission has already been raised under a version, or an agent has already earned commission under it on payments they collected, SELMA refuses the correction. Create a new version with the right terms, then move the affected enrolments to it if needed (see below).
Moving an enrolment to another version
Occasionally an enrolment or application should earn commission under a different version, for example when a student was signed up under a deal agreed before the new version was entered in SELMA.
Open the Fees tab
Open the enrolment or application and select the Fees tab. The Agent Agreement figure shows the version it's on, for example V1, and the agent's name.
Change the version
From the actions menu, select Change Agreement Version. Choose the Version: you can choose any active version of the earning agent's agreement that has already taken effect.
Give a reason and save
Enter the Reason for the Change and select Save. The reason is recorded in the audit trail.
Commission raised from then on uses the chosen version. Commission already raised, or already earned on payments the agent collected, keeps its original version.
Changing the version needs the permission to change agreement versions, which only the Admin role has by default.
Permissions
| Task | Permission |
|---|---|
| See the Commissions tab and agreement versions | View commissions |
| Create a New Version | Edit commissions (/finance/commissions/edit) |
| Correct This Agreement and Change Agreement Version | Change the agent agreement version an enrolment earns commission under (/finance/commissions/agreement-override). Admin only by default. |
If you use custom roles, add the agreement version permission to the roles that need it in User Roles and Permissions.
Common questions
Agents keep the terms of their agreement version. Create a new version on the agent's Commissions tab so the change applies from its effective date.
A new version can't take effect before today, so terms that commission has already been earned under are never replaced after the fact. To fix an earlier version's terms, correct it instead, or move specific enrolments to another version.
Commission is earned under the agreement of the agent earning it. If that's no longer the agent the enrolment was linked under, SELMA uses the new agent's version in effect on the enrolment's date, or their first version if they had none then.
No. Bill lines keep the amount and the version they were raised under. Agreement versions only affect commission raised from now on.
Yes. Each enrolment's commission uses its own version, so one invoice can mix versions.
Last updated