Rating & Charging

The objective of the Rating & Charging Configuration chapter is to provide comprehensive instructions on how to configure the rating and charging aspects of OCS.io. This chapter focuses on configuring entities such as GL Code, Tax, Charging Class, Special Days, and Time Periods. By properly configuring these entities, you can define the rules and parameters for rating and charging your products and services in OCS.io.

The chapter will guide you through the process of setting up GL Codes to categorize your financial transactions and facilitate accurate accounting. You will also learn how to configure Taxes to apply appropriate tax rates to your products and services based on regional or organizational requirements.

In addition, you will discover how to define Charging Classes, which enable you to group similar products or services and apply specific charging rules to them. Special Days and Time Periods configuration will allow you to define time-based charging scenarios, such as peak hours, off-peak hours, or seasonal rates.

GL Codes

The OCS.io supports General Ledger (GL) Codes for accounting purposes. GL Codes are used to categorize financial transactions and provide a way to track financial information within the system. The GL Codes can be configured within the Product Catalogue of the system. By configuring the GL Codes, the system can track financial transactions related to the organization’s various products and services. This enables accurate financial reporting and analysis and easier auditing and compliance with accounting standards. The Product Catalogue is a core component of the OCS.io, and GL Codes play a vital role in the accounting and financial management of an organization using the system.

To configure GL Codes, follow these steps:

  1. Access the Core Configuration perspective in the OCS.io user interface.

  2. Select the Rating & Charging  GL Codes.

  3. Click on the + (New) button to create a new GL Code.

  4. Fill in the required information in the form:

Configure GL Fee
Item Description

Name

Enter the name of the GL Code.

Description

Optionally, enter the description of the GL Code.

Code

Enter the External code to which the GL Code will be mapped in the result of rating, charging, and billing.

Repeat the above steps to configure additional GL Codes for Usage, Discounts, and Taxes:

Configure GL Usage
Configure GL Discount
Configure GL Tax

Taxes

In OCS.io, calculating Taxes is critical to the Rating & Charging process. The system offers out-of-the-box functionality to calculate taxes, which involves adding a defined tax rate to each event during Online Rating & Charging or a group of events with the same tax category during the Billing process. This functionality is suitable for businesses or tax jurisdictions with straightforward tax calculation requirements, such as most EU countries.

The system allows for the unlimited definition of tax rates, including standard rates (e.g., 19%), reduced rates (e.g., 5%), and no-tax rates (with a value of 0%). However, suppose your business or tax jurisdiction requires more complex Taxation, such as in the United States of America. In that case, the system offers the option to configure no-tax rates and process taxation using an external vendor, such as Vertex.

For more information on tax configuration and customization, refer to the documentation on Taxation.

To configure Taxes, follow these steps:

  1. Access the Core Configuration perspective in the OCS.io user interface.

  2. Select the Rating & Charging  Taxes.

  3. Click on the + (New) button to create a new Tax.

  4. Fill in the required information in the form:

    Item Description

    Name

    Enter the name of the Tax.

    Description

    Optionally, enter the description of the Tax.

    Code

    Enter the External code to which the Tax will be mapped in the result of rating, charging, and billing.

    Configure Tax

Once you click on the Save button, the Value History tab will be shown. Here, you can configure different values of the Tax for different time periods.

  1. Click on the + (New) button in the Values History tab to add a new Tax value.

  2. Fill in the required information in the form:

    Item Description

    GL Code

    Choose the GL Code which will be assigned to the Tax.

    Value

    Enter the Tax Value. The value should be entered as a percentage, e.g., 19 for 19%. You can enter precision up to 2 decimals.

    Value Valid From

    Enter the date from when this Tax Value is valid.

    Value Valid To

    Enter the date till when this Tax Value is valid. When no value is entered, the Tax Value is valid indefinitely.

    Configure Value of the Tax

Charging Classes

Charging Class is a fundamental entity within OCS.io that defines how charges for various services and events are calculated. A charging class is closely linked with other configurations within OCS.io and is used to determine the price and tariff applicable to a chargeable event.

OCS.io enables efficient and accurate charging and billing management by defining charging classes for different services and events. For example, charging classes may be defined for a one-time or recurring fee, data usage, voice calls, SMS messages, and other billable activities.

For more information on charging classes and their configuration within OCS.io, please refer to the documentation here.

Charging Class model supports tree configuration. This means that you can configure all above for certain node of the tree, automatically it will be applied to all sub-nodes.
Assume following configuration:

  • All

    • Usage

      • Content

        • Movies

          • Horrors

          • Action

          • Adult

        • Electronic Books

          • Classic

          • Best-sellers

    • Fees

      • Activation Fees

      • Recurring Fees

      • One-Time Fees

      • Termination Fees

    • Discounts

      • Usage Discount

      • Fee Discount

