Клиенты (account)

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты в левом меню платформы.

Клиенты

Уровень доступа: admin

Параметр	Тип	Обязательный	Значение
`id`	Положительное целое число	нет	Уникальный идентификатор клиента.
`name`	Строка	нет	Наименование клиента.
`project`	Положительное целое число	нет	Провайдер, доступный клиенту.
`balance`	Строка	нет	Баланс лицевого счёта клиента.
`status`	Строка (список)	нет	Свойства клиента.

Регистрация клиента

Функция: register

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → кнопка Создать.

Подробнее см. в статье Интеграция с сайтом.

Чтобы зарегистрировать клиента в BILLmanager, выполняется перенаправление пользователя с сайта на форму регистрации:

Регистрация в BILLmanager

https://IP-address:port/billmgr?func=register

Подробнее

Для регистрации клиента на сайте без перехода в BILLmanager используется функция register, удалённый вызов которой зарегистрирует клиента в биллинговой платформе. Функция имеет следующие параметры:

Параметр	Тип	Обязательный	Значение
`sok`	Строка	да	Значение `ok` подтверждает выполнение операции. Без этого параметра изменения не будут применены.
`email`	Строка	да	Логин и Email нового клиента.
`passwd`	Строка	да	Пароль нового клиента.
`realname`	Строка	нет	ФИО клиента.
`phone`	Строка	нет	Номер телефона.
`conditions_agree`	Флаг	нет	Установите значение `on`, если для регистрации необходимо принятие условий использования.
`offer_xxx`	Флаг	нет	Установите значение `on`, если используется принятие договора-оферты при регистрации, где `xxx` — id оферты.
`country`	Строка	нет	Код страны в соответствии со справочником BILLmanager.
`state`	Строка	нет	Код региона или области в соответствии со справочником BILLmanager.
`project`	Положительное целое число	нет	id провайдера.
`recovery`	Флаг	нет	Установите значение `on`, если необходимо в письме о регистрации отправить клиенту ссылку на сброс пароля.
`_ga`	Строка	нет	Код привязки к Google Analytics.
`partner`	Строка	нет	При использовании реферальной программы сайт должен запоминать 'PARTNER_ID' (код партнера), если клиент пришёл по реферальной ссылке. Обычно этот параметр сохраняют в cookies.
`sesid`	Строка	нет	Если используется реферальная программа. Идентификатор клика.
`tzoffset`	Строка	нет	Смещение часового пояса клиента относительно GMT, в BILLmanager выставляется через JavaScript.

Написать запрос клиенту

Функция: ticket.write.account

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Запрос.

Уровень доступа: admin

Платежи (account.payment)

Функция: account.payment

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Платежи.

Уровень доступа: admin

Параметр	Тип	Обязательный	Значение
`id`	Положительное целое число	нет	Уникальный идентификатор платежа.
`number`	Строка	нет	Номер платежа.
`create_date`	Дата и время	нет	Дата создания платежа.
`pay_date`	Дата и время	нет	Дата оплаты.
`sender_name`	Строка	нет	Плательщик.
`recipient_name`	Строка	нет	Получатель.
`project`	Положительное целое число	нет	Провайдер.
`account_name`	Строка	нет	Клиент.
`paymethod_name`	Строка	нет	Метод оплаты.
`subaccountamount_iso`	Строка	нет	Сумма.
`paymethodamount_iso`	Строка	нет	Сумма в валюте платежа.
`status`	Строка (список)	нет	Флаги статуса платежа.

Свойства платежа

Функция: payment.edit

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Платежи → выберите платёж → кнопка Изменить.

Уровень доступа: admin

Используется для просмотра параметров объекта, изменения объекта и создания нового объекта. Просмотр параметров объекта:

Параметры:
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- elid — уникальный идентификатор (элемент id из функции account.payment).
Результат: список параметров объекта.

Создание объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Изменение объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- elid — уникальный идентификатор (элемент id из функции account.payment);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Список параметров объекта или дополнительных параметров запроса:

