Release

Search

On the General info panel, you can configure the general settings for the customers of this customer class, such as the billing period closure mode, periodic xDR export, and status change options.

General info panel

Close the billing period

Link copied to clipboard

Select how PortaBilling closes customers' billing periods:

  • N hours after it ends – the billing period ends at midnight and is closed after the global delay set on the Configuration web server interface (by default, 6 hours);
  • With a specified delay – the billing period is closed with an additional delay set in the Delay field. Note that the global delay will also be considered.

Rounding method

Link copied to clipboard

Select the rounding method that will be applied to:

  • invoice amounts, and
  • charged amounts for subscriptions, bundle promotions, measured services, and DID charges in an individual xDR.

You can select one of the following rounding methods:

  • Away from zero – this rounding method is selected by default. It works similar to rounding up but differs when rounding negative values. Positive and negative values round symmetrically. For example, if the rounding precision is set to two decimals, then:
    • 1.214, 1.215 and 1.216 all round up to 1.22.
    • - 1.214, - 1.215 and - 1.216 all round to - 1.22.
  • Half away from zero – this rounding method works similar to arithmetic rounding but differs when rounding negative values. Positive and negative values round symmetrically. For example, if the rounding precision is set to two decimals, then:
    • 1.214 rounds to 1.21, 1.215 and 1.216 all round to 1.22.
    • - 1.214 rounds to - 1.21, - 1.215 and - 1.216 all round to - 1.22.
  • Special rounding (malaysian) – formerly known as custom rounding. This type of rounding depends on the last decimal at precision point. For example, if the rounding precision is set to two decimals, then:
    • If the last decimal at precision point is [0...2], it is set to zero. For example, 1.204, 1.215 and 1.226 all round to 1.20.
    • If the last decimal at precision point is [3...7], it is set to 5. For example, 1.234, 1.255 and 1.276 all round to 1.25.
    • If the last decimal at precision point is [8...9], it is set to 0 and the previous decimal increases by 1. For example, 1.284, 1.296 all round to 1.30.

Periodic xDR export

Link copied to clipboard

Manage xDR export for customers in this customer class.

Export xDRs to a .csv file

Link copied to clipboard

Turn on the toggle to export xDRs to a .csv file for customers in this customer class.

In most countries, there is a legal requirement for service providers to maintain call history for a long time. Since xDRs are periodically cleaned up from the database, saving xDRs to files might be your only way to comply with local regulations. Disable xDR export to files only if you have some other means to store call history.

Send the generated .csv files via email

Link copied to clipboard

Specify whether customers receive the files via email:

  • Do not send – customers don't receive .csv files via email;
  • Summary only – customers only receive xDR summary;
  • All xDRs – customers receive the .csv files with all xDRs.

Status change

Link copied to clipboard

Define which conditions change a customer's status.

Insufficient funds for subscription

Link copied to clipboard

Instruct PortaBilling to change the status of customers and/or their debit accounts when their funds are insufficient to cover subscription charges.

Suspend customers

Link copied to clipboard

If customer balance or available funds are insufficient for subscriptions assigned to them directly, you can:

  • Enable the toggle to automatically suspend customer services. When suspended, customers no longer receive the service and therefore no subscription charges are generated. As soon as a customer's funds are sufficient, PortaBilling resumes their service and generates new charges.

  • Disabled toggle instructs PortaBilling to charge the subscription’s full amount regardless of the current balance status. The customer's balance may exceed the credit limit or the amount of available funds (in this case the negative value of available funds appears).

    If you disable the automatic suspension, customer records already suspended for insufficient funds will not be reactivated automatically. These records will remain suspended until the customer pays the subscription charge (postpaid customers must also pay any overdue invoices in full) or an admin manually changes the customer status to "Active."

Block debit accounts

Link copied to clipboard

Control service availability for debit accounts when their balance is insufficient to cover charges for subscriptions assigned to them directly.

You can choose to charge end users only for the days when they use the service. The Waive the charges for the days when no service was provided option within the subscription configuration controls that. In this case, PortaBilling first applies charges for the whole billing period and then issues a refund for the period during which the service was suspended. Thus, PortaBilling produces two xDRs for the end user: one xDR is for the whole subscription charge and another one is for the refund amount.

  • Turn on the toggle switch to automatically block an account. A blocked account has no access to services until it has sufficient funds to cover subscription charges. Once the administrator makes a payment or the customer tops up an account, PortaBilling automatically unblocks the debit account, resumes the service and assesses subscription charges.

    Note that the administrator must not unblock the account manually. Otherwise, the subscription charges won’t apply even after sufficient funds appear.

  • Turn off the toggle switch to instruct PortaBilling to charge the subscription’s full amount regardless of the current balance status. The account may go into overdraft (in this case the negative value of available funds appears).

    If you disable the Insufficient funds for subscription > Block debit accounts option, the accounts that have already been blocked for insufficient funds will remain blocked. They can only be activated after you re-enable the option and the account has sufficient funds to cover the subscription during the next charge attempt.

     

    Customer class General info

Permanently terminate customers after provisional termination

Link copied to clipboard

When you manually change the customer’s record status to Provisionally terminated, you need to set the date for Permanent termination. By default, it’s 30 days after the Provisional termination. You will be able to set an earlier date, but the customer’s record cannot be terminated permanently later than 30 days.

If you want to change the default value, turn on the toggle and specify the new default number in the Days after provisional termination field. The minimum value is 1.

For example, say you set 45 days here. When you set the Provisionally terminated status for any customer of this customer class, the default date for Permanent termination will be 45 days after Provisional termination. You will be able to set an earlier date for a specific customer, but a later date will be unavailable.

Other

Link copied to clipboard

Subscriber-to-subscriber transfers

Link copied to clipboard

Allow customers in this customer class to transfer available funds to each other. Only users of debit accounts or credit accounts with individual credit limits can transfer funds to each other.

Description

Link copied to clipboard

You can type the short description of the customer class here.

On this page

Release
What's new
Admin manuals
Handbooks
API
UI help
Search