You can:

  • configure Discount 15% on all Horrors

  • configure 10 Books for free of category Classic

  • configure Minimal Commitment on all Usage and all Fees

  • configure Cost Control Balance of 100 EUR per Month on Movies

Configuration of the Charging Classes shall be found under the Core Configuration perspective, menu Rating & Charging  Charging Classes.

Configure Charging Class
Item Description

Name

Enter the name of the Charging Class.

Description

Optionally, enter the description of the Charging Class.

Code

Enter the External code to which Charging Class will be mapped in the result of rating, charging, and billing.

Use when define Fee

If checked, Charging Class is used when defining Fee.

Use when define Usage

If checked, Charging Class is used when defining Usage.

Use when define Discount

If checked, Charging Class is used when defining Discount.

GL Code

Optionally choose GL Code which will be assigned to the Charging Class.

Parent

Optionally choose parent Charging Class.

You can similarly configure additional Charging Classes for Usage and Discounts:

Usage Charging Class
Discount Charging Class

Special Days

In OCS.io, a Special Day is a predefined date representing a public holiday or other special days in a specific country or region. This feature is used to identify specific days with a different pricing structure or charging model than regular days. For example, some countries may have other pricing plans for weekends or public holidays. The special day feature allows the system to apply the correct pricing to such days accurately. Once a special day is defined, the system automatically applies the appropriate pricing structure or charging model to the affected events.

To configure a special day, follow these steps:

  1. Access the Core Configuration perspective in the OCS.io user interface.

  2. Select the Rating & Charging  Special Days.

  3. Click on the + (New) button to create a new special day.

  4. Fill in the required information in the form:

For a recurrent special day:

Item Description

Name

Enter the name of the special day.

Description

Optionally, enter the description of the special day.

Country

Choose the country for which the special day is configured. If a special day is observed in multiple countries, you will need to configure it separately for each country.

Country state

Optionally choose the specific state within the country for which the special day is configured.

Day

Enter the date of the special day.

Recurrent

Check this option if the special day occurs every year.

Configure Recurrent Special Day

For a non-recurrent special day:

Item Description

Name

Enter the name of the special day.

Description

Optionally, enter the description of the special day.

Country

Choose the country for which the special day is configured.

Country state

Optionally choose the specific state within the country for which the special day is configured.

Day

Enter the date of the special day.

Recurrent

Leave this option unchecked.

Configure Non-Recurrent Special Day

Time Periods

In OCS.io, Time Periods can specify different periods within a day. This feature is often utilized to differentiate usage between peak and off-peak periods.

For example, a mobile network operator may define a Period from 8:00 AM to 8:00 PM as the Peak period and another from 8:00 PM to 8:00 AM as the Off-Peak period. Usage during the Peak period may be charged at a higher rate than usage during the Off-Peak period.

To configure Time Periods, follow these steps:

  1. Access the Core Configuration perspective in the OCS.io user interface.

  2. Select the Rating & Charging  Time Periods.

  3. Click on the + (New) button to create a new Time Period.

  4. Fill in the required information in the form:

Item Description

Name

Enter the name of the Time Period.

Description

Optionally, enter the description of the Time Period.

Code

Enter the code of the Time Period. This code will be used in the results of rating, charging, and billing.

Monday - Sunday

Check this box if the Time Period applies to Monday - Sunday.

Special Day

Check this box if the Time Period applies to Special Days (configured on a separate screen).

Time From

Optionally, enter the starting time within the configured day/s when the Time Period is applied. If populated, Time To must be configured.

Time To

Optionally, enter the ending time within the configured day/s when the Time Period is applied. If populated, Time From must be configured.

Configure Time Period

Because we configured Workdays as Monday - Friday between 08:00 and 17:00, we must configure rest of the day time periods as follows:

Configure Time Period for Morning
Configure Time Period for Afternoon

Additionally, you can configure Time Period for Weekends and Holidays as follows:

Configure Time Period for Weekends and Holidays

Time Period Groups

In OCS.io, Time Period Groups are a helpful feature for organizing multiple Time Periods into a single entity that can be used in other configurations.

For instance, you may have several Time Periods that define various pricing structures for different parts of the day, such as Off-Peak and Weekends. By grouping these Time Periods into a single Time Period Group, you can simplify the configuration process and make managing pricing for different services easier.

To configure Time Period Groups, follow these steps:

  1. Access the Core Configuration perspective in the OCS.io user interface.

  2. Select the Rating & Charging  Time Period Groups.

  3. Click on the + (New) button to create a new Time Period Group.

  4. Fill in the required information in the form:

Item Description

Name

Enter the name of the Time Period Group.

Description

Optionally, enter the description of the Time Period Group.

Code

Enter the code of the Time Period Group. This code will be used in the results of rating, charging, and billing.

Time Periods

Check all Time Periods that apply to the Time Period Group.

Configure Time Period Group

Additionally, you can configure also Timer Period Group for Off-Peak as follows:

Configure Time Period Group Offpeak