Параметр	Тип	Обязательный	Значение
`number`	Строка	нет	Номер счёта для оплаты.
`createdate`	Дата и время	нет	Дата и время создания счёта на оплату.
`paydate`	Дата и время	нет	Дата оплаты счёта или зачисления платежа.
`documentnumber`	Строка	нет	№ платёжного документа.
`documentdate`	Дата и время	нет	Дата платёжного документа.
`description`	Строка	нет	Назначение платежа.
`sender`	Положительное целое число	нет	Плательщик клиента, от имени которого совершена оплата.
`subaccountamount`	Строка	нет	Сумма платежа, зачисляемая на счёт клиента.
`usedamount`	Строка	нет	Сумма израсходованных средств.
`paymethodamount`	Строка	нет	Сумма в валюте платёжной системы.
`commissionamount`	Строка	нет	Комиссия, добавляемая к сумме платежа при оплате.
`taxamount_readonly`	Строка	нет	Сумма налога.
`status`	Строка (перечисление)	нет	Статус платежа.
`paymethod`	Положительное целое число	нет	Метод оплаты.
`restrictrefund`	Флаг	нет	Запретить возврат средств с данного платежа. Чтобы включить данную опцию, используйте значение `on`.
`info`	Строка	нет	Информация о платеже. Дополнительная информация о платеже, полученная от платёжной системы.
`note`	Строка	нет	Комментарий сотрудника.

Зачислить платёж на лицевой счёт клиента

Функция: payment.setpaid

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Платежи → выберите платёж → кнопка Зачислить.

Уровень доступа: admin

Параметры:

elid — один или несколько уникальных идентификаторов объекта, разделённых запятой. Уникальный идентификатор — элемент id из функции account.payment.

Пример API вызова для зачисления платежа на лицевой счёт клиента:

Пример API вызова

https://IP-address:port/billmgr?authinfo=username:password&elid=3&func=payment.setpaid&out=xml

Подробнее

Отправить счёт на e-mail

Функция: payment.send

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Платежи → выберите платёж → Отправить счёт.

Уровень доступа: admin

Параметры:

elid — один или несколько уникальных идентификаторов объекта, разделённых запятой. Уникальный идентификатор — элемент id из функции account.payment.

Установка фильтра

Функция: account.payment.filter

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Платежи → меню Фильтр.

Отмена платежа

Функция: payment.refund

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Платежи → выберите платёж → кнопка Отменить.

Уровень доступа: admin

Параметры:
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- elid — уникальный идентификатор (элемент id из функции account.payment).
Результат: список параметров объекта.

Создание объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Изменение объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- elid — уникальный идентификатор (элемент id из функции account.payment);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Список параметров объекта или дополнительных параметров запроса:

Параметр	Тип	Обязательный	Значение
`amount`	Строка	да	Сумма возврата. Сумма в валюте метода оплаты, которая будет возвращена клиенту.
`description`	Строка	нет	Причина возврата для передачи в платёжную систему.

История изменения платежа с номером

Функция: payment.history

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Платежи → кнопка История.

Уровень доступа: admin

Параметр	Тип	Обязательный	Значение
`changedate`	Дата и время	нет	Дата изменения.
`desc`	Строка	нет	Изменение.
`user`	Строка	нет	Пользователь.
`ip`	Строка	нет	IP-адрес.
`action`	Строка	нет	Функция.

Вывод информации о платеже в виде, удобном для печати

Функция: payment.print

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Платежи → кнопка Печать.

Уровень доступа: admin

Скачать документ в формате PDF

Функция: payment.print.pdf

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Платежи → кнопка Скачать.

Уровень доступа: admin

Распределение суммы расхода по платежам

Функция: payment.expense

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Клиенты →выберите клиента → кнопка Платежи → кнопка Расходы.

Уровень доступа: admin

Параметр	Тип	Обязательный	Значение
`expense`	Положительное целое число	нет	Код расхода.
`expense_locale_name`	Строка	нет	Расход.
`amount_iso`	Строка	нет	Сумма.
`invoice`	Положительное целое число	нет	Код акта.
`invoice_number`	Строка	нет	Акт.

Редактирование распределения

Функция: payment.expense.edit

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Платежи → кнопка Расходы → кнопка Изменить.

Уровень доступа: admin

