Skip to content
/ .. /
Rater





Rater

The Rater configures tariffs in CSV files, and allows for specifying prices according to parameters such as call duration, such as setup price, increments, and SMS. Before using the Rater, it must be configured.

To use the Rater with custom Stepdefs, Rater Built-ins are available.

For more information about calculating charges, see Calculating, Converting and Rounding Charges.

Voice Call Raters - Setup, Time and Prices

The right column of a Voice Call Rater includes the Setup, the Time Unit and the Pricing for the time unit.

Syntax

1
2
<name Identifier>, (setup:<price Number>,) setup:<seconds Number>:<price Number>,
    <seconds Number>:<price Number>, ...

Parameters

  • name - The name assigned to the tariff

  • setup - A setup fee (optional) or a one-time cost at the beginning of a call

    • The time unit is always in seconds
  • seconds - This number indicates how many seconds are included for each price unit

    • For example, 60:x.xx means that the charge is per 60-second interval
  • price - The value that will be charged to each interval

    • For example, x:0.07 means that there is a charge of 0.07 per defined time interval

Note: The Rater can use decimals. Each decimal must be indicated by a period. For example, 1.03 and each value must be separated with a comma (,).

Example 1

1
setup:0.15, setup:60:0.23, 60:0.20

The example above has a setup fee of 0.15€. The first 60 seconds will be charged 0.23€ and every subsequent 60-second interval that follows will be charged 0.20€. This means the caller is charged 0.38 € at the beginning of the call (0.15 + 0.23).

Example 2

1
2
# charge 0.07 for first 60 seconds
setup:60:0.07, 1:0.06

The example above charges 0.07€ for the first 60 seconds. The second column shows that 0.06€ is charged for each additional second (0.06 €). Additionally, the # on the first line indicates a comment.

Example 3

1
setup:60:0.08, 60:0.07

The example above charges 0.08€ for the first 60 seconds and 0.07€ for the next 60 seconds is0.07.

SMS Raters - Units and Prices

Because the SMS charges do not include Time Units, SMS is written instead of a Time Unit.

Syntax

1
<name Identifier>:SMS, <messages Number>:<price Number>

Parameters

  • name - The name assigned to the tariff

  • messages - The number of SMS included in each price unit

  • price - The price per unit

Example

1
Public_Default: SMS, 1:0.09

In the example above, each SMS costs €0.09.

Example Rater Files

GeneralTariff_voice.csv

1
2
3
4
5
6
7
MainTariff,             setup:60:0.07,  1:0.06
MobileTariff,           setup:60:0.07,  1:0.06
fixLineNumber,          setup:60:0.27,  1:0.04
Mobilenet,              setup:60:0.27,  1:0.04
Voicemail_setUp,        setup:60:0.00,  1:0.00
Voicemail_check,        setup:60:0.00,  1:0.00
ChargeFree,             setup:60:0.00,  1:0.00

NewTariff_07_voice.csv

1
2
3
4
5
6
7
MainTariff_001,             setup:60:0.08,  60:0.07
MobileTariff_002,           setup:60:0.08,  60:0.07
fixLineNumber_025,          setup:60:0.08,  60:0.07
Mobilenet_02,               setup:60:0.08,  60:0.07
Voicemail_setUp_012,        setup:60:0.08,  60:0.07
Voicemail_check_013,        setup:60:0.08,  60:0.07
Chargefree_01,              setup:60:0.08,  60:0.07

The examples above show the following:

  • The names in the left column are the names of the Subscriptions according to the tariff they belong to. Each name must be unique.

  • The parameters on the right side are time units and the pricing for each time unit.

  • Lines in the Rater CSV files starting with # represent line comments, and are treated as blank lines.