Dialogic ControlSwitch PRI Advice of Charge User guide

Brand: Dialogic

Model: ControlSwitch PRI Advice of Charge

Type: User guide

Dialogic® ControlSwitch™

System

PRI Advice of Charge

End of Call Feature Guide

Release 5.10.3

Dialogic® ControlSwitch™ PRI Advice of Charge - End of Call Feature Guide

 Dialogic Inc. Proprietary Page 2

in writing from Dialogic Corporation at the address provided below.

All contents of this document are furnished for informational use only and are subject to change without notice and do not represent a

commitment on the part of Dialogic Corporation and its affiliates or subsidiaries (“Dialogic”). Reasonable effort is made to ensure the accuracy

of the information contained in the document. However, Dialogic does not warrant the accuracy of this information and cannot accept

responsibility for errors, inaccuracies or omissions that may be contained in this document.

INFORMATION IN THIS DOCUMENT IS PROVIDED IN CONNECTION WITH DIALOGIC® PRODUCTS. NO LICENSE, EXPRESS OR IMPLIED, BY

ESTOPPEL OR OTHERWISE, TO ANY INTELLECTUAL PROPERTY RIGHTS IS GRANTED BY THIS DOCUMENT. EXCEPT AS PROVIDED IN A SIGNED

AGREEMENT BETWEEN YOU AND DIALOGIC, DIALOGIC ASSUMES NO LIABILITY WHATSOEVER, AND DIALOGIC DISCLAIMS ANY EXPRESS OR

IMPLIED WARRANTY, RELATING TO SALE AND/OR USE OF DIALOGIC PRODUCTS INCLUDING LIABILITY OR WARRANTIES RELATING TO FITNESS

FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR INFRINGEMENT OF ANY INTELLECTUAL PROPERTY RIGHT OF A THIRD PARTY.

Dialogic products are not intended for use in certain safety-affecting situations. Please see

http://www.dialogic.com/company/terms-of-use.aspx for more details.

Due to differing national regulations and approval requirements, certain Dialogic products may be suitable for use only in specific countries,

and thus may not function properly in other countries. You are responsible for ensuring that your use of such products occurs only in the

countries where such use is suitable. For information on specific products, contact Dialogic Corporation at the address indicated below or on

the web at www.dialogic.com.

It is possible that the use or implementation of any one of the concepts, applications, or ideas described in this document, in marketing

collateral produced by or on web pages maintained by Dialogic may infringe one or more patents or other intellectual property rights owned by

third parties. Dialogic does not provide any intellectual property licenses with the sale of Dialogic products other than a license to use such

product in accordance with intellectual property owned or validly licensed by Dialogic and no such licenses are provided except pursuant to a

signed agreement with Dialogic. More detailed information about such intellectual property is available from Dialogic’s legal department at

6700 Cote-de-Liesse Road, Suite 100, Borough of Saint-Laurent, Montreal, Quebec, Canada H4T 2B5. Dialogic encourages all users of its

products to procure all necessary intellectual property licenses required to implement any concepts or applications and does not condone or

encourage any intellectual property infringement and disclaims any responsibility related thereto. These intellectual property licenses may

differ from country to country and it is the responsibility of those who develop the concepts or applications to be aware of and comply with

different national license requirements.

Dialogic, Dialogic Pro, Dialogic Blue, Veraz, Brooktrout, Diva, BorderNet, PowerMedia, PowerVille, PowerNova, MSaaS, ControlSwitch, I-Gate,

Mobile Experience Matters, Network Fuel, Video is the New Voice, Making Innovation Thrive, Diastar, Cantata, TruFax, SwitchKit, Eiconcard,

NMS Communications, SIPcontrol, Exnet, EXS, Vision, inCloud9, NaturalAccess and Shiva, among others as well as related logos, are either

registered trademarks or trademarks of Dialogic Corporation and its affiliates or subsidiaries. Dialogic's trademarks may be used publicly only

