﻿---
title: clsPolicyRenewalRatingPlan
summary: API reference for clsPolicyRenewalRatingPlan.
status: draft
owner: Technical Writer
last_reviewed: 2026-07-31
library: SAIF.Business.Policy.Premium
reference_type: package
---

# clsPolicyRenewalRatingPlan

Represents the rating plan associated with a policy renewal; holds renewal-specific rating plan attributes used by renewal premium calculation workflows.*

## Purpose
- Persists and retrieves the rating plan attributes specific to a policy renewal.*
- Consumed by renewal premium calculation and rating plan reporting workflows.*

## Context
- Namespace: `SAIF.Business.Policy.Premium`
- Assembly/package: `SAIF.Business.Policy.Premium`

## Public members
| Member | Signature | Purpose |
| --- | --- | --- |
| PolicyNumber | `Public ReadOnly Property PolicyNumber() As Decimal Implements iPolicyPeriodRatingPlan.PolicyNumber` | The numeric policy number identifying the policy to which this record belongs. |
| CreateDate | `Public ReadOnly Property CreateDate() As Date Implements iPolicyPeriodRatingPlan.CreateDate` | The timestamp at which this record was created in the Oracle database. |
| CreateUser | `Public ReadOnly Property CreateUser() As String Implements iPolicyPeriodRatingPlan.CreateUser` | The username of the account that created this record. |
| EffectiveDate | `Public Property EffectiveDate() As Date Implements iPolicyPeriodRatingPlan.EffectiveDate` | The date from which this record is effective. |
| ExpirationDate | `Public Property ExpirationDate() As Date Implements iPolicyPeriodRatingPlan.ExpirationDate` | The date on which this record expires; null indicates no expiration.* |
| Code | `Public Property Code() As String Implements iPolicyPeriodRatingPlan.Code` | The classification or type code for this record.* |
| CodeDescription | `Public ReadOnly Property CodeDescription As String` | Human-readable description associated with the current code.* |
| TypeCode | `Public Property TypeCode() As String Implements iPolicyPeriodRatingPlan.TypeCode` | The classification type code for this record.* |
| TypeCodeDescription | `Public ReadOnly Property TypeCodeDescription As String` | Human-readable description associated with the current type code.* |
| ImpReasonCode | `Public Property ImpReasonCode() As String Implements iPolicyPeriodRatingPlan.ImpReasonCode` | The implementation reason code explaining why this rating plan was implemented for this period.* |
| ImpReasonDescription | `Public ReadOnly Property ImpReasonDescription As String` | Human-readable description associated with the current imp reason.* |
| ERMod | `Public Property ERMod() As Nullable(Of Decimal) Implements iPolicyPeriodRatingPlan.ERMod` | The experience rating modification (ER Mod) factor for this policy period's rating plan.* |
| ClaimRatingFactor | `Public Property ClaimRatingFactor() As Nullable(Of Decimal) Implements iPolicyPeriodRatingPlan.ClaimRatingFactor` | The claim rating factor applied to this policy period's rating plan.* |
| MeritRatingFactor | `Public Property MeritRatingFactor() As Nullable(Of Decimal)` | Numeric merit rating factor value used by this type's rating, billing, or reporting logic.* |
| SARAPFactor | `Public Property SARAPFactor() As Decimal Implements iPolicyPeriodRatingPlan.SARAPFactor` | The SARAP (Schedule and Rating Analysis Plan) factor for this policy period's rating plan.* |
| UpdateDate | `Public ReadOnly Property UpdateDate() As Date Implements iPolicyPeriodRatingPlan.UpdateDate` | The timestamp of the most recent update to this record.* |
| UpdateUser | `Public ReadOnly Property UpdateUser() As String Implements iPolicyPeriodRatingPlan.UpdateUser` | The username of the account that last modified this record.* |
| RatingPlanFactor | `Public Property RatingPlanFactor() As Decimal` | The numeric rating plan factor applied to premium computation for this policy period.* |
| Factor | `Public Property Factor(ByVal inAdjustedRateProvider As iAdjustedRateProvider) As Decimal Implements iPolicyPeriodRatingPlan.Factor` | Returns the rating plan factor applicable to the supplied class coverage provider.* |
| IsValid | `Public Overrides ReadOnly Property IsValid() As Boolean` | Returns True when all registered business rules pass; delegates to the framework rule engine. |
| IsDirty | `Public Overrides ReadOnly Property IsDirty() As Boolean` | Returns True when one or more tracked properties have been modified since the last save or MarkOld() call. |
| SetTypeCodeNull | `Public Sub SetTypeCodeNull()` | Clears `TypeCode`, marking it as null/unset so the column will be written as NULL on the next save.* |
| SetImpReasonCodeNull | `Public Sub SetImpReasonCodeNull()` | Clears `ImpReasonCode`, marking it as null/unset so the column will be written as NULL on the next save.* |
| SetERModNull | `Public Sub SetERModNull()` | Clears `ERMod`, marking it as null/unset so the column will be written as NULL on the next save.* |
| SetRatingPlanFactorNull | `Public Sub SetRatingPlanFactorNull()` | Clears `RatingPlanFactor`, marking it as null/unset so the column will be written as NULL on the next save.* |
| SetSARAPFactorNull | `Public Sub SetSARAPFactorNull()` | Clears `SARAPFactor`, marking it as null/unset so the column will be written as NULL on the next save.* |
| SetUpdateDateNull | `Public Sub SetUpdateDateNull()` | Clears `UpdateDate`, marking it as null/unset so the column will be written as NULL on the next save.* |
| SetUpdateUserNull | `Public Sub SetUpdateUserNull()` | Clears `UpdateUser`, marking it as null/unset so the column will be written as NULL on the next save.* |
| IsTypeCodeNull | `Public Function IsTypeCodeNull() As Boolean` | Tests whether `TypeCode` is null/unset in the backing Oracle column; returns True when the value has not been populated.* |
| IsImpReasonCodeNull | `Public Function IsImpReasonCodeNull() As Boolean` | Tests whether `ImpReasonCode` is null/unset in the backing Oracle column; returns True when the value has not been populated.* |
| IsERModNull | `Public Function IsERModNull() As Boolean` | Tests whether `ERMod` is null/unset in the backing Oracle column; returns True when the value has not been populated.* |
| IsRatingPlanFactorNull | `Public Function IsRatingPlanFactorNull() As Boolean` | Tests whether `RatingPlanFactor` is null/unset in the backing Oracle column; returns True when the value has not been populated.* |
| IsSARAPFactorNull | `Public Function IsSARAPFactorNull() As Boolean` | Tests whether `SARAPFactor` is null/unset in the backing Oracle column; returns True when the value has not been populated.* |
| IsUpdateDateNull | `Public Function IsUpdateDateNull() As Boolean` | Tests whether `UpdateDate` is null/unset in the backing Oracle column; returns True when the value has not been populated.* |
| IsUpdateUserNull | `Public Function IsUpdateUserNull() As Boolean` | Tests whether `UpdateUser` is null/unset in the backing Oracle column; returns True when the value has not been populated.* |
| Equals | `Public Overloads Shared Function Equals(ByVal objA As Object, ByVal objB As Object) As Boolean` | Static overload: compares two Object references for equality using value-equality semantics.* |
| Equals | `Public Overloads Overrides Function Equals(ByVal inObject As Object) As Boolean` | Compares this instance with another `Object` instance for value equality.* |
| Equals | `Public Overloads Function Equals(ByVal inObject As clsPolicyRenewalRatingPlan) As Boolean` | Compares this instance with another `clsPolicyRenewalRatingPlan` instance for value equality.* |
| GetHashCode | `Public Overrides Function GetHashCode() As Integer` | Returns a hash code consistent with the value-equality implementation. |
| ToString | `Public Overrides Function ToString() As String` | Returns a string representation of this instance, typically for diagnostics.* |
| NewPolicyRenewalRatingPlan | `Public Shared Function NewPolicyRenewalRatingPlan(ByVal inDataportal As IDataPortalInfo, ByVal inPolicyNumber As Decimal) As clsPolicyRenewalRatingPlan` | Creates a new cls policy renewal rating plan initialized from the supplied source values.* |
| GetPolicyRenewalRatingPlan | `Public Shared Function GetPolicyRenewalRatingPlan(ByVal inDataportal As IDataPortalInfo, ByVal inPolicyNumber As Decimal, ByVal inEffectiveDate As Date) As clsPolicyRenewalRatingPlan` | Loads a cls policy renewal rating plan that matches the supplied lookup criteria. |
| IsValidPolicyNumber | `Public Function IsValidPolicyNumber(ByVal target As Object, ByVal ruleArgs As clsRuleArgs) As Boolean` | Executes the is valid policy number behavior defined by this type. |
| IsValidEffectiveDate | `Public Function IsValidEffectiveDate(ByVal target As Object, ByVal ruleArgs As clsRuleArgs) As Boolean` | Executes the is valid effective date behavior defined by this type. |
| IsValidExpirationDate | `Public Function IsValidExpirationDate(ByVal target As Object, ByVal ruleArgs As clsRuleArgs) As Boolean` | Executes the is valid expiration date behavior defined by this type. |
| IsValidPlan | `Public Function IsValidPlan(ByVal target As Object, ByVal ruleArgs As clsRuleArgs) As Boolean` | Executes the is valid plan behavior defined by this type. |
## Inherited public members

