Recurrent Balance

The Recurrent Balance in the OCS.io is designed to track and manage the allocation of free units for a specific type of usage, such as calls to off-net destinations. It provides flexibility in configuring the balance’s validity period, rollover options, and notifications to ensure efficient utilization of the allocated resources in real-time.

Key features of the Recurrent Balance functionality include:

  1. Validity Period Configuration: Service providers can define the validity period, specifying how long the allocated free units remain active and available for usage. For example, free units for calls to off-net destinations can be valid for a specific time frame, such as 30 days from the activation or renewal date.

  2. Rollover Options: Service providers can configure whether unconsumed units are rolled over to the next period and, if so, for how long. This allows customers to carry forward unused units and maximize their usage over an extended period.

  3. Priority of Consumption: In cases where rollover units are available, service providers can set the priority of consumption for rolled-over units. For example, they can prioritize the usage of newly allocated free units before utilizing any carried-forward units, ensuring that customers fully utilize the most recent allocations first.

  4. Threshold-Based Notifications: The system allows the configuration of up to three independent notifications based on predefined threshold levels, such as 0%, 80%, and 100% utilization. These notifications can be delivered via various channels, such as SMS or email, helping customers stay informed about their usage and make informed decisions.

  5. Real-Time Monitoring: The system provides real-time monitoring of the balance, ensuring that any usage is immediately reflected in the balance. This allows for accurate and up-to-date tracking of the available free units.

Configuration in the GUI

This section describes how to configure Recurrent Balance in the GUI.

Recurrent Balance Service
Item Description

Create Balance At

Chose when recurrence occurs:

  • Subscriber Anniversary - applicable on Anniversary when Subscriber becomes Active

  • Offer Subscription - applicable at the date when Offer Subscription becomes Active

  • Bill Cycle Start - applicable at the Start of the Bill Cycle

  • Bill Cycle End - applicable at the End of the Bill Cycle

  • Month Start - applicable at the Start of the Calendar Month

  • Month End - applicable at the End of the Calendar Month

  • Monday - applicable on Monday

  • Tuesday - applicable on Tuesday

  • Wednesday - applicable on Wednesday

  • Thursday - applicable on Thursday

  • Friday - applicable on Friday

  • Saturday - applicable on Saturday

  • Sunday - applicable on Sunday

Every X (Recurrence Period)

Enter the length of the Recurrence Period.

Execute immediately

If checked, Balance is applied immediately. If not checked, Balance is applied from the next Recurrence Period.

Pro-Rate when Activated

If checked, Balance is Pro-Rated. This is applicable when the state becomes Active for the first time.

Pro-Rate when Not Charged

If checked, Balance is Pro-Rated. This is applicable only for the Suspended state when the appropriate State Reason is flagged as Charged.

Pro-Rate Mode

Choose how Pro-Rate functionality behaves:

  • Second - Pro-Ration is calculated with Seconds precision.

  • Day - Pro-Ration is calculated effectively at the end of the Day. Last state valid at the end of the Day is considered.

  • Noon - Pro-Ration is calculated effectively at the Noon. Last state valid at the Noon is considered.

  • Customer Friendly - Pro-Ration is calculated as "Friendly" for customer on Day basis. If the one of the State at the Day is marked as Not Charged independent on any other State at the Day, entire Day is not charged.

  • Provider Friendly - Pro-Ration is calculated as "Friendly" for customer on Day basis. If the one of the State at the Day is marked as Charged independent on any other State at the Day, entire Day is not charged.

Recurrence Cycles

Enter the number of Recurrence cycles for which Balance is applied.

UOM

Select kind of units which will be granted.

Pre-defined values are:

  • Event

  • Second

  • Minute

  • Hour

  • Day

  • Byte

  • Kilobyte

  • Megabyte

  • Gigabyte

  • Terabyte

  • Money

  • Piece

Granted Balance

Enter Balance which will be granted.

Reject when 100% Threshold reached

If checked, charging of event will be rejected when 100% threshold is reached.

This flag only applies if the Usage is charged online.

First Usage

If checked, the First usage Notification will be triggered.

Threshold #1 (%)

If a value is provided, the Threshold #1 Notification will be triggered when the defined threshold is reached.

Threshold #2 (%)

If a value is provided, the Threshold #2 Notification will be triggered when the defined threshold is reached.

Threshold #3 (%)

If a value is provided, the Threshold #3 Notification will be triggered when the defined threshold is reached.

Recurrent Balance Roll Over

Choose if and how unused Balance will be rolled over to next period.

Possible values are:

  • None

  • Append

  • Consume First

  • Consume Last

Roll Over Cycles

Enter the number of cycles how long unused Balance will be rolled over.

Include sub-classes

If checked, subordinate Charging Classes will be included in the evaluation of Balance application.

List of Charging Classes

Check all Charging Classes for which Balance will be applied.