with permission from Dialogic. Such permission may only be granted by Dialogic’s legal department at 6700 Cote-de-Liesse Road, Suite 100,

Borough of Saint-Laurent, Montreal, Quebec, Canada H4T 2B5. Any authorized use of Dialogic's trademarks will be subject to full respect of the

trademark guidelines published by Dialogic from time to time and any use of Dialogic’s trademarks requires proper acknowledgement.

The names of actual companies and products mentioned herein are the trademarks of their respective owners.

This document discusses one or more open source products, systems and/or releases. Dialogic is not responsible for your decision to use open

source in connection with Dialogic products (including without limitation those referred to herein), nor is Dialogic responsible for any present

or future effects such usage might have, including without limitation effects on your products, your business, or your intellectual property

rights.

Dialogic® ControlSwitch™ PRI Advice of Charge - End of Call Feature Guide

 Dialogic Inc. Proprietary Page 3

Document History

Version #

Version Date

Update Description

October 2010

First Issue

March 2016

General Update

Dialogic® ControlSwitch™ PRI Advice of Charge - End of Call Feature Guide

 Dialogic Inc. Proprietary Page 4

Table of Contents

1. INTRODUCTION ............................................................................................................................................ 5

1.1 Purpose of this Document............................................................................................................................ 5

1.2 Glossary ........................................................................................................................................................ 5

1.3 Contact Us .................................................................................................................................................... 5

ADVICE OF CHARGE ...................................................................................................................................... 6 2.

2.1 AOC-E ........................................................................................................................................................... 6

2.2 Definition...................................................................................................................................................... 6

CHARGE CONFIGURATION OVERVIEW .......................................................................................................... 9 3.

3.1 Configuring the Charge Band ....................................................................................................................... 9

3.2 Tariff Plan ..................................................................................................................................................... 9

AOC-E FEATURE CONFIGURATION ............................................................................................................... 10 4.

4.1 Configuration ............................................................................................................................................. 10

4.2 Call Trace .................................................................................................................................................... 14

4.3 CDR ............................................................................................................................................................. 15

Dialogic® ControlSwitch™ PRI Advice of Charge - End of Call Feature Guide

 Dialogic Inc. Proprietary Page 5

1. Introduction

1.1 Purpose of this Document

This document is intended to familiarize the reader with the Dialogic® ControlSwitch™ system’s

PRI Advice of Charge – End of Call feature.

1.2 Glossary

For the purposes of this document the following abbreviations apply:

Abbreviation

Meaning

AOC

Advice of Charge

AOC-E

Charging Information at the End of Call

CDR

Call Detailed Record

Table 1: Glossary

1.3 Contact Us

For a list of Dialogic locations and offices, please visit: https://www.dialogic.com/contact.aspx.

Dialogic® ControlSwitch™ PRI Advice of Charge - End of Call Feature Guide

 Dialogic Inc. Proprietary Page 6

Advice of Charge 2.

Advice of Charge (AOC) is a group of supplementary services for ETSI ISDN (PRI) that allows the served

user to be informed of usage-based charging information.

The usage information can be shared with served users at various stages in the call by using different

Q.931 messages. Based on the call state and what information is available to the user, there are three

different AOC Supplementary services:

 Charging Information at Call Setup Time (AOC-S): The user receives the charge rates when the

call is set up and receives additional information during the call if the charging rate changes.

 Charging Information During the Call (AOC-D): The user receives recorded charge rates during

the active phase of the call.

 Charging Information at the End of Call (AOC-E): The user receives recorded charge rates when

the call is terminated.

The relevant Specifications for the AOC Supplementary Service are:

1. ETS 300 178 - AOC-S Supplementary Service

2. ETS 300 179 - AOC-D Supplementary Service

3. ETS 300 180 - AOC-E Supplementary Service

4. ETS 300 181 - AOC Functional Capabilities and Information Flows

