Schedule Definitions

A schedule definition specifies the different dimensions (columns) in a premium schedule, add-on premium schedule, adjustment type, group adjustment type, surcharge type, or fee schedule.

Schedule Definition

A schedule definition has the following fields:

Code

The functional identifier of the schedule definition.

Description

The description of the schedule definition.

Type

The following are the types of schedule definition options:

  • Premium

  • Policy Based Premium

  • Adjustment

  • Group Adjustment

  • Surcharge

  • Fee

The type cannot be modified if any of the following uses the schedule definition:

  • premium schedule

  • add-on premium schedule

  • fee schedule

  • adjustment rule

  • group adjustment rule

  • surcharge rule (POL-SCDE-001)

Surcharge Rule Evaluation

The following options are the way the system evaluates surcharge rules:

  • On Premium

  • After Adjustment

This field must and may only be specified if the type is Surcharge (POL-SCDE-006).

Premium Scope

The following are the options for the premium scope of the adjustment:

  • Product

  • Add-on

  • Total

This field must and may only be specified if the type is Adjustment or Group Adjustment (POL-SCDE-002).

Premium Schedule Type (scoped on)

The premium schedule type that the adjustment is scoped on. If left unspecified the adjustment applies to premium schedules of all premium schedule types.
This field may only be specified on schedule definitions of type Adjustment with a premium scope Product, and schedule definitions of type Surcharge with a surcharge rule evaluation Premium (POL-SCDE-004).

Add-On (scoped on)

The add-on that the adjustment is scoped on. If left unspecified the adjustment applies to all add-ons.
This field may only be specified if the premium scope is Add-on (POL-SCDE-005).

Distribute?

Is the surcharge distributed across the applicable components (products, add-ons, and adjustments)?
This field must and may only be specified if the type is Surcharge (POL-SCDE-003).

Schedule Condition

An optional dynamic logic condition that can be used to determine whether the premium schedule, adjustment, or surcharge using the definition should be applied to a policy enrollment product during premium calculation.
This field may only be specified if the type is Premium, Policy Based Premium, Adjustment, Group Adjustment, or Surcharge (POL-SCDE-008).

Line/Rule Evaluation Condition

An optional dynamic logic condition that can be used to customize the evaluation for the premium schedule lines, adjustment rules, surcharge rules, or fee schedule lines based on this schedule definition.

Enabled?

Any premium schedule, adjustment rule, surcharge rule, or fee schedule based on a disabled schedule definition is ignored during premium calculation or fee generation.

In Scope (for) Percentage Commission?

When set to Yes, the schedule definition is considered as an input to compute the base amount on which the percentage commission is applied.
This field may only be specified if the type is Adjustment, Group Adjustment, or Surcharge (POL-SCDE-007). For premiums the In Scope for Percentage Commission can be set on the premium schedule.

Reference Date Field Name

The name (as in the object model) of a date field on the policy calculation period that is used as the reference date to determine the schedule value during premium calculation. This field is only applicable for the premium calculation using the policy calculation period.

Fatal If Line Not Found?

Should a fatal message be raised if no line is found for the schedule during calculation?

Extensibility

Premium schedules can be extended with single-value dynamic fields.

Schedule Dimension

A schedule definition consists of zero, one, or more schedule dimensions. Each dimension represents a column. A schedule dimension has the following fields:

Schedule Definition

The schedule definition to which this schedule dimension belongs.

Field Name

The unique name of this column within a schedule definition (used in dynamic logic).

Display Name

The name of the dimension when displayed in the user interface.

Display Sequence

The placement of the column (from left to right) in the user interface.

Usage

Does this column show a single (1) Value field or two (2) fields to capture a Range of values?

When a schedule dimension is configured as a range, "Display Name" From and "Display Name" To columns are available in the lines and rules.

Type

The following are kinds of values that can be set in this column:

  • Parameter

  • Dynamic Field

  • Generic

The option Parameter is not allowed for schedule definitions of type Fee (POL-SCDI-006).

Datatype

The following are the datatype of the column:

  • Amount

  • Char

  • Date

  • Number

The datatype is mandatory for dimensions of type Generic (POL-SCDI-004). It is a derived field for dimensions of type Parameter and Dynamic Field.

Parameter

The Parameter Aliases that is represented by the column.
The parameter must and may only be specified for schedule dimensions of type parameter (POL-SCDI-001).

Dynamic Field Usage

The dynamic field that is represented by the column.
The dynamic field usage must and may only be specified for schedule dimensions of type dynamic field and the specified usage may not refer to a dynamic record definition or flex code set (POL-SCDI-002).

For dimensions of the type dynamic field, the dynamic fields on the following records can be chosen:

  • Enrollment Product (not allowed for schedule definitions of type Fee)

  • Fee Definition (only allowed for schedule definitions of type Fee)

  • Group Client

  • Group Account

  • Group Account Product (not allowed for schedule definitions of type Fee)

  • Policy

  • Collection Setting

  • Policy Calculation Period

  • Policy Enrollment

  • Policy Enrollment Product (not allowed for schedule definitions of type Fee)

  • Policyholder

  • Relation

  • Relation Address

  • Insurable Object1…​10
    Insurable Object1…​10 are the insurable object types configured in the system, for example, 'Car', 'House'.

Schedule dimensions of type dynamic field for Entities Enrollment Product, Policy Enrollment Product, and Group Account Product are not allowed for schedule definitions of type fee and schedule dimensions of type dynamic field for entity Fee Definition are only allowed for schedule definitions of type fee (POL-SCDI-006).

Schedule Dimension Values

A schedule dimension value stores the value of the configured schedule dimensions. It has the following fields:

Schedule Dimension

The schedule dimension to which the value belongs to.

Premium Schedule Line, Adjustment Rule, Fee Schedule Line

The reference to a premium schedule line, adjustment rule, or fee schedule line.

Value Character From, Value Date From, Value Nr From, Value Amount From

The value of the dimension. If the dimension usage is a Value , this is the exact matching value. If the dimension usage is Range , this is the lowest value. The field that is filled depends on the schedule dimension’s data type.

Value Character To, Value Date To, Value Nr To, Value Amount To

The highest value of the dimension if the schedule dimension is of usage Range. The field that is filled depends on the schedule dimension’s data type.

Parameter Aliases

A parameter alias is the business name for a specific calculation parameter that can be associated with, for example, an adjustment rule. Examples are the 'Office visit copayment' and the 'Member Deductible'.

A Schedule Dimension of the type parameter has to refer to one of these parameter aliases. The same list of parameter aliases is available on an enrollment product in the context of a policy.

During premium calculation, the parameter values listed in the rules and premium schedule lines are compared to the values set on the person’s enrolled products in order to determine if the rule or line applies. The same applies to values listed in the fee schedule lines during fee generation.

A parameter alias has the following fields:

Code

The functional identifier of the parameter alias.

Display Name

The name of the parameter when displayed in the user interface.

Display Sequence

The order in which parameter aliases are shown in the user interface.

Type

The type of value (amount, number, percentage, or service days).

Currency

The currency of the parameter value. The currency is required for parameter aliases of type amount and not allowed for other types (POL-PARV-001).