| Member | Signature | Purpose | Origin |
| --- | --- | --- | --- |
| Rules | `Property Rules As clsRulesManager` | Framework rules manager used to register, evaluate, and surface broken rules on the object.† | `SAIF.Framework.Core — clsBusinessBase` |
| BeginEdit | `Sub BeginEdit()` | Starts an n-level edit session so callers can stage changes.† | `SAIF.Framework.Core — clsBusinessBase` |
| CancelEdit | `Sub CancelEdit()` | Rolls back the active edit session.† | `SAIF.Framework.Core — clsBusinessBase` |
| ApplyEdit | `Sub ApplyEdit()` | Commits the active edit session.† | `SAIF.Framework.Core — clsBusinessBase` |

## Behavioral notes
- Source file: `Business\SAIF.Business.Policy.Premium\clsPolicyRenewalRatingPlan.vb`.

## Constraints and usage notes
- Scoped to renewal policy periods; attributes must be consistent with the renewal rating plan reference data.*


> **Note:** Statements marked with * were inferred from code structure, naming conventions, or
> contextual evidence where direct confirmation was not available in source artifacts. Statements
> marked with ** could not be confirmed; treat as unknown until verified.

## Sources
- `Business\SAIF.Business.Policy.Premium\clsPolicyRenewalRatingPlan.vb`