5. ETSI EN 300 182 – Protocol Specification for AOC (including ASN definitions)

2.1 AOC-E

The AOC-E supplementary service provides the served user with charging information for a call when

the call is terminated; the charging information is sent to the caller in charging units.

The network providing this AOC-E supplementary service sends the charging information to the served

user in the call clearing phase. The Facility Information Element is included in either the PRI

DISCONNECT or the RELEASE message, depending on whether the user or the network side initiates call

clearing:

 If the served user initiates call clearing by sending a PRI DISCONNECT message to the network,

the network includes the charging information in the PRI RELEASE message sent to the served

user.

 If the network (or the remote user) initiates call clearing, the network includes the charging

information in the PRI DISCONNECT message sent to the served user.

The charging information is included in an invoke component of the Facility Information Element.

AOC-E supplementary service can be provided on a user-defined policy basis.

When the AOC-E Supplementary service is activated, the network sends AOCEChargingUnitInfo in an

AOCEChargingUnit invoke component.

2.2 Definition

ASN Definition for AOC-E PDU: (from ETSI EN 300 182)

AOCEChargingUnit ::= CHOICE

{

chargeNotAvailable NULL,

AOCEChargingUnitInfo

Dialogic® ControlSwitch™ PRI Advice of Charge - End of Call Feature Guide

 Dialogic Inc. Proprietary Page 7

}

AOCEChargingUnitInfo ::= SEQUENCE