Параметры:
- plid — уникальный идентификатор родительского списка (элемент id из функции account.payment);
- elid — уникальный идентификатор (элемент expense из функции payment.expense).
Результат: список параметров объекта.

Создание объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account.payment);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Изменение объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account.payment);
- elid — уникальный идентификатор (элемент expense из функции payment.expense);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Список параметров объекта или дополнительных параметров запроса:

Параметр	Тип	Обязательный	Значение
`expense`	Положительное целое число	нет	Код расхода.
`amount`	Строка	нет	Сумма, которая будет списана с платежа.

Удалить

Функция: payment.expense.delete

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Платежи → выберите платёж → кнопка Расходы → кнопка Удалить.

Уровень доступа: admin

Параметры:

elid — один или несколько уникальных идентификаторов объекта, разделённых запятой. Уникальный идентификатор — элемент expense из функции payment.expense.

Удалить выбранные платежи. Доступно только для неоплаченных платежей

Функция: payment.delete

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → выберите клиента → кнопка Платежи → выберите платёж → кнопка Удалить.

Уровень доступа: admin

Параметры:

elid — один или несколько уникальных идентификаторов объекта, разделённых запятой. Уникальный идентификатор — элемент id из функции account.payment.

Создать

Функция: payment.add

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Платежи → кнопка Создать.

Уровень доступа: admin, user

Содержание счёта

Функция: payment.orderinfo

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Платежи → выберите платёж → кнопка Подробно.

Уровень доступа: admin

Параметр	Тип	Обязательный	Значение
`id`	Положительное целое число	нет	Уникальный идентификатор позиции счёта.
`info`	Строка	нет	Предмет счёта.
`cost`	Строка	нет	Стоимость.

Изменение содержания счёта

Функция: payment.orderinfo.edit

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → кнопка Платежи → вкладка Содержание счета → кнопка Изменить.

Уровень доступа: admin

Параметры:
- plid — уникальный идентификатор родительского списка (элемент id из функции account.payment);
- elid — уникальный идентификатор (элемент id из функции payment.orderinfo).
Результат: список параметров объекта.

Создание объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account.payment);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Изменение объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account.payment);
- elid — уникальный идентификатор (элемент id из функции payment.orderinfo);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Список параметров объекта или дополнительных параметров запроса:

Параметр	Тип	Обязательный	Значение
`name`	Строка	нет	Описание позиции счёта.

Написать запрос клиенту

Функция: ticket.write.payment

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Платежи → кнопка Запрос.

Уровень доступа: admin

Группы клиента

Функция: account.group

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Группы.

Уровень доступа: admin

Параметр	Тип	Обязательный	Значение
`id`	Положительное целое число	нет	Уникальный идентификатор группы.
`name`	Строка	нет	Наименование.
`status`	Строка (список)	нет	Статус.

Включить

Функция: account.group.resume

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Группы → выберите группу → кнопка Вкл.

Уровень доступа: admin

Параметры:

elid — один или несколько уникальных идентификаторов объекта, разделённых запятой. Уникальный идентификатор — элемент id из функции account.group.

Выключить

Функция: account.group.suspend

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Группы → выберите группу → кнопка Выкл.

Уровень доступа: admin

Параметры:

elid — один или несколько уникальных идентификаторов объекта, разделённых запятой. Уникальный идентификатор — элемент id из функции account.group.

Редактирование группы

Функция: account.group.edit

Результат: успешное выполнение операции или сообщение об ошибке

Уровень доступа: admin

Удалить группу

Функция: account.group.delete

Результат: успешное выполнение операции или сообщение об ошибке

Уровень доступа: admin

Лицевые счета

Функция: subaccount

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Счета.

Уровень доступа: admin

Параметр	Тип	Обязательный	Значение
`id`	Положительное целое число	нет	Уникальный идентификатор счёта.
`project`	Положительное целое число	нет	Провайдер.
`balance`	Строка	нет	Баланс лицевого счета клиента.
`creditlimit`	Строка	нет	Кредитный лимит.
`status`	Строка (список)	нет	Состояние.

Редактирование лицевого счета

Функция: subaccount.edit

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → кнопка Счета → кнопка Изменить.

Уровень доступа: admin

