User manuals

Rerating billed items


By default, Opencell only allows to rerate unbilled items, as billed events are already on an invoice.
A setting allows to also rerate billed items.

Enabling rating of billed items


The feature can be enabled in application settings / features management:

image-20250228-104934.png

Rerating billed items


Billed items have already been invoiced, so simply rerating them will only generate new items to be invoiced causing the events to be invoiced twice.

To solve this, we combined rerating with adjustment items: for each billed item that will be rerated, we also generate an adjustment items (same amount, opposite sign) to compensate for what has already been invoiced.

That way, for a simple case (no triggered EDRs, no multi charge evaluation, no discount), we’ll end up with he original item marked as rerated, and 2 new items: an adjustment item, and the event item rerated with the updated price.

Notes

Similarly to rerating of unbilled items:

  • If wallet operation is defined as a huge entity (see https://opencellsoft.atlassian.net/wiki/x/AYCHm) then the action of marking items to rerate will be performed through processing batches (processed by job), else update is performed synchronously.

  • Rerating itself is always performed asynchronously, by jobs processing marked wallet operations.

Rerating billed items in Portal


In Portal, the process is the same as for unbilled items (see Rerating).

The only difference is in the filters requirement is now just on the “Main only” filter:

Main only filter excludes wallet operations from discounts and triggered EDRs.

image-20250228-105917.png

Rerating billed items while creating an invoice adjustment / credit note


When creating an invoice adjustment, you have the possibility to request a rerating of the invoiced rated items.

In this case, rerating will not generate adjustment items, because items have already been “reimbursed” to customer by the credit note.

Create adjustment API and popups will get a new option to rerate billed items, as long as the setting enabling rerating of billed items is activated.

image-20250401-122929.png

Note

Here again, marking items to rerate will be performed asynchronously, if wallet operation is declared as a huge entity (see https://opencellsoft.atlassian.net/wiki/x/AYCHm)