{

CHOICE

{

specificChargingUnits SEQUENCE

{

recordedUnitsList [1] RecordedUnitsList,

aOCEBillingId [2] AOCEBillingId OPTIONAL

freeOfCharge [1] NULL

chargingAssociation ChargingAssociation OPTIONAL

}

RecordedUnitsList ::= SEQUENCE SIZE (1..32) OF RecordedUnits

RecordedUnits ::= SEQUENCE

{

CHOICE

{

recordedNumberOfUnits NumberOfUnits,

notAvailable NULL

recordedTypeOfUnits TypeOfUnit OPTIONAL

}

NumberOfUnits ::= INTEGER (0..16777215)

TypeOfUnit ::= INTEGER (1..16) -- Value 1-16

AOCEBillingId ::= ENUMERATED

{

normalCharging (0),

reverseCharging (1),

creditCardCharging (2),

callForwardingUnconditional (3),

callForwardingBusy (4),

callForwardingNoReply (5),

callDeflection (6),

callTransfer (7)

}

ChargingAssociation::= CHOICE

{

chargeNumber [0] EXPLICIT PartyNumber,

chargeIdentifier ChargeIdentifier

}

ChargeIdentifier ::= INTEGER (-32768..32767)

FACILITY IE Sample:

1C ---------- FAC : Facility IE----------------------

17 Length of Facility In RELEASE. Here it is 23

Dialogic® ControlSwitch™ PRI Advice of Charge - End of Call Feature Guide

 Dialogic Inc. Proprietary Page 8

91 100-----

---10001 Protocol Profile = Remote operations (Q.932, page 42)

A1 101----- class: context-specific ; form: constructor

---00001 Component tag: invoke

14 Length of Invoke PDU:

02 Invoke identifier tag = 2

01 Length of Id Tag = 1

02 InvokeID Value = 02

02 operation ID tag = 2

01 length of operation tag=1

24 operation id for AOCE Charging Units = 36

30 AOCE charging units tag

0C Length of AOCE Charging Unit PDU =12

30 Specific charging units tag

0A Length of below PDU = 10

A1 Recorded units list tag

05 Len=5

30 recorded units tag

03 Len=3

02 recorded number of units tag

01 Len= 1

08 recorded number of units: 08

82 AOC-E Billing ID Tag

01 Length = 1

00 Value = 0 (NormalCharging)

Dialogic® ControlSwitch™ PRI Advice of Charge - End of Call Feature Guide

 Dialogic Inc. Proprietary Page 9

Charge Configuration Overview 3.

To compute how many charge units are to be charged per call, the ControlSwitch uses a charge

framework that defines what call rates are used at different times and for different operator-selected

criteria.

The charge framework provides the options below to create the desired charge rates:

 Time Band: The time band allows the operator to create separate time ranges, and different

rates can be associated with each time range. Time bands can be created with minimum

granularity of 1 minute; ranges can be selected in hours, minutes, day of the month, day of the

year, or month of the year. Time bands are created in GMT.

 Charge Plan: The charge plan defines how the charging is to be done. Multiple charge plans

can be created for different rates. The charge plan provides an option to configure Set-up

Charge and Periodic Charges.

 Charge Band: The charge band defines the associations between charge plans and time

bands. The charge band defines which charge plan is to be used at a specific time, and it is

possible to extract the required charge rates from an associated charge plan at any point in

time. Each pair of time band/charge plan associations linked to a charge band is assigned a

priority. In case of overlapping timebands, the priority determines which charge plan is used.

3.1 Configuring the Charge Band

First, determine which charge band should be used. Once the charge band is selected, the

ControlSwitch determines which time band a call belongs to, based on the time of the call. The

ControlSwitch then selects the associated charge plan, which provides the call rate details. Once an

active call enters a different time band, a new charge plan associated to that timeband is used for

charging the call.

While configuring the charge band, the operator needs to ensure that for all time periods, there are

associated charge plans linked for all time periods. After proper configuration of a charge band, the

operator needs to associate the required charge plan. This can be done by using Tariff Plans.

3.2 Tariff Plan

A tariff plan defines policies with required criteria to select a particular charge band as a treatment. All

selection criteria available for normal routing are also available for charge band selection. The charge

bands can be directly associated at the treatment level or by using the charge band configured to the

ingress trunk group.

The tariff plan execution is controlled through the Originating Attempt Service Trigger.

This trigger provides the option to select different tariff plans based on required selection criteria.

Dialogic® ControlSwitch™ PRI Advice of Charge - End of Call Feature Guide

 Dialogic Inc. Proprietary Page 10

AOC-E Feature Configuration 4.

4.1 Configuration

The following procedure is used to configure AOC-E from the EMS GUI.

1. Create Time Bands: Select Policies->Routing Configuration->Time Bands to create time zones

where the charging rates may be different. Multiple time bands can be created to suit specific

time ranges.

Example 1:

Time band to model time range from 18:40:00 to 18:44:59 every day (no specific day is selected in

timeband).

2. Create Charge Plan: Select Policies->Routing Configuration->Charge Configuration->Charge

Plan to create the required number of type “PRI-AOC-E” charge plans. Multiple Charge Plans

can be created to have various charging combinations.

The PRI-AOC-E charge plan allows configuration of two different charge rates.

 Setup Charge: The Set-up Charge (also called Connection Charge) is the number of charge

units charged at the time the call is answered. The ‘Pulse Units’ field determines the number

of charged units to be charge immediately after the call is answered. The ‘Charge Unit Time

Interval’ field determines how long after answer before regular periodic charging begins. If

the operator wants to configure any specific connection charge regardless of how long the call

lasts, set the setup charge duration to 0.

Periodic Charge: Once the Setup Charge duration ends, this configuration determines how

many charge units need to be charged for each time interval until the call ends or crosses to

different time band. The ‘Pulse Units’ filed determines how many units are charged at the

beginning of each period. If periodic Charge is zero, no additional units are computed after

setup charge regardless of the call duration in the current time band.

Dialogic® ControlSwitch™ PRI Advice of Charge - End of Call Feature Guide

 Dialogic Inc. Proprietary Page 11

Example 2:

The below set-up charge is 50 pulse units for the first 60 seconds and the Periodic charge units are 30

pulse units per 120 seconds. This means that from the time the call is established, for the first 60 secs of

the call duration 50 units are charged immediately on answer. Then, another 30 pulse units are charged

at the start of each 120-second period.

3. Create Charge Bands: Select Policies->Routing Configuration->Charge Configuration->Charge

Band to create charge bands that are used to group a series of time bands and associated

charge plans that will be used for specific calls. One charge band can contain any number of

charge plan – time band groups.

Example 3:

In the example below, various time band/charge plan associations are linked to a charge band. If a call is

using this charge band and the call is established at time matching for timeband aoc_time_00_05, then

the charge plan rate values defined in aoc_plan_5_5 are used. Once the call crosses the time band

mentioned in aoc_time_00_05 and enters aoc_time_05_10 time band, the new rates defined as per

aoc_plan_6_10 are used. This pattern continues as long as the call remains connected.

For any charge band, the operator needs to ensure that for all time ranges a charge plan is associated. If

there is any time period for which there is no matching timeband association in charge band, then the

call is not charged during that time period.

4. Create Tariff Plan: Select Policies->Plan and Policies->Tariff to create a tariff plan. The Tariff

Plan must be associated to a specific charge band to the call based on an operator-specified

policy. A tariff plan can select a charge band directly as a tariff treatment or the option to use

the charge band configured in the ingress trunk group.

Dialogic® ControlSwitch™ PRI Advice of Charge - End of Call Feature Guide

 Dialogic Inc. Proprietary Page 12

Example 4:

The following treatment allows charge band association (i.e., selects charge band name –

“rao_aoc_charge_band” for the matching criteria).

Example 5:

Treatment mentioning to select the charge band from ingress trunk group:

In the example below, once the treatment node is hit, it is configured to use the charge band that is

associated to the ingress trunk group.

5. Configure Service Trigger: A service trigger needs to be created to select the specific tariff plan

to execute at the call origination attempt.

Dialogic® ControlSwitch™ PRI Advice of Charge - End of Call Feature Guide

 Dialogic Inc. Proprietary Page 13

The tariff service trigger can be invoked along with other service triggers, such as LNP. For example, to

invoke LNP service before invoking tariff service, use the sample configuration below.

 Create a service trigger plan with plan type as “Specific _Digit_String”.

 Use multiple treatments for the same rule node in the policy, first mentioning LNP and

then tariff.

Dialogic® ControlSwitch™ PRI Advice of Charge - End of Call Feature Guide

 Dialogic Inc. Proprietary Page 14

6. Changes in Trunk Group: In the ETSI-PRI ingress trunk group, select the required service

trigger. If required, associate the charge band under the ingress tab.

Note:

If the tariff plan treatment node does not mention to pick up from ingress trunk group, even if there is an

associated charge band for that ingress trunk group, it will not be used for the call.

After completing the AOC-E setup, verify the information related to this feature at the following points.

4.2 Call Trace

Once the call gets into a connected state, the charge rate used for the call is traced as an event.

Whenever the call enters into new time band and changes the charge rate, the new rate also traced

with an event. The Trace Event name is “AOC-TariffRate”.

Dialogic® ControlSwitch™ PRI Advice of Charge - End of Call Feature Guide

 Dialogic Inc. Proprietary Page 15

Once the call is cleared, the total computed charge units are also traced as separate trace events. The

trace event name is “AOC-TotalChargeUnits”.

4.3 CDR

For any call, if the AOC charge units are computed and shared to the network, the value is displayed

under the charge tab of the CDR record as follows:

Dialogic® ControlSwitch™ PRI Advice of Charge - End of Call Feature Guide

 Dialogic Inc. Proprietary Page 16

END OF DOCUMENT

Dialogic ControlSwitch PRI Advice of Charge User guide

Dialogic ControlSwitch PRI Advice of Charge User guide

Dialogic ControlSwitch PRI Advice of Charge User guide

Related papers

Other documents