Параметры:
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- elid — уникальный идентификатор (элемент id из функции subaccount).
Результат: список параметров объекта.

Создание объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Изменение объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- elid — уникальный идентификатор (элемент id из функции subaccount);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Список параметров объекта или дополнительных параметров запроса:

Параметр	Тип	Обязательный	Значение
`subaccount_project`	Положительное целое число	нет	Провайдер создаваемого счёта.
`subaccount_currency`	Строка	нет	Валюта создаваемого счёта.
`allowpostpaid`	Флаг	нет	Опция включает возможность клиенту оплачивать с данного счёта услуги в долг. Чтобы включить данную опцию, используйте значение `on`.
`creditlimit`	Строка	нет	Кредитный лимит. Позволяет клиенту уходить в долг в пределах указанной суммы.
`referer`	Положительное целое число	нет	Привлечён клиентом по реферальной программе. Укажите код клиента, который привел клиента по реферальной программе.
`active`	Флаг	нет	Счёт клиента активен. У клиента может быть только один активный счёт у провайдера. Чтобы включить данную опцию, используйте значение `on`.
`incident_limit`	Положительное целое число	нет	Максимальное использование обращений в поддержку клиентом за всё время.

Выключить

Функция: subaccount.suspend

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Счета → кнопка Выкл.

Уровень доступа: admin

Параметры:

elid — один или несколько уникальных идентификаторов объекта, разделённых запятой. Уникальный идентификатор — элемент id из функции subaccount.

Вывод средств со счёта

Функция: subaccount.refund

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Счета → кнопка Вывод.

Уровень доступа: admin

Включить

Функция: subaccount.resume

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Счета → кнопка Вкл.

Уровень доступа: admin

Параметры:

elid — один или несколько уникальных идентификаторов объекта, разделённых запятой. Уникальный идентификатор — элемент id из функции subaccount.

Скидки

Функция: account.discount

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Скидки.

Уровень доступа: admin

Параметр	Тип	Обязательный	Значение
`id`	Положительное целое число	нет	Уникальный идентификатор скидки.
`name`	Строка	нет	Наименование.
`actiontype`	Строка (перечисление)	нет	Услуги, на которые действует скидка
`project`	Положительное целое число	нет	Провайдер.
`discount_type`	Строка (перечисление)	нет	Тип скидки.
`period`	Строка (перечисление)	нет	Срок действия.

Создать

Функция: account.discount.add

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Скидки → кнопка Создать.

Уровень доступа: admin

Удалить

Функция: account.discount.delete

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Скидки → кнопка Удалить.

Уровень доступа: admin

Параметры:

elid — один или несколько уникальных идентификаторов объекта, разделённых запятой.

Редактирование скидки

Функция: account.discount.edit

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Скидки → кнопка Изменить.

Уровень доступа: admin

Параметры:
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- elid — уникальный идентификатор (элемент idname из функции account.discount).
Результат: список параметров объекта.

Создание объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Изменение объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- elid — уникальный идентификатор (элемент idname из функции account.discount);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Список параметров объекта или дополнительных параметров запроса:

Параметр	Тип	Обязательный	Значение
`fromdate`	Дата и время	нет	С даты. Первый день действия скидки.
`todate`	Дата и время	нет	По дату. Последний день действия скидки.
`type`	Строка (перечисление)	нет	Тип скидки. Способ предоставления скидки.
`percentage`	Строка	нет	Скидка в % на стоимость услуги или товара.
`priority`	Положительное целое число	нет	Приоритет скидки. По умолчанию скидки заданные клиенту персонально имеют больший приоритет, чем скидки указанные в промоакциях. Если задать скидке отрицательный приоритет, она будет применена только при отсутствии подходящих скидок из промоакций.
`actiontype`	Строка (перечисление)	нет	Выберите, на что действует скидка. Обратите внимание, что скидка на продление не будет действовать на тарифы с ежедневным списанием.
`period`	Строка (перечисление)	нет	Период заказа, на который распространяется скидка.
`note`	Строка	нет	Комментарий к скидке.

История изменений скидки

Функция: account.discount.history

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Скидки → кнопка История.

Уровень доступа: admin

Отправка СМС сообщения

Функция: account.sms

Результат: успешное выполнение операции или сообщение об ошибке

Для работы опции должен быть настроен СМС-шлюз.

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка СМС.

Уровень доступа: admin

Используется для просмотра параметров объекта, изменения объекта и создания нового объекта.

Просмотр параметров объекта:

Параметры:
- elid — уникальный идентификатор (элемент id из функции account).
Результат: список параметров объекта.

Создание объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Изменение объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- elid — уникальный идентификатор (элемент id из функции account);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Список параметров объекта или дополнительных параметров запроса:

Параметр	Тип	Обязательный	Значение
`type`	Положительное целое число	нет	Выбор номера телефона, на который будет отправлено сообщение.
`phone`	Строка	да	Номер телефона, на который будет отправлено сообщение.
`message`	Строка	да	Сообщение.

Установить фильтр по клиенту

Функция: account.setfilter

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка По клиенту.

Уровень доступа: admin

Установка фильтра

Функция: account.filter

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → меню Фильтр.

Курс валют

Функция: account.currencyrate

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Курс валют.

Уровень доступа: admin

Параметр	Тип	Обязательный	Значение
`id`	Положительное целое число	нет	Уникальный идентификатор курса.
`currency_base`	Строка	нет	Валюта.
`rate`	Строка	нет	Курс.
`ratedate`	Дата и время	нет	Дата курса.

Курс валют

Функция: account.currencyrate.edit

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Курс валют → кнопка Изменить.

Уровень доступа: admin

Параметры:
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- elid — уникальный идентификатор (элемент id из функции account.currencyrate).
Результат: список параметров объекта.

Создание объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Изменение объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- elid — уникальный идентификатор (элемент id из функции account.currencyrate);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Список параметров объекта или дополнительных параметров запроса:

Параметр	Тип	Обязательный	Значение
`currency_base`	Строка	нет	Базовая валюта, в которую проводится конвертация.
`currency_relate`	Строка	нет	Конвертируемая валюта. Валюта, которая конвертируется в базовую.
`rate`	Строка	нет	Значение курса валюты на указанную дату за указанное количество единиц.
`amount`	Строка	нет	Количество единиц базовой валюты, за которое указан курс конвертации.
`ratedate`	Дата и время	нет	Дата, с которой действует курс.

Удалить

Функция: account.currencyrate.delete

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Курс валют → кнопка Удалить.

Уровень доступа: admin

Параметры:

elid — один или несколько уникальных идентификаторов объекта, разделённых запятой. Уникальный идентификатор — элемент id из функции account.currencyrate.

Расходы

Функция: subaccount.expense

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Расходы.

Уровень доступа: admin

Параметр	Тип	Обязательный	Значение
`id`	Положительное целое число	нет	Уникальный идентификатор расхода.
`locale_name`	Строка	нет	Наименование.
`realdate`	Дата и время	нет	Дата списания.
`cdate`	Дата и время	нет	Дата оказания услуги.
`amount`	Строка	нет	Сумма.
`notpayd`	Флаг	нет	Не оплачено.
`discountamount`	Строка	нет	Сумма скидки.
`payments`	Строка (список)	нет	Оплачено платежами.
`discount`	Положительное целое число	нет	Код скидки.
`taxamount`	Строка	нет	Налог.

Установка фильтра

Функция: subaccount.expense.filter

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Расходы → меню Фильтр.

Редактирование расхода

Функция: subaccount.expense.edit

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Расходы → кнопка Изменить.

Уровень доступа: admin

Параметры:
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- elid — уникальный идентификатор (элемент id из функции subaccount.expense).
Результат: список параметров объекта.

Создание объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Изменение объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- elid — уникальный идентификатор (элемент id из функции subaccount.expense);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Список параметров объекта или дополнительных параметров запроса:

Параметр	Тип	Обязательный	Значение
`subaccount`	Положительное целое число	нет	Провайдер / id счёта (id плательщика).
`item`	Положительное целое число	нет	id услуги. Выберите услугу, за которую будет создан расход.
`operation`	Строка (перечисление)	нет	Операция, на основании которой будет расход. Например: `prolong`, `billdaily`, `changeaddon`.
`amount`	Строка	нет	Сумма расхода.
`taxrate`	Строка	нет	Ставка налога. Процент налогов. Сумма налога включена в сумму расхода и высчитывается по формуле: СУММА — (СУММА / ((100 + СТАВКА) / 100))
`postpaid`	Флаг	нет	Если опция установлена, то при нехватке средств на счёте расход будет создан в долг. Чтобы включить данную опцию, используйте значение `on`.
`name`	Строка	нет	Наименование. Вы можете указать собственное наименование. Если вы не укажете наименование, то оно будет сгенерировано автоматически на основе операции.
`realdate`	Дата и время	нет	Фактическая дата списания.
`cdate`	Дата и время	нет	Дата начала оказание услуги.
`plid`	Положительное целое число	нет	id клиента.

Пример запроса

https://<адрес_биллинга>/billmgr?func=subaccount.expense.edit&authinfo=xxx:xxx&amount=<сумма>&item=<id_услуги>&name=<Name>&name_ru=<name_ru>&operation=<вид_операции>&plid=<id_клиента>&postpaid=<on>&sok=ok&subaccount=<id_лицевого_счёта>

Параметры

Удалить

Функция: subaccount.expense.delete

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Расходы → кнопка Удалить.

Уровень доступа: admin

Параметры:

elid — один или несколько уникальных идентификаторов объекта, разделённых запятой. Уникальный идентификатор — элемент id из функции subaccount.expense.

Ставки налогов

Функция: account.taxrule

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Налоги.

Уровень доступа: admin

Параметр	Тип	Обязательный	Значение
`id`	Положительное целое число	нет	Уникальный идентификатор правила.
`type`	Строка (перечисление)	нет	Тип.
`project`	Положительное целое число	нет	Провайдер.
`company`	Положительное целое число	нет	Компания.
`country`	Положительное целое число	нет	Страна плательщика.
`taxrate`	Строка	нет	Ставка налога.
`itemtype`	Строка (перечисление)	нет	Тип продукта.

Удалить правило

Функция: account.taxrule.delete

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Налоги → кнопка Удалить.

Уровень доступа: admin

Параметры:

elid — один или несколько уникальных идентификаторов объекта, разделённых запятой. Уникальный идентификатор — элемент id из функции account.taxrule.

Специальное правило

Функция: account.taxrule.edit

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Налоги → кнопка Изменить.

Уровень доступа: admin

Параметры:
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- elid — уникальный идентификатор (элемент id из функции account.taxrule).
Результат: список параметров объекта.

Создание объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Изменение объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- plid — уникальный идентификатор родительского списка (элемент id из функции account);
- elid — уникальный идентификатор (элемент id из функции account.taxrule);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Список параметров объекта или дополнительных параметров запроса:

Параметр	Тип	Обязательный	Значение
`project`	Положительное целое число	нет	Наименование провайдера.
`taxrate`	Строка	нет	Ставка налога. Укажите налоговую ставку для выбранной страны.
`specialitemtype`	Флаг	нет	Опция "Только на определенные типы продуктов". Если включена, налогообложению подвергаются не все типы продуктов. Чтобы включить данную опцию, используйте значение `on`.
`itemtype`	Строка (список)	нет	Типы продуктов. Укажите, какие типы продуктов облагаются налогами.

Редактирование информации о клиенте

Функция: account.edit

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопки Создать или Изменить.

Уровень доступа: admin

Используется для просмотра параметров объекта, изменения объекта и создания нового объекта.

Просмотр параметров объекта:

Параметры:
- elid — уникальный идентификатор (элемент id из функции account).
Результат: список параметров объекта.

Создание объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Изменение объекта:

Параметры:
- sok — значение параметра должно быть не пустым, обычно ok;
- elid — уникальный идентификатор (элемент id из функции account);
- дополнительные параметры запроса.
Результат: успешное выполнение операции или сообщение об ошибке.

Список параметров объекта или дополнительных параметров запроса:

Параметр	Тип	Обязательный	Значение
`email`	Строка	нет	Email клиента, также будет использоваться как логин для авторизации в BILLmanager.
`verify_email`	Флаг	нет	Подтверждение email. Чтобы включить данную опцию, используйте значение `on`.
`project`	Положительное целое число	нет	Провайдер, к которому будет привязан клиент.
`country`	Положительное целое число	нет	Страна клиента.
`state`	Положительное целое число	нет	Регион.
`realname`	Строка	нет	Контактное лицо. ФИО клиента или контактного лица организации, для которой создаётся учётная запись.
`name`	Строка	нет	Наименование клиента.
`settingurl`	Строка	нет	URL настроек. URL получения настроек панелями ispmanager.
`valid_phone`	Строка	нет	Проверенный номер телефона клиента.
`try_phone`	Строка	нет	Номер телефона клиента.
`label`	Строка	нет	Метка. Служебная информация, доступная в фильтре.
`selfview`	Строка	нет	Своё пространство имен. Позволяет подменить указываемые в настройках панели сервера имен.
`passwd`	Строка	нет	Пароль доступа в личный кабинет.
`confirm`	Строка	нет	Подтверждение.
`products_page`	Положительное целое число	нет	Страница.
`registration_date`	Дата и время	нет	Дата регистрации.
`registration_ip`	Строка	нет	IP-адрес, с которого произведена регистрация клиента.
`attitude`	Положительное целое число	нет	Характеристика клиента.
`employee`	Положительное целое число	нет	Сотрудник, зарегистрировавший клиента.
`nocalcstat`	Флаг	нет	Услуги клиента не будут отображаться в статистике. Чтобы включить данную опцию, используйте значение `on`.
`note`	Строка	нет	Комментарий к клиенту.
`notify`	Флаг	нет	Отправить клиенту уведомление о регистрации в BILLmanager. Чтобы включить данную опцию, используйте значение `on`.
`recovery`	Флаг	нет	Добавить в уведомление данные для сброса пароля. Чтобы включить данную опцию, используйте значение `on`.

Войти в панель с правами пользователя

Функция: account.su

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Войти.

Уровень доступа: admin

Удалить

Функция: account.delete

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Удалить.

Уровень доступа: admin

Параметры:

elid — один или несколько уникальных идентификаторов объекта, разделённых запятой. Уникальный идентификатор — элемент id из функции account.

Провайдеры, доступные клиенту

Функция: account.project

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Провайдеры.

Уровень доступа: admin

Параметр	Тип	Обязательный	Значение
`id`	Положительное целое число	нет	Уникальный идентификатор провайдера.
`name`	Строка	нет	Наименование.
`status`	Строка (список)	нет	Статус.

Включить

Функция: account.project.resume

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Провайдеры → выберите провайдера → кнопка Включить.

Уровень доступа: admin

Параметры:

plid — уникальный идентификатор родительского списка (элемент id из функции account);
elid — один или несколько уникальных идентификаторов объекта, разделённых запятой. Уникальный идентификатор — элемент id из функции account.project.

Выключить

Функция: account.project.suspend

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Провайдеры → выберите провайдера → кнопка Выключить.

Уровень доступа: admin

Параметры:

elid — один или несколько уникальных идентификаторов объекта, разделённых запятой. Уникальный идентификатор — элемент id из функции account.project.

История изменения параметров клиента

Функция: account.history

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка История.

Уровень доступа: admin

Сведения о верификации клиента

Функция: account.validate

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Верификация.

Уровень доступа: admin

Заказы клиента

Функция: account.orders

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Заказы.

Уровень доступа: admin

Валюты клиента

Функция: account.currency

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Клиенты → выберите клиента → кнопка Курс валют.

Уровень доступа: admin

Объединение клиентов

Функция: account.join

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Инструменты → Объединение клиентов.

Уровень доступа: admin

Группы клиентов (accountgroup)

Функция: accountgroup

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Группы клиентов.

Уровень доступа: admin

Редактирование группы

Функция: accountgroup.edit

Результат: успешное выполнение операции или сообщение об ошибке

В веб-интерфейсе платформы: раздел Клиенты → Группы клиентов → кнопка Создать или Изменить.

Уровень доступа: admin

Условия автовключения в группу

Функция: accountgroup.condition

Результат: список элементов

В веб-интерфейсе платформы: раздел Клиенты → Группы клиентов → кнопка Условия автовключения.

Уровень доступа: admin