There are a common set of use cases that apply to all products. For each product type and industry domain there will be specific details that need to be considered to provide an end to end service offering. In this document we will provide sample configurations for Toll Free and Trunk Group products.
Use Case No
Use Case Summary
Setup products for service fees & usage
Setup rate plans
The example below is specific to configuring a toll free product, setup steps for the trunk group product will be similar however. Notes are included for trunk group setup after the description provided for the toll free product.
Setup fee (one-time, optional): $10.00
Recurring fee (monthly, non-optional): $17.99
Included inbound minutes (monthly, optional): 100 minutes
Each toll free number will be modeled as a package within the product catalog. Each package will include services for charging of applicable fees.
If the customer orders multiple toll free numbers e.g. ten numbers, then ten account packages will need to be added to their account, one for each toll free number.
If you are unfamiliar with configuring packages an services refer to following article Package with Recurring and One Time Charges Configuration Example.
Sample Services that will be included in package based on above offer are listed in table below
Key Service Parameters
Usage Based Service
Toll free number setup fee
Toll free Number MRC
100 ITFS (intra/inter) minutes
Sample service snapshot
The above services will be included in package, sample snapshot below:
The service charges will be specified under the Package Frequency sub-element of the package. A sample is shown below.
One Time charge (setup fee):
When the package is assigned to account it will appear as below. In this image the 100 minutes optional service has be added:
The toll free number will be captured on the MRC service as follows:
Note: For setup of trunk products, a similar approach can be used e.g.
Setup fee (one-time, optional): $10.00 (modeled as NRC service, non usage based service)
Recurring fee (monthly, non-optional): $17.99 (modeled as MRC service , usage based service)
Number of channels: 30 (this is a provisioning related parameter which is typically an information only parameter from billing perspective, this can be captured as a custom field on package or service or built into service name e.g. “SIP_Trunk_30 MRC”
The identifier for trunk e.g. TrunkGroupId can be captured under the recurring fee service under the “UsageIdentifier” field
Rate plan structure overview is as below.
Each usage class is assigned a rate, each rate is contained within a rate group and rate groups are added to a rate plan that is assignable to an account package.
Mediation rules need to be setup to classify CDRs under the appropriate usage classes e.g. Interstate, Intrastate, International, Local and inbound toll free call types.
Note: The toll free number subscribed by customer is expected to be available in the CDR, either in the called number field or in a separate field in case the called number in CDR is the ring-to (translated) number.
Sample Usage Classes and mediation rules
Usage classes can be configured in the Setup menu and derived based on mediation rules depending on rating/charging requirements. This requires mediation feed configuration to determine the applicable usage class for CDRs.
Sample usage class determination rule
ITFS - Interstate
This usage class will apply if the service location is in the United States and the State for calling number and toll free number is different.
Note: ITFS = Inbound Toll Free Service.
ITFS - Intrastate
This usage class will apply if the service location is in the United States and the State for calling number and toll free number is the same.
ITFS - International
This usage class will apply if the country for calling number and toll free number is different.
ITFS - National
This usage class will apply if the country for calling number and toll free number is the same.
Note: Additional usage classes can be defined for outgoing calls, the table above is provided as a sample for inbound toll free usage classes. Some samples are included below, it’s not an exhaustive list, new usage classes can be introduced flexibly as required based on project specific rating requirements.
Sample usage class determination rule
Interstate - Outbound
This usage class will apply if the calling and called number are within the United States and located in different states.
Intrastate - Outbound
This usage class will apply if the calling and called number are within the United States and located in same state.
Toll Free - Outbound
This usage class will apply when calls are made to a toll free number
International - Outbound
This usage class will apply if the country for calling number and are different.