Skip to content
QiTASC.com / Calculation Steps /
Calculating, Converting and Rounding Rater Charges
/ .. /
Calculating, Converting and...





Calculating, Converting and Rounding Rater Charges

These Steps use variables defined in the Raterto:

  • Calculate how much a call or SMS should be charged

  • Convert currencies

  • Round a call and calculate the charge for the resulting value

Rater variables must also be set in the Rater Configuration.

Calculating the Charge

The following step calculates the charge by either:

  • Verifying that an amount consisting of the tariff for the call duration or number of SMS sent correlates to a value defined in the Rater.

  • Verifying that an amount corresponds to the result of a calculation.

Syntax

1
2
the charge for <tariff Identifier>(<amount Number>) is
    <charge Any>

Parameters

  • tariff - The tariff defined in the Rater

  • amount - One of call duration in seconds or the amount of SMS sent

  • charge - The total charge calculated for the call duration or amount of SMS sent

    • This may be any expression that resolves to a number
    • For example, a number, a calculation such as (10+6), or a context object

Example

1
2
3
Then the charge for CH_01(20) is 120
Then the charge for CH_02(20) is (120 - 60)
Then the charge for CH_01(10) is (balance1 - balance2)
This step is eligible for:

  • Deferred

Converting the Charge

The following step converts a charge's value from one currency unit to another currency unit.

Syntax

1
2
convert <value Any> as <name Identifier> from
    <currencyUnitFrom Identifier> to <currencyUnitTo Identifier>
Parameters

  • value - The charge's value

    • This may be any expression that resolves to a number, therefore, a number, a calculation such as (10+6), or a context object
  • name - The variable that stores the conversion result

  • currencyUnitFrom - The monetary unit (such as Euro, Dollar) to convert from, as defined in the Rater configuration

  • currencyUnitTo - The monetary unit (such as Euro, Dollar) to convert to, as defined in the Rater configuration

Example

1
And convert myCredit as specialCredit from Euro to Cent

Calculating the Charge with Conversion

The following step calculates the charge and converts it to another unit. For example, from Euro to Cent.

Syntax

1
2
calculate the charge for <amount Number> of <tariff Identifier> converted from
    <currenctUnitFrom Identifier> to <currencyUnitTo Identifier> as <name Identifier>

Parameters

  • amount - One of call duration in seconds or the number of SMS sent

  • tariff - The tariff defined in the Rater

  • currenctUnitFrom - The monetary unit (such as Euro, Dollar) to be converted from, as defined in the Rater configuration

  • currencyUnitTo - The unit to convert to, as defined in the Rater configuration

  • name - Stores the conversion result

Example

1
2
And calculate the charge for 20 of CH_01 converted
from Euro to Cent as callCostMOC

Calculating the Rounded Call

The following step returns a rounded value for the call duration and calculates the resulting charge.

Syntax

1
2
calculate the rounded call duration for <amount Number> of
    <tariff Identifier> as <name Identifier>

Parameters

  • amount - The call duration in seconds

  • tariff - The tariff defined in the Rater

  • name - The variable that stores the conversion result

Example

1
And calculate the rounded call duration for 65 of CH_02 as roundedIncrement

In the example above, if the billing increment was defined as 60:30 in the Rater, the call curation of 65 seconds returns 90 according to the charge used.