Взаиморасчеты между операторами, агентская схема телефонии и транзит

{toc:maxLevel=3}

h1. Описание возможностей

В *Carbon Billing 5* возможно тарифицировать несколько видов взаиморасчетов:
* Начисления по агентской схеме входящего и исходящего трафика
* Расчет завершения вызова и расчет инициирования вызова
* Транзитный трафик

h1. Настройка услуг операторов

Оператор связи для обсчета звонка выбирается по транкам.
Если транк у звонка задан, но оператор не найден - звонок считается ошибочным.
Если транк в звонке не задан, это вызовет некритичную ошибку операторских взаиморасчетов.

Чтобы начать обсчет звонков на оператора связи, нужно:
# Создать операторов в папке "Операторы связи"
\\
\\ !telephony_partner_isp_list.png|border=1!\\
\\
# Создать услуги необходимых типов
# [Загрузить в них цены|Использование экспорта и импорта csv и xlsx файлов с тарифами VOIP. Загрузка цен] на направления
# Подключить операторам

{info}Если требуется разделить в акте направления звонков по нескольким услугам (например, междугородний или международный трафик) , это можно сделать по статье "[CarbonBilling:Местная связь, Внутризоновая связь, Междугородняя и международная (дальняя) связь]"{info}

h2. Начисления по агентской схеме, расчет завершения вызова и расчет инициирования вызова

+Исходящие вызовы абонентов+ прошедшие с Вашей номерной ёмкости на транк другого оператора учитываются как +исходящие по агентской схеме+, а так же для расчета +инициирования вызова+
+Входящие вызовы абонентов+ прошедшие на Вашу номерную ёмкость с транка другого оператора учитываются как +входящие по агентской схеме+, а так же для расчета +завершения вызова+
{note}Услугу с типом "*Входящий*" необходимо создать и заполнить в ней встречающиеся в _CDR_ направления даже если вы не тарифицируете завершение вызова{note}

# Создайте услуги IP телефонии по инструкции "[CarbonBilling:Услуги. IP Телефония]", необходимо создать +две услуги+: с типом трафика "Исходящий"и "Входящий" (статья "[CarbonBilling:Тип трафика]")
#* *Исходящий*: необходима для расчетов по агентской схеме и расчета инициирования вызова
#* *Входящий*: необходима для расчета завершения вызова
# [Загрузите в них цены на направления|Использование экспорта и импорта csv и xlsx файлов с тарифами VOIP. Загрузка цен]
# Подключить эти услуги оператору, указав маску транка или несколько масок через запятую.
Имя транка может содержать любой текст, но если в нем задано 2 целых числа через дефис, то при поиске транк будет проверяться на вхождение в этот промежуток.
Транк может содержать и произвольные символы, не только числа.
\\
\\ !telephony_partner_ist_edit_trunk.png|border=1,width=1000!\\
\\
Пример:

{info}Если в качестве транка написать слово *default* , то это будет оператор по умолчанию для всех остальных транков не отнесенных к кому-либо из операторов.
{info}
#* Ваши услуги телефонии
\\
\\ !telephony_partner_ist_services.png|border=1,width=1000!\\
\\
#* Услуги телефонии партнера
\\
\\ !telephony_partner_neighbor_services.png|border=1,width=1000!

h2. Транзитный трафик

Транзитным считается трафик прошедший через Вашу сеть, но не относящийся к Вашей номерной ёмкости.
Прохождение через Вашу сеть определяется по транкам, которые должны быть настроены в услугах телефонии у операторов-партнёров (от кого и кому идет транзитный звонок).

{info}
Важно: биллинг работает только с диапазонами чисел. Если маска указана в формате символ+число, транк будет отображаться некорректно.
{info}

h2. Отладка интеграции

h3. Как понять, что звонок был посчитан по агентской схеме или как транзитный?

h4. Исходящие вызовы и инициирование вызова
# В таблице VOIP_LOG должны быть заполнены поля тарификации оператора:
#* OPERATOR_ID: ID оператора-партнёра, в расходе которого будет посчитан вызов
#* OPERATOR_USLUGA_ID: ID услуги, по которой считается расход оператора за исходящие вызовы по агентской схеме и инициирование вызова
#* OPERATOR_STEP_PRICE: стоимость шага тарификации услуги оператора-партнёра
#* V_TYPE_ID: 2
# В логе проводок ARCH_ACCOUNT_STACK должны быть записи с LOG_ID=VOIP_LOG.ID:
#* Одна по стоимости вызова
#* Одна за инициирование вызова
# Проводка будет одна, если Вы считаете только завершение вызова или только стоимость по времени

h4. Входящие звонки и завершение вызова
# В таблице VOIP_LOG должны быть заполнены поля тарификации оператора:
#* OPERATOR_ID: ID оператора-партнёра, в расходе которого будет посчитан вызов
#* OPERATOR_USLUGA_ID: ID услуги, по которой считается расход оператора за входящие вызовы по агентской схеме и завершение вызова
#* OPERATOR_STEP_PRICE: стоимость шага тарификации услуги оператора-партнёра
#* V_TYPE_ID: 1
# В логе проводок ARCH_ACCOUNT_STACK должны быть записи с LOG_ID=VOIP_LOG.ID:
#* Одна по стоимости вызова
#* Одна за завершение вызова
# Проводка будет одна, если Вы считаете только завершение вызова или только стоимость по времени

h4. Транзит
# В таблице VOIP_LOG должны быть заполнены поля тарификации оператора:
#* V_TYPE_ID: 3
#* OPERATOR_ID: ID оператора, в сеть которого ушел вызов
#* OPERATOR_USLUGA_ID: ID услуги, по которой считается расход этого оператора за транзит

#* Одна по услуге оператора в чью сеть ушел вызов
# Проводка будет одна, у кого-то из операторов не настроена услуга транзита или не указана стоимость направление, либо оно бесплатно (стоимость 0)