2.1. Серверы биллинга

Для добавления биллингов в конфигурации сервера добавляют конструкции вида:

bgbilling:server.<n>.id=<id>
bgbilling:server.<n>.title=<title>
bgbilling:server.<n>.url=<url>
bgbilling:server.<n>.version=<version>
bgbilling:server.<n>.customerIdParam=<paramId>

Где:

<n> - уникальный порядковый номер биллинга в конфигурации;
<id> - строковый идентификатор биллинга, короткая строка, именно на него ссылаются все остальные записи в конфигурации;
<title> - отображаемое наименование;
<url> - URL для подключения к сервлету executer биллинга;
<version> - версия, поддерживаются 5.1 и 5.2;
<param_id> - код текстового параметра договора в биллинге, в котором сохраняется код контрагента.

Например:

bgbilling:server.1.id=bitel
bgbilling:server.1.title=BiTel
bgbilling:server.1.url=http://billing.office.bitel.ru/executer
bgbilling:server.1.version=5.2
bgbilling:server.1.customerIdParam=100

Дополнительно для каждого сервера могут быть указаны необязательные параметры:

bgbilling.<n>.contract_pattern.<pat_num>.title_pattern=<pattern>
bgbilling.<n>.crm.problem.status.list=<status_list>
bgbilling.<n>.copyParamMapping=<mapping>

Где:

<pat_num> - код шаблона договора из биллинга;
<pattern> - шаблон нумерации договоров по этому шаблону при создании их из BGCRM;
<status_list> - перечень статусов проблем в CRM плагине BGBilling, по-умолчанию "0:открыта;1:принята;2:закрыта".
<mapping> - правила копирования параметров контрагента в договор, см. далее.

В параметре <mapping> могут быть определены разделённые точкой с запятой значения вида <cust_id>:<billing_id>.

Где:

<cust_id> - числовой код параметра контрагента либо customerTitle - наименование контрагента; для списковых параметров указывается код параметра и коды значениий в квадратных скобках после кода;
<billing_id> - числовой код параметра договора биллинга; для списковых параметров указывается код параметра и коды значениий в квадратных скобках после кода.

Например:

bgbilling:server.11.copyParamMapping=15:9;72:46;73:5;74:51;75:68;76:69;77:56;78:7;14:8;12:6;109:48;110:50;114:12;115[1,2]:25[4,3];customerTitle:1

Обращение к биллингу осуществляется с использованием логина и пароля пользователя BGCRM. Возможна установка отличного логина и пароля в конфигурации пользователя:

bgbilling:login=<login>
bgbilling:password=<pswd>

Для системы BGBilling обращения плагина выглядят так же как и обращения обычного пользователя биллинга, аналогично действуют ограничения прав.