A product is a combination of services that you provide to a customer for a price. For instance, the same product may provide both wireless Internet access and cheap international phone calls from an IP phone.

The rating table (available on the Usage charges panel) is the main component of a product definition. It specifies which services your customers have access to, where on your network they may use these services, and how they should be charged for them. It allows you to specify the following parameters which define a service consumption point:

  • The type of service provided.
  • The node on which the service is used. What exactly does “node” mean in this context? If, for example, a customer calls to gateway A, enters his PIN, and makes an outgoing call that is terminated on gateway B, is he using a service on node A, node B, or both? The correct answer is that the service is regarded as having been provided at the point where authorization was performed. In this example, since PIN authorization. If, for example, the authorization is performed on node A, it is node A that must be listed in the rating table.
  • Identification of the access code (method) on that node. This parameter allows you to use different rate plans for the same service. For example, you may choose a rate plan according to the PSTN access number (local or toll-free) that the customer has dialed. Or you may use different rate plans for outgoing, incoming, and forwarded calls in your voice calls service using the OUTGOING, INCOMING, and FOLLOWME access codes, respectively. (While for services such as prepaid cards the access code is a number, for other services any string may be used, so long as it is one provided by the application handling the call).
  • Originating line information (this is applicable only to the voice call service). You can separate rating entries based on originating line information (e.g., whether the call was made from a home phone or a pay phone). Make sure your telecom provider supplies you with this information in the call setup. For more information please refer to the OLI-Based Billing section of this guide.

Below is an overview of the product bundling and rating possibilities offered by PortaBilling. The MegaStar product allows customers to make and receive calls from phones, connect to a WiFi network and be charged for time spent online, and exchange instant messages. You may assign a different rate plan for each service, as shown.

Product services and rate plans

Applying tariffs based on routing plans

Link copied to clipboard

Normally, the customer is charged the price which is pre-set in his price list. Naturally, this price is calculated based on estimated average termination costs but does not directly depend on which carrier is used for a specific call. Since you may have different termination vendors with various prices and levels of audio quality, how can you give your customers the freedom to choose whether to make phone calls via low-cost carriers (and thus pay low rates) or use high-quality carriers (and so pay premium rates)?

Routing plan selection is available for services based on the Voice Calls service type. It allows you to select a tariff for charging a customer based not only on the “incoming” point to your network but also on the “outgoing” entry, i.e. the type of the route used to terminate a call.

Each type of routing (low-cost, premium, etc.) is defined as a separate routing plan, and multiple routing plans can now be associated with a single rating entry in the product definition. A specific tariff will be assigned to each routing plan, and this tariff will be used when a customer subscribing to a specific plan places a call. For more details, see the Routing Plan Selection chapter.

Product usage charges: adding tariffs per routing plan

You can still use the “single tariff per rating entry” mode. Since this provides faster performance, it is a good idea to use it when the real-time selection of routing plans is not required. In this case, you can still assign a default routing plan to an account, and this will be used when the end user makes a phone call.

“Single tariff” mode is active by default when you create a new rating entry. If you wish to apply a specific tariff based on the routing plan used, you have to manually select the “Assign Tariff per Routing Plan” option in the Tariff list.

Deleting products and tariffs that are no longer used

Link copied to clipboard

You can delete a tariff/product whenever you want if it hasn’t been used yet. However, if you assign a tariff (to a product) or a product (to an account), in order to preserve data integrity, it is impossible to delete such a tariff/product from PortaBilling. In this case, to be able to delete a tariff/product, you need to:

Tariff
  • Mark all the rates in the tariff as discontinued. You can discontinue all the rates at once by re-uploading them to the tariff (refer to Rate upload section for details).
  • Unassign the tariff manually from entities that use it such as product usage charges, customer “override tariff” settings, resellers, or vendors.
  • Wait till the period set for the following options on the Configuration server ends:
    • CDR.Keep_month and CDR.Keep_month_failed – this is the period of time after which the xDRs for service usage will be cleaned up. It means that you should wait for this period of time after the last xDR was created using this tariff.
Product
  • Unassign the product from all accounts that use it.
  • Wait till the period set for the following options on the Configuration server ends:
    • History.Keep_month – the value set here is the period of time to remove the audit log records with the history of changes. It means that you should wait for this period of time after the product was unassigned. You can check the date of the last change on the Audit log panel in the PortaBilling web interface.
    • CDR.Keep_month and CDR.Keep_month_failed – this is the period of time after which the xDRs for service usage will be cleaned up.

When all the conditions are met, you can delete the tariff/product from PortaBilling.

On this page

Release
What's new
Admin manuals
Handbooks
Developers documentation
UI help