В веб-интерфейсе платформы: раздел Провайдер → Сотрудники в левом меню платформы.
Возвращает список сотрудников с основными параметрами. Поддерживает фильтрацию, сортировку и пагинацию.
Уровень доступа: root, admin
Параметр
Тип
Обязательный
Значение
elid
Положительное целое число
нет
Фильтрация по уникальному идентификатору сотрудника.
name
Строка
нет
Логин сотрудника. Поддерживается подстановочный знак *.
realname
Строка
нет
ФИО сотрудника. Поддерживается подстановочный знак *.
email
Строка
нет
Email сотрудника. Поддерживается подстановочный знак *.
department
Строка
нет
Отделы, в которых состоит сотрудник. Поддерживается подстановочный знак *.
status
Строка (составное)
нет
Дополнительные параметры сотрудника: enabled, default_access_allow, all_ip_access, ip_access, totp.
session
Строка (составное)
нет
Информация об активности пользователя: onsite, another_session, has_session.
sort
Строка
нет
Имя колонки для сортировки: id, name, realname, email, department.
pagesize
Положительное целое число
нет
Количество записей на странице результата.
startidx
Неотрицательное целое число
нет
Смещение первой записи для пагинации.
Создать сотрудника
Функция: employee.edit
Результат: успешное выполнение операции или сообщение об ошибке
В веб-интерфейсе платформы: раздел Провайдер → Сотрудники → кнопка Создать.
Функция создаёт нового сотрудника. Требует подтверждения через параметр sok.
Уровень доступа: root, admin
Параметр
Тип
Обязательный
Значение
name
Строка
да
Логин для входа в систему.
realname
Строка
нет
Фамилия, Имя, Отчество сотрудника.
position
Строка
нет
Должность сотрудника. Отображается в запросах в интерфейсе BILLmanager 6.
passwd
Строка
да
Пароль доступа.
confirm
Строка
да
Подтверждение пароля (должно совпадать с passwd).
email
Строка
нет
Email сотрудника.
phone
Строка
нет
Номер телефона сотрудника. Может быть использован для отправки СМС-уведомлений.
department
Строка (список)
нет
Отделы, в которые необходимо включить сотрудника. Перечисляются через запятую.
default_access_allow
Флаг
нет
Разрешить сотруднику полный доступ, игнорируя права отделов. Значение on включает опцию.
all_ip_access
Флаг
нет
Разрешить доступ с любого IP-адреса. Значение on включает опцию.
ip_access
Строка (список)
нет
Список разрешённых IP-адресов. Используется, если all_ip_access не установлен.
sok
Строка
да
Значение ok подтверждает выполнение операции. Без этого параметра изменения не будут применены.
Изменить данные сотрудника
Функция: employee.edit
Результат: успешное выполнение операции или сообщение об ошибке
В веб-интерфейсе платформы: раздел Провайдер → Сотрудники → кнопка Изменить.
Функция используется для редактирования существующего сотрудника. Требует подтверждения через параметр sok.
Уровень доступа: root, admin
Параметр
Тип
Обязательный
Значение
elid
Положительное целое число
да
Уникальный идентификатор сотрудника для редактирования.
name
Строка
нет
Новый логин для входа в систему.
realname
Строка
нет
Новое ФИО сотрудника.
position
Строка
нет
Новая должность сотрудника.
passwd
Строка
нет
Новый пароль доступа. Если не указан — пароль не изменяется.
confirm
Строка
нет
Подтверждение нового пароля.
email
Строка
нет
Новый Email сотрудника.
phone
Строка
нет
Новый номер телефона сотрудника.
department
Строка (список)
нет
Отделы, в которых состоит сотрудник. Перечисляются через запятую.
default_access_allow
Флаг
нет
Установить полный доступ. Значение on включает, пустое значение — выключает.
all_ip_access
Флаг
нет
Разрешить доступ с любого IP-адреса. Значение on включает, пустое — выключает.
ip_access
Строка (список)
нет
Новый список разрешённых IP-адресов.
sok
Строка
да
Значение ok подтверждает выполнение операции.
Удалить сотрудника
Функция: employee.delete
Результат: успешное выполнение операции или сообщение об ошибке
В веб-интерфейсе платформы: раздел Провайдер → Сотрудники → кнопка Удалить.
Поддерживает удаление нескольких сотрудников через запятую. Требуется подтверждение через параметр sok. Нельзя удалить текущую сессию (self=on).
Уровень доступа: root, admin
Параметр
Тип
Обязательный
Значение
elid
Строка (список)
да
Один или несколько id сотрудников через запятую. Например, 123,456.
sok
Строка
да
Значение ok подтверждает выполнение операции.
Включить доступ к биллингу
Функция: employee.resume
Результат: успешное выполнение операции или сообщение об ошибке
В веб-интерфейсе платформы: раздел Провайдер → Сотрудники → выделите сотрудника → кнопка Вкл.
Активирует доступ сотрудника к системе. Скрыта, если сотрудник уже активен (enabled=on).
Уровень доступа: root, admin
Параметр
Тип
Обязательный
Значение
elid
Строка (список)
да
Один или несколько id сотрудников через запятую.
sok
Строка
да
Значение ok подтверждает выполнение операции.
Отключить доступ к биллингу
Функция: employee.suspend
Результат: успешное выполнение операции или сообщение об ошибке
В веб-интерфейсе платформы: раздел Провайдер → Сотрудники → выделите сотрудника → кнопка Выкл.
Приостанавливает доступ сотрудника к системе. Скрыта, если сотрудник уже неактивен (enabled=off).
Уровень доступа: root, admin
Параметр
Тип
Обязательный
Значение
elid
Строка (список)
да
Один или несколько id сотрудников через запятую.
sok
Строка
да
Значение ok подтверждает выполнение операции.
Завершить сессии сотрудника
Функция: employee.logout
Результат: успешное выполнение операции или сообщение об ошибке
В веб-интерфейсе платформы: раздел Провайдер → Сотрудники → кнопка Выход.
Завершает все активные сессии сотрудника. Доступна только при наличии активной сессии (has_session=on) и для чужих аккаунтов (self=off).
Уровень доступа: root, admin
Параметр
Тип
Обязательный
Значение
elid
Строка (список)
да
Один или несколько id сотрудников через запятую.
sok
Строка
да
Значение ok подтверждает выполнение операции.
Войти с правами сотрудника
Функция: employee.su
Результат: успешное выполнение операции или сообщение об ошибке
В веб-интерфейсе платформы: раздел Провайдер → Сотрудники → выделите сотрудника → кнопка Войти.
Открывает сессию от имени выбранного сотрудника. Скрыта при ограничении not_admin_to_admin.
Уровень доступа: root, admin
Параметр
Тип
Обязательный
Значение
elid
Положительное целое число
да
Уникальный идентификатор сотрудника, под которым необходимо выполнить вход.
Установить права доступа
Функция: rights2.user
Результат: список элементов
В веб-интерфейсе платформы: раздел Провайдер → Сотрудники → выделите сотрудника → кнопка Права.
Возвращает список доступных прав для назначения учетной записи.
Уровень доступа: root, admin
Параметр
Тип
Обязательный
Значение
elid
Строка
нет
Фильтрация по имени права (элемент name).
caption
Строка
нет
Наименование права. Поддерживается подстановочный знак *.
access
Флаг
нет
Статус доступа: on — право включено, off — выключено.
Включить право доступа
Функция: rights2.user.resume
Результат: успешное выполнение операции или сообщение об ошибке
В веб-интерфейсе платформы: раздел Провайдер → Сотрудники → раздел Права → кнопка Вкл.
Уровень доступа: root, admin
Параметр
Тип
Обязательный
Значение
elid
Строка (список)
да
Одно или несколько имён прав (name) через запятую.
sok
Строка
да
Значение ok подтверждает выполнение операции.
Выключить право доступа
Функция: rights2.user.suspend
Результат: успешное выполнение операции или сообщение об ошибке
В веб-интерфейсе платформы: раздел Провайдер → Сотрудники → раздел Права → кнопка Выкл.
Уровень доступа: root, admin
Параметр
Тип
Обязательный
Значение
elid
Строка (список)
да
Одно или несколько имён прав (name) через запятую.
sok
Строка
да
Значение ok подтверждает выполнение операции.
Фильтр списка сотрудников
Функция: employee.filter
Результат: успешное выполнение операции или сообщение об ошибке
В веб-интерфейсе платформы: панель фильтрации в разделе Сотрудники.
Условия фильтра сохраняются и применяются ко всем последующим вызовам employee до изменения или сброса.
Уровень доступа: root, admin, user
Параметр
Тип
Обязательный
Значение
name
Строка
нет
Фильтр по логину. Поддерживается подстановочный знак *.
realname
Строка
нет
Фильтр по ФИО. Поддерживается подстановочный знак *.
email
Строка
нет
Фильтр по email. Поддерживается подстановочный знак *.
department
Строка
нет
Фильтр по отделам. Поддерживается подстановочный знак *.
reset
Флаг
нет
Значение on сбрасывает все установленные фильтры.
Отдел сотрудника
Функция: employee.department
Результат: список элементов
В веб-интерфейсе платформы: раздел Провайдер → Сотрудники → выделите сотрудника → кнопка Отделы.
Возвращает список отделов, в которые входит сотрудник.
Уровень доступа: root, admin
Параметр
Тип
Обязательный
Значение
elid
Положительное целое число
нет
Идентификатор отдела.
name
Строка
нет
Название отдела. Поддерживается подстановочный знак *.
status
Строка
нет
Состояние отдела: on — активен, off — неактивен.
Включить сотрудника в отдел
Функция: employee.department.resume
Результат: успешное выполнение операции или сообщение об ошибке
В веб-интерфейсе платформы: раздел Провайдер → Сотрудники → раздел Отделы → кнопка Включить.
Уровень доступа: root, admin
Параметр
Тип
Обязательный
Значение
elid
Строка (список)
да
Один или несколько id записей связи "сотрудник-отдел" через запятую.
sok
Строка
да
Значение ok подтверждает выполнение операции.
Исключить сотрудника из отдела
Функция: employee.department.suspend
Результат: успешное выполнение операции или сообщение об ошибке
В веб-интерфейсе платформы: раздел Провайдер → Сотрудники → раздел Отделы → кнопка Исключить.
Уровень доступа: root, admin
Параметр
Тип
Обязательный
Значение
elid
Строка (список)
да
Один или несколько id записей связи "сотрудник-отдел" через запятую.
sok
Строка
да
Значение ok подтверждает выполнение операции.
Удалить связь с отделом
Функция: employee.department.delete
Результат: успешное выполнение операции или сообщение об ошибке
В веб-интерфейсе платформы: раздел Провайдер → раздел Отделы → кнопка Удалить.
Уровень доступа: root, admin
Параметр
Тип
Обязательный
Значение
elid
Строка (список)
да
Один или несколько id записей связи через запятую.
sok
Строка
да
Значение ok подтверждает выполнение операции.
Отправка СМС
Функция: employee.sms
Результат: успешное выполнение операции или сообщение об ошибке
Для работы опции должен быть настроен СМС-шлюз.
В веб-интерфейсе платформы: раздел Провайдер → Сотрудники → кнопка СМС.
Отправляет СМС-сообщение сотруднику. Для изменения/создания требуется параметр sok.
Уровень доступа: admin
Параметр
Тип
Обязательный
Значение
elid
Положительное целое число
нет
Идентификатор сотрудника для просмотра или отправки СМС.
type
Строка
нет
Тип номера телефона для отправки: phone, mobile и др.
phone
Строка
нет
Номер телефона, на который будет отправлено сообщение.
message
Строка
нет
Текст отправляемого сообщения.
sok
Строка
нет
Значение ok подтверждает отправку сообщения.
Настройки центра поддержки
Функция: employee.support_tool_settings
Результат: успешное выполнение операции или сообщение об ошибке
В веб-интерфейсе платформы: раздел Провайдер → Сотрудники → кнопка Настройки.
Возвращает или изменяет параметры работы центра поддержки для сотрудника.
Уровень доступа: admin
Параметр
Тип
Обязательный
Значение
elid
Положительное целое число
нет
Идентификатор сотрудника для просмотра настроек.
param_name
Строка
нет
Имя настраиваемого параметра.
param_value
Строка
нет
Новое значение параметра.
sok
Строка
нет
Значение ok подтверждает сохранение изменений.
Назначить ответственного сотрудника
Функция: support_tool_responsible
Результат: успешное выполнение операции или сообщение об ошибке
В веб-интерфейсе платформы: кнопка Передать в тикете.
Назначает запрос на сотрудника или отдел. Используйте или elid, или plid. При использовании plid необходимо зайти под сотрудником, на которого назначен тикет.
Уровень доступа: root, admin
Параметр
Тип
Обязательный
Значение
elid
Положительное целое число
да
id запроса в разделе "Все запросы".
plid
Положительное целое число
да
id запроса в разделе "Запросы".
set_responsible
Положительное целое число
да
id сотрудника или отдела. Для отдела используется префикс d_.
set_responsible_default
Флаг
нет
Значение on назначит ответственного по умолчанию.
sok
Строка
нет
Значение ok позволяет передать форму.
su
Строка
нет
Логин сотрудника, под которым необходимо выполнить запрос.