Skip to content
ExplanationForOrganization memberOrganization admin⏱ About 5 min

How rulesets work ​

A ruleset is your organization's scoring policy in one piece: the questions on the application form, the points each answer is worth, the score that earns each grade, and the rules that turn a grade into a rate, a term, a down payment and a highest payment. Every application is scored with exactly one version of a ruleset.

You find them under SAWScore → Rulesets. Everyone who can open applications can read them. Changing them needs the permission "SAWScore: edit, activate and archive rulesets".

Global rulesets and your own ​

The Rulesets screen has two parts:

  • Our rulesets: the ones your organization made. You change, activate and archive them.
  • Global rulesets: rulesets the BMA platform staff keep for every organization. They carry a Global label, and the one every organization starts with also says Default. You can open them, compare them and score with them, but you cannot change, activate or archive them. When you open one, the editor says "This is a global ruleset, shared by every organization and maintained by BMA platform staff."

To make your own version of a global ruleset, open the ⋮ menu on its row (or open it) and select Copy to our rulesets. Give the copy a name and select Make our draft. The copy is an ordinary draft of your organization: change it, test it and activate it as in Change your rules. The global ruleset stays as it is.

When the platform staff activate a newer version of a global ruleset, new applications can use it; applications already scored with the older version keep it, exactly as with your own rulesets.

The parts ​

PartWhat it decides
Sections and fieldsThe tabs of the application form and the questions in them. A scored field adds its points to its section's total.
GradesThe total score is looked up in the grade bands: the first band it falls in gives the grade (A to F). A score that fits no band gets the fallback grade.
AdjustmentsPoints added or taken off before the grade is looked up, for example for a repeat customer.
DecisionsLists of rules, tried from the top, that give the rate, term, down payment, rollover and repeat-customer calls, and the texts of the two decision lines.
Income and paymentHow pay cheques become a monthly income, and which share of that income a payment may take for each grade.
Co-buyerHow the buyer's and the co-buyer's answers are combined for the joint score.

Versions: draft, active, archived ​

A ruleset has a name and a version number. Each change is a new version, so the rules an application was scored with never change under it. This picture shows the life of one version.

  • Draft: nothing is scored with it. You can change it and test it as often as you like.
  • Active: it can be picked for new applications. When you activate a draft, any other active version of the same name is archived at that moment. Active rulesets with other names stay active.
  • Archived: it stays readable, and the applications scored with it keep their scores. It cannot be changed or activated again. To get it back, clone it to a new draft.

A new application offers your active rulesets first, then the active global ones (marked Global). Already chosen is your active ruleset created last, or, if your organization has no active ruleset of its own, the default global ruleset. If nothing is active at all, nobody can create an application: "There is no active ruleset. Activate one first."

An application stays with its version ​

An application remembers the version it was scored with, and saving it later scores it with that same version. This is on purpose: activating new rules next month must not quietly change the grade of a deal you approved last week.

An application moves to another version in three ways only:

  • Someone selects Re-evaluate on the application. It is moved to the ruleset a new application would get (your newest active one, else the default global ruleset) and scored again, and the state before is kept as a revision.
  • Someone restores an earlier revision, which brings back the ruleset of that revision.
  • A connected system asks for another ruleset through the API. This needs the permission to edit rulesets or the settings permission. The application screen has no button for it.

Compare ruleset on an application, and the What-if report, only show what another version would give. They change nothing.

The ruleset you start with ​

A new organization scores with the default global ruleset from the first day. It gets no copy of its own: under Our rulesets it says "Your organization has no ruleset of its own: it scores with the default global ruleset." When the platform staff improve the default, your new applications get the newer version. To have rules of your own, copy the global ruleset to your rulesets and activate your copy; from then on new applications use yours.

On a site without any global ruleset, a new organization instead starts with one ruleset of its own called Default, version 1, already active. It has the sections Stability, Income, Ability, Willingness, Underwriting / Trade-in and Manager overrides, and grades A to F. Its description says what to do next: "The standard scoring rules. Clone it to make your own version."

What this means for you ​

  • To change your rules, never look for an "edit" on the active version: clone it, change the draft, test it, then activate it. See Change your rules. For a global ruleset, use Copy to our rulesets.
  • Activating affects new applications only. Open deals keep their grade until someone re-evaluates them.
  • Keep one name (for example Default) for one policy. A draft with a different name does not replace your active version when you activate it: both are then active, and people must choose between them on every new application.