Skip to main content

Rating process


Rating process

The rating process calculates the amounts on the invoices you send to your customers. It starts when a bill run is triggered and consists of three phases: 

  1. Initialization
  2. Charge processing
  3. Output generation

1. Initialization

The initialization phase gathers the necessary information to process charges in a subscription. Such information is related to:

  • Tenant and account information
  • Billing settings
  • Subscription charges
  • Usage records if a subscription rate plan has a usage charge

Tenant and account information are essential for determining the correct start and end dates of the billing period for a charge. Visit the following resources to learn more: 

Proration, proportional division, of a charge will happen as a result of certain business actions mid-billing period. How you decide to handle proration will impact the amount you charge your customers in these scenarios. Visit the following resources about configurable billing settings related to proration:

If a subscription charge is based on usage, check the following resources about settings and rating options related to usage charges:

2. Charge processing

After collecting the necessary information in the initialization phase, all the charges in a subscription are ready to be processed. 

The rating process handles the following charge models:

These charge models will have the following charge types:

  • One time charge
  • Recurring charge
  • Usage charge
  • Discount charge: You can create a discount charge to give your customers discounts. This is also included in the rating process.

All charges of a subscription are calculated one after another in a tight loop.

First, a charge processor is selected according to the charge type and charge model. If a charge is of the usage type, usages of the current billing period are picked up for calculation. 

Second, the charge processor calculates the rating result for the current charge segment in the target billing period(s). 

Next, rating begins to process discount charges if there are any. Discounts are implemented as if they are regular charges, but they cannot exist alone. Discounts have to be applied to non-discount charges. 

3. Output generation

After the charges are processed, chargeable events are produced and will be converted to invoice items. Besides chargeable events, the rating process also produces processed usages if the subscription contains usage charges. A processed usage represents a usage that applies to a charge with a rating amount. 

Taken together, chargeable events and processed usages become the inputs for the invoicing process.

To better know about how the invoice amount is calculated out, use the Rating Information Page to get the detailed information.

Rating Information Page

Rating Information Page provides you the information on calculation when it comes to complicated charges like proration. You can click the amount of an invoice item in the Amount column under the Invoice Details section on the invoice details pages. Due to the complexity, you can view more information by turning to another page if the intricate calculating processes exist. You might not have access to the details if the amount displayed is the full amount of the charge.

Note that the Rating Information Page has the following limitations:

  • The calculation details present only on the generated invoices after this feature turns on. You cannot obtain the calculation information on the invoices that have already been generated.
  • The calculation displayed on this page is before tax engine calculation. Note that you can set the Amount is tax inclusive or exclusive.
  • The information is not provided for Canceled invoices.
  • For recurring charge calculation, Rating Information Page does not support billing period set to specific days.
  • Billing Schedule is not supported.
  • For usage charge calculation, Rating Information Page has the following limitations:
    • The overage charge model is not yet supported.
    • In terms of rating group options, only the Usage rating by billing period is supported.
    • Rolling window is not yet supported.
    • No usage details are displayed on the calculation page.