Rule-Based Scorecard Setup

  • Updated

Rule-Based Scorecard Setup

With Q2 Origination, you can define rule-based scorecards. Using these rules, you can define the success and failure conditions that can determine the final score of a scorecard. The rules are executed based on the execution criteria defined. Scorecard and evaluation criteria can be defined on any object and any field within the object from the Salesforce database. For example, bank data or credit report data.

  • Scorecard Selection Criteria - defines the criteria on which the scorecards are selected for the given object type.

  • Evaluation Criteria - defines the execution order of the criteria.

  • Scorecard Criteria - defines the criteria on which the credit scores are calculated.

Define a Scorecard Set

You need to define a scorecard set before you define a scorecard.

Prerequisites

Before you proceed to define a scorecard set, ensure that the following prerequisite is met:

  • The Use Rule based scorecards checkbox under Org Parameters is selected.

Steps

To define a scorecard set:

  1. Log in to your Salesforce account.

  2. Go to Origination Configuration > Scorecards.

  3. Select New Scorecard Set.

  4. Specify the required Scorecard Set Name. 

    For example, FICO Score.

  5. In the Scorecard Set Type list, select Champion, and then select Save.

    The created scorecard set appears under the Scorecard Set list.

Define a Scorecard

Prerequisites

Before you proceed to define a scorecard, ensure that the following prerequisite is met:

  • The scorecard set for which the scorecard is to be configured is defined.

Steps

To define a scorecard:

  1. Log in to your Salesforce account

  2. Go to Origination Configuration > Scorecards.

  3. From the list of scorecard sets, select the Scorecard Set Name with which you want to associate the scorecard.

  4. Select New Scorecard.

  5. On the Scorecard page, provide the details as described in the following table, and then select Save: 

    Field Name Action and Information
    Scorecard Details
     Scorecard Name

    Specify a name for the scorecard to help you identify the object or criteria being scored.

    For example, Credit scorecard or Income scorecard.

    This is a mandatory field.

     Object Type

    Select the object for which the scorecard is created. This can be Application, Account, or Party.

    This is a mandatory field.

    External IdThis is a mandatory field.
    Scorecard Selection Criteria (Select +)
    SequenceThe sequence number of the defined criterion is associated with the rule.

    Related Object

    The object for which the scorecard is to be defined.

    This is the object type you select while creating the scorecard.

    Field Name

    The field whose value is evaluated through the scorecard selection criteria.

    This is a mandatory field.

    Lookup Object Field NameThe value of the lookup object selected in the Field Name field.
    Second Level Lookup Field
     Operator

    The required operator to define value or the range of values for the field to evaluate the value.

    For example, >, =, <=, or BETWEEN.

     Value

    The value against which the user's data is to be matched.

    Note:

    If you have selected FieldName = Date, you must specify the value in MM/DD/YYYY format.

    RemoveThis icon is to remove the criterion.
    Evaluation Criteria
    Evaluation Rule

    The order in which the defined selection criteria should be evaluated. In the case of multiple criteria, this can be achieved using the evaluation expression. 

    For example, 1 AND 2

    Note:

    If no condition is defined here, the selection criteria get executed as per AND condition.

Define Scorecard Criteria

In the Scorecard Criteria section, define the criteria on which the credit scores are calculated. If more than one criteria are defined, the final credit score value is the consolidated value of all the credit scores.

Prerequisites

  • The scorecard set for which the scorecard is to be configured must be defined.
  • The scorecard for which the scorecard criteria are to be configured must be defined.

Steps

To define scorecard criteria:

  1. Log in to your Salesforce account

  2. Go to Origination Configuration > Scorecards.

  3. From the list of scorecard sets, select the Scorecard Set Name and then select the Scorecard Name.

  4. Select New Scorecard Criteria.

  5. On the Scorecard Criteria page provide the details as described in the following table, and then select Save: 

    Field Name Action and Information
    Scorecard Criteria Details
     Scorecard Criteria Name

    Name for the scorecard criteria.This is a mandatory field.

     Object TypeThe object for which the scorecard is created. This field is auto-populated.
    External Id
    Scorecard Criteria (Select +)
    SequenceThe sequence number of the defined criterion is associated with the rule.

    Related Object

    The object for which the scorecard is to be defined.

    This is the object type you select while creating the scorecard.

    Field Name

    The field whose value is evaluated through the scorecard criteria.

    This is a mandatory field.

    Lookup Object Field NameThe value of the lookup object selected in the Field Name field.
    Second Level Lookup Field
     Operator

    The required operator to define value or the range of values for the field to evaluate the value.

    For example, >, =, <=, or BETWEEN.

     Value

    The value against which the user's data is to be matched.

    Note:

    If you have selected Field Name = Date, you must specify the value in MM/DD/YYYY format.

    Evaluation Criteria
    Evaluation Rule

    The order in which the defined scorecard criteria should be evaluated. In the case of multiple criteria, this can be achieved using the evaluation expression. 

    For example, 1 AND 2

    Note:

    If no condition is defined here, the scorecard criteria get executed as per AND condition.

    Actions (Select Add Parameter)
    Input Parameter

    The parameter based on which the success or failure action is to be taken.

    The supported options are:

    • Score

    • Weight

    • Use Input Field as Score

    • Action type

    • Adverse Action Name

    Note:

    For Failure Action, select Adverse Action Name to assign the adverse reason with the application when it is rejected or withdrawn.

    Parameter Value

    The value

    Note:

    For Adverse Action Name, specify the adverse reason name that you have specified while configuring the reason code.

Example

In the following example, the applications that have Loan Amount between 1000 and 10,000 and the Asset Class Name contains the word unsecured are granted a score of 10 and a weight of 2. Because there is only one Scorecard criterion defined in this case, the final credit score value is 20.

In the Scorecard Selection Criteria section, define the selection criteria on which the scorecard is selected on the given object type. 

In the following example, the scorecard is set at the Application object so all the applications that satisfy the defined criteria (Loan Amount >= 100000 or the Interest rate <= 15%) are selected.

In the following example, the selection criteria 1, 2 are executed with an OR condition. 

In the Scorecard Criteria section, define the criteria on which the credit scores are calculated. If more than one criteria are defined, the final credit score value is the consolidated value of all the credit scores.

Scorecard Rule Result Logging

The logging of rule result related to scorecard enables the user to track the changes happening in scorecards over a period of time.

To enable this policy conditions, see Defining Rule Result Configuration

Note:

These changes do not impact the UI, it just tracks the changes made in the scorecrads by storing the rule results in the database, which can be viewed via Salesforce Reports feature.

In This Article