API customer: различия между версиями

Материал из WiKi - UserSide
 
(не показано 26 промежуточных версий 2 участников)
Строка 1: Строка 1:
[[API_customer_EN|en]] | [[API_customer|ru]]
Раздел '''[[API]]''' ERP "UserSide"
Раздел '''[[API]]''' ERP "UserSide"


Строка 4: Строка 6:


  Дополнительные параметры:
  Дополнительные параметры:
  subcat - подкатегория запроса ''(возможное значение: см.ниже)''
  action - подкатегория запроса ''(возможное значение: см.ниже)''


== Подкатегории ==
== Подкатегории ==
Строка 16: Строка 18:
   is_potential - флаг - потенциальный абонент
   is_potential - флаг - потенциальный абонент
   is_corporate - флаг - юридическое лицо
   is_corporate - флаг - юридическое лицо
   billing_id - id биллинга
   billing_id - id биллинга ''(является обязательным, если это не потенциальный абонент)''
  billing_customer_id - id абонента в биллинге ''(является обязательным, если это не потенциальный абонент)''


==== abon_hist ====
==== abon_hist ====
''Доработано в: 3.17dev1 (исключен параметр usercode, добавлен параметр customer_id)''
  Описание: Вывод операций с абонентом (финансовые и прочие)
  Описание: Вывод операций с абонентом (финансовые и прочие)
  Обязательные параметры:
  Обязательные параметры:
   usercode - ID абонента
   usercode - ''(для версии 3.16 и ранее)'' ID абонента
  customer_id - ''(для версии 3.17 и позже)'' ID абонента


==== change_balance ====
==== change_balance ====
Строка 37: Строка 43:


==== change_billing ====
==== change_billing ====
''Доработано в: 3.16.23 (добавлен параметр billing_user_id)''


''Добавлено в: 3.12.48''
''Добавлено в: 3.12.48''
Строка 42: Строка 49:
  Описание: Изменение биллинга
  Описание: Изменение биллинга
  Обязательные параметры:
  Обязательные параметры:
   customer_id - ID абонента
   customer_id - id абонента
   billing_id - ID биллинга
   billing_id - id биллинга
Необязательные параметры:
  billing_user_id - id абонента в биллинге


==== change_date_connect ====
==== change_date_connect ====
Строка 61: Строка 70:


==== edit ====
==== edit ====
''Доработано в: 3.16dev3 (добавлен параметр group_id)''
''Доработано в: 3.13.56 (добавлен параметр manager_id)''
''Доработано в: 3.13.56 (добавлен параметр manager_id)''


Строка 73: Строка 84:
   agreement_number - номер договора
   agreement_number - номер договора
   apartment_number - номер квартиры
   apartment_number - номер квартиры
  manager_id - id сотрудника-менеджера
   comment - заметки
   comment - заметки
   date_activity - дата активности в сети
   date_activity - дата активности в сети
Строка 82: Строка 92:
   flag_corporate - флаг - юридическое лицо
   flag_corporate - флаг - юридическое лицо
   floor - этаж
   floor - этаж
  group_id - id группы
   house_id - id дома
   house_id - id дома
   is_potential - флаг - потенциальный абонент
   is_potential - флаг - потенциальный абонент
   login - логин
   login - логин
  manager_id - id сотрудника-менеджера
   name - наименование абонента
   name - наименование абонента
   parent_id - id родительского абонента ''(для дочернего абонента)''
   parent_id - id родительского абонента ''(для дочернего абонента)''
Строка 104: Строка 116:
  Необязательные параметры:
  Необязательные параметры:
   is_skip_old - флаг - не выполнять поиск среди бывших абонентов
   is_skip_old - флаг - не выполнять поиск среди бывших абонентов
==== get_customer_group ====
''Добавлено в: 3.19beta1''
Описание: Получение списка групп абонентов
Обязательные параметры:
  нет
Необязательные параметры:
  нет


==== get_customers_id ====
==== get_customers_id ====
''Доработано в: 3.18.36 (добавлен параметр manager_id)''
''Доработано в: 3.18.10 (добавлен параметр is_corporate)''
''Доработано в: 3.16dev3 (добавлены параметры name, limit, is_like)''
''Доработано в: 3.16dev3 (добавлены параметры name, limit, is_like)''


Строка 136: Строка 162:
   dependence_device_id - id устройства, от которого зависят абоненты
   dependence_device_id - id устройства, от которого зависят абоненты
   house_id - id дома
   house_id - id дома
  is_corporate - флаг - юридическое лицо
   is_ex - флаг - бывшие абоненты
   is_ex - флаг - бывшие абоненты
  manager_id - id менеджера ''(0 для поиска без менеджера)''
   mark_id - id метки
   mark_id - id метки
   name - ФИО/название абонента
   name - ФИО/название абонента
Строка 148: Строка 176:
  Обязательные параметры:
  Обязательные параметры:
   customer_id - ID абонента
   customer_id - ID абонента
  либо
  account_number - номер лицевого счета абонента
  +
  billing_id - ID биллинга


==== get_ip_port_device_commutation ====
==== get_ip_port_device_commutation ====
Строка 155: Строка 187:
==== get_last_ip ====
==== get_last_ip ====
  Описание: Получение последнего используемого IP-адреса для абонентов
  Описание: Получение последнего используемого IP-адреса для абонентов
Дополнительно возвращаемые данные:
 
  array(
==== get_mac_history ====
  [ip] => используемый IP-адрес в hex-формате
 
   )
''Добавлено в: 3.16dev8''
 
Описание: Получение истории изменения MAC-адресов по абоненту
Обязательные параметры:
   customer_id - id абонента


==== get_max_agreement_number ====
==== get_max_agreement_number ====
Строка 167: Строка 203:


==== ip_add ====
==== ip_add ====
''Доработано в: 3.17.36 (добавлен параметр mac)''


''Добавлено в: 3.12.83''
''Добавлено в: 3.12.83''
Строка 174: Строка 212:
   customer_id - ID абонента
   customer_id - ID абонента
   value - IP
   value - IP
Необязательные параметры:
  mac - MAC абонента


==== ip_delete ====
==== ip_delete ====
''Доработано в: 3.19beta1 (в параметр value добавлено возможное значение all)''


''Добавлено в: 3.12.83''
''Добавлено в: 3.12.83''
Строка 182: Строка 224:
  Обязательные параметры:
  Обязательные параметры:
   customer_id - id абонента
   customer_id - id абонента
   value - ip
   value - ip или "-1" для записей без IP-адреса ''(только с MAC-адресом)'' или "all" для всех адресов


==== ip_subnet_add ====
==== ip_subnet_add ====
Строка 226: Строка 268:


==== msg ====
==== msg ====
''Доработано в: 3.17dev1 (исключен параметр usercode, добавлен параметр customer_id)''
''Доработано в: 3.16dev3 (параметр usercode сделан необязательным)''
''Доработано в: 3.16dev2 (исключен параметр operator_id, добавлен параметр employee_id)''
''Доработано в: 3.16dev2 (исключен параметр operator_id, добавлен параметр employee_id)''


Строка 231: Строка 277:


  Описание: Вывод переписки с абонентом
  Описание: Вывод переписки с абонентом
  Обязательные параметры:
  Необязательные параметры ''(но должно быть что-то одно)'':
   usercode - ID абонента
   usercode - ''(для версии 3.16 и ранее)'' ID абонента
Необязательные параметры:
  customer_id - ''(для версии 3.17 и позже)'' ID абонента
   date_add_from - дата сообщения (с)
   date_add_from - дата сообщения (с)
   date_add_to - дата сообщения (до)
   date_add_to - дата сообщения (до)
   employee_id - ID сотрудника-автора сообщения
   employee_id - id сотрудника-автора сообщения
   operator_id - ID оператора-автора сообщения ''(до версии 3.16dev2)''
   operator_id - id оператора-автора сообщения ''(до версии 3.16dev2)''


==== msg_add ====
==== msg_add ====
''Доработано в: 3.18.40 (добавлен параметр is_arc)''
''Добавлено в: 3.13.25''
''Добавлено в: 3.13.25''
  Описание: Добавление сообщения от абонента
  Описание: Добавление сообщения от абонента
  Обязательные параметры:
  Обязательные параметры:
   customer_id - Id абонента
   customer_id - id абонента
   text - Текст сообщения
   text - Текст сообщения
Необязательные параметры:
  is_arc - флаг - поместить сообщение в архив


==== pass_change ====
==== pass_change ====
''Доработано в: 3.17dev1 (исключен параметр usercode, добавлен параметр customer_id)''


''Доработано в: 3.15.23 (параметр pass_old стал необязательным)''
''Доработано в: 3.15.23 (параметр pass_old стал необязательным)''
Строка 252: Строка 303:
  Описание: Смена пароля на вход в ЛК
  Описание: Смена пароля на вход в ЛК
  Обязательные параметры:
  Обязательные параметры:
   usercode - ID абонента
   usercode - ''(для версии 3.16 и ранее)'' ID абонента
  customer_id - ''(для версии 3.17 и позже)'' ID абонента
   pass_new - новый пароль
   pass_new - новый пароль
  Дополнительные параметры:
  Дополнительные параметры:
   pass_old - текущий пароль
   pass_old - текущий пароль
==== service_add ====
''Добавлено в: 3.18beta1''
Описание: Добавление доп.услуги
Обязательные параметры:
  customer_id - id абонента
  service_id - id доп.услуги
Необязательные параметры:
  price - индивидуальная стоимость
  comment - заметки
==== service_remove ====
''Добавлено в: 3.18beta1''
Описание: Удаление доп.услуги
Обязательные параметры:
  customer_id - id абонента
  service_id - id доп.услуги


==== set_mac_by_ip ====
==== set_mac_by_ip ====
Строка 265: Строка 338:


==== state_change ====
==== state_change ====
''Доработано в: 3.17dev1 (исключен параметр usercode, добавлен параметр customer_id)''
''Добавлено в: 3.12.8''
''Добавлено в: 3.12.8''
  Описание: изменение статуса работы у абонента
  Описание: изменение статуса работы у абонента
  Обязательные параметры:
  Обязательные параметры:
   usercode - ID абонента
   usercode - ''(для версии 3.16 и ранее)'' ID абонента
  customer_id - ''(для версии 3.17 и позже)'' ID абонента
   state_id - ID статуса абонента (0 - стоп, 1 - пауза, 2 - активен)
   state_id - ID статуса абонента (0 - стоп, 1 - пауза, 2 - активен)


==== tarif_change ====
==== tarif_change ====
''Доработано в: 3.17dev1 (исключен параметр usercode, добавлен параметр customer_id)''
  Описание: смена тарифа абоненту
  Описание: смена тарифа абоненту
  Обязательные параметры:
  Обязательные параметры:
   usercode - ID абонента
   usercode - ''(для версии 3.16 и ранее)'' ID абонента
  customer_id - ''(для версии 3.17 и позже)'' ID абонента
   tarif - ID нового тарифа
   tarif - ID нового тарифа


==== to_ex ====
==== to_ex ====
''Доработано в: 3.17dev1 (исключен параметр usercode, добавлен параметр customer_id)''
''Добавлено в: 3.12.69''
''Добавлено в: 3.12.69''
  Описание: перевод абонента в категорию "Бывшие абоненты"
  Описание: перевод абонента в категорию "Бывшие абоненты"
  Обязательные параметры:
  Обязательные параметры:
   usercode - ID абонента
   usercode - ''(для версии 3.16 и ранее)'' ID абонента
  customer_id - ''(для версии 3.17 и позже)'' ID абонента


==== to_normal ====
==== to_normal ====
''Доработано в: 3.17dev1 (исключен параметр usercode, добавлен параметр customer_id)''
''Добавлено в: 3.12.90''
''Добавлено в: 3.12.90''
  Описание: перевод абонента в в обычный статус (из "Бывших абонентов")
  Описание: перевод абонента в в обычный статус (из "Бывших абонентов")
  Обязательные параметры:
  Обязательные параметры:
   usercode - ID абонента
   usercode - ''(для версии 3.16 и ранее)'' ID абонента
  customer_id - ''(для версии 3.17 и позже)'' ID абонента

Текущая версия от 15:33, 13 марта 2024

en | ru

Раздел API ERP "UserSide"

Назначение: Действия с абонентами. Большинство действий актуально для ручных биллингов.

Дополнительные параметры:
action - подкатегория запроса (возможное значение: см.ниже)

Подкатегории

add

Доработано в: 3.13.25 (добавлен параметр is_corporate)

Описание: Добавление абонента
Необязательные параметры:
 fio - наименование абонента
 codeti - id абонента в биллинге
 is_potential - флаг - потенциальный абонент
 is_corporate - флаг - юридическое лицо
 billing_id - id биллинга (является обязательным, если это не потенциальный абонент)
 billing_customer_id - id абонента в биллинге (является обязательным, если это не потенциальный абонент)

abon_hist

Доработано в: 3.17dev1 (исключен параметр usercode, добавлен параметр customer_id)

Описание: Вывод операций с абонентом (финансовые и прочие)
Обязательные параметры:
 usercode - (для версии 3.16 и ранее) ID абонента
 customer_id - (для версии 3.17 и позже) ID абонента

change_balance

Доработано в: 3.16dev2 (исключен параметр operator_id, добавлен параметр employee_id)

Доработано в: 3.13.22 (добавлен параметр operator_id)

Описание: Изменение баланса (операция прихода/расхода)
Обязательные параметры:
 customer_id - ID абонента
 amount - Сумма
 comment - Заметки к операции
Необязательные параметры:
 employee_id - ID сотрудника
 operator_id - ID оператора (до версии 3.16dev2)

change_billing

Доработано в: 3.16.23 (добавлен параметр billing_user_id)

Добавлено в: 3.12.48

Описание: Изменение биллинга
Обязательные параметры:
 customer_id - id абонента
 billing_id - id биллинга
Необязательные параметры:
 billing_user_id - id абонента в биллинге

change_date_connect

Добавлено в: 3.12.80

Описание: Изменение даты подключения
Обязательные параметры:
 customer_id - ID абонента
 value - дата

delete

Добавлено в: 3.14.21

Описание: Удаление абонента
Обязательные параметры:
 id - id абонента

edit

Доработано в: 3.16dev3 (добавлен параметр group_id)

Доработано в: 3.13.56 (добавлен параметр manager_id)

Добавлено в: 3.12rc2

Описание: Редактирование абонента
Обязательные параметры:
 id - id абонента
Необязательные параметры:
 account_number - номер лицевого счёта
 agreement_date - дата договора
 agreement_number - номер договора
 apartment_number - номер квартиры
 comment - заметки
 date_activity - дата активности в сети
 date_activity_inet - дата активности в интернете
 date_connect - дата подключения
 email - адрес электронной почты
 entrance - номер подъезда
 flag_corporate - флаг - юридическое лицо
 floor - этаж
 group_id - id группы
 house_id - id дома
 is_potential - флаг - потенциальный абонент
 login - логин
 manager_id - id сотрудника-менеджера
 name - наименование абонента
 parent_id - id родительского абонента (для дочернего абонента)
 phone0 - номер мобильного телефона
 phone1 - номер домашнего телефона

get_activity_counter

Добавлено в: 3.12.81

Описание: Получение счетчика активных абонентов
Обязательные параметры:
 type - тип счетчика (Возможные значения: net, internet, personal_area)

get_abon_id

Доработано в: 3.14.34 (для параметра data_typer добавлено возможное значение account)

Описание: Получение ID абонента по входящим данным
Обязательные параметры:
 data_typer - тип данных, которые проверяем (возможные значения: account, billing_uid, codeti, dognumber, ip, login, mac, mail, phone)
 data_value - значение
Необязательные параметры:
 is_skip_old - флаг - не выполнять поиск среди бывших абонентов

get_customer_group

Добавлено в: 3.19beta1

Описание: Получение списка групп абонентов
Обязательные параметры:
 нет
Необязательные параметры:
 нет

get_customers_id

Доработано в: 3.18.36 (добавлен параметр manager_id)

Доработано в: 3.18.10 (добавлен параметр is_corporate)

Доработано в: 3.16dev3 (добавлены параметры name, limit, is_like)

Доработано в: 3.15.26 (добавлен параметр is_ex)

Доработано в: 3.14.71 (добавлен параметр dependence_device_id)

Доработано в: 3.14.58 (добавлены параметры balance_from, balance_to, state_id)

Доработано в: 3.14.41 (добавлены параметры date_connect_from и date_connect_to)

Доработано в: 3.14.5 (добавлен параметр address_unit_id)

Доработано в: 3.13.48 (добавлен параметр tariff_id)

Доработано в: 3.13.35 (добавлен параметр mark_id)

Добавлено в: 3.12.8

Описание: Получение списка ID абонентов по входящим условиям
Обязательные параметры:
 нет
Необязательные параметры (но должно быть указано хотя бы одно условие):
 address_unit_id - id адресной единицы
 appartment - номер квартиры
 balance_from - баланс (с)
 balance_to - баланс (до)
 billing_id - id номера биллинга
 date_connect_from - дата подключения (с)
 date_connect_to - дата подключения (до)
 dependence_device_id - id устройства, от которого зависят абоненты
 house_id - id дома
 is_corporate - флаг - юридическое лицо
 is_ex - флаг - бывшие абоненты
 manager_id - id менеджера (0 для поиска без менеджера)
 mark_id - id метки
 name - ФИО/название абонента
 state_id - id статуса
 tariff_id - id тарифа
 limit - максимальное количество записей, что вернуть в ответе
 is_like - флаг - использовать сравнение подстроки там где это возможно (а не полное совпадение)

get_data

Описание: Получение информации по абоненту
Обязательные параметры:
 customer_id - ID абонента
 либо
 account_number - номер лицевого счета абонента
 +
 billing_id - ID биллинга

get_ip_port_device_commutation

Добавлено в: 3.12beta35

Описание: Получение IP,MAC-адресов абонентов с привязкой к коммутаторам (в т.ч. для работы с DHCP)

get_last_ip

Описание: Получение последнего используемого IP-адреса для абонентов

get_mac_history

Добавлено в: 3.16dev8

Описание: Получение истории изменения MAC-адресов по абоненту
Обязательные параметры:
 customer_id - id абонента

get_max_agreement_number

Добавлено в: 3.12.3

Описание: Получение максимального занятого номера договора (числового)
Необязательные параметры:
 billing_id - id биллинга абонентов, среди которых выполнять выборку

ip_add

Доработано в: 3.17.36 (добавлен параметр mac)

Добавлено в: 3.12.83

Описание: Добавление IP-адреса
Обязательные параметры:
 customer_id - ID абонента
 value - IP
Необязательные параметры:
 mac - MAC абонента

ip_delete

Доработано в: 3.19beta1 (в параметр value добавлено возможное значение all)

Добавлено в: 3.12.83

Описание: Удаление IP-адреса
Обязательные параметры:
 customer_id - id абонента
 value - ip или "-1" для записей без IP-адреса (только с MAC-адресом) или "all" для всех адресов

ip_subnet_add

Добавлено в: 3.14.71

Описание: Добавление подсети IP-адресов для абонента
Обязательные параметры:
 customer_id - id абонента
 ip - начальный ip-адрес
 subnet - маска подсети/VLSM (например: 24)

ip_subnet_delete

Добавлено в: 3.14.71

Описание: Удаление подсети IP-адресов у абонента
Обязательные параметры:
 customer_id - id абонента
 ip - начальный ip-адрес

list_tarif_available

Исключено в: 3.13

Описание: Список тарифов, доступных абоненту для смены
Обязательные параметры:
 usercode - id абонента

mark_add

Добавлено в: 3.12.82

Описание: Добавление метки на абоненте
Обязательные параметры:
 customer_id - id абонента
 mark_id - id метки

mark_delete

Добавлено в: 3.12.82

Описание: Удаление метки с абонента
Обязательные параметры:
 customer_id - id абонента
 mark_id - id метки

msg

Доработано в: 3.17dev1 (исключен параметр usercode, добавлен параметр customer_id)

Доработано в: 3.16dev3 (параметр usercode сделан необязательным)

Доработано в: 3.16dev2 (исключен параметр operator_id, добавлен параметр employee_id)

Доработано в: 3.14.53 (добавлены параметры date_add_from, date_add_to, operator_id)

Описание: Вывод переписки с абонентом
Необязательные параметры (но должно быть что-то одно):
 usercode - (для версии 3.16 и ранее) ID абонента
 customer_id - (для версии 3.17 и позже) ID абонента
 date_add_from - дата сообщения (с)
 date_add_to - дата сообщения (до)
 employee_id - id сотрудника-автора сообщения
 operator_id - id оператора-автора сообщения (до версии 3.16dev2)

msg_add

Доработано в: 3.18.40 (добавлен параметр is_arc)

Добавлено в: 3.13.25

Описание: Добавление сообщения от абонента
Обязательные параметры:
 customer_id - id абонента
 text - Текст сообщения
Необязательные параметры:
 is_arc - флаг - поместить сообщение в архив

pass_change

Доработано в: 3.17dev1 (исключен параметр usercode, добавлен параметр customer_id)

Доработано в: 3.15.23 (параметр pass_old стал необязательным)

Описание: Смена пароля на вход в ЛК
Обязательные параметры:
 usercode - (для версии 3.16 и ранее) ID абонента
 customer_id - (для версии 3.17 и позже) ID абонента
 pass_new - новый пароль
Дополнительные параметры:
 pass_old - текущий пароль

service_add

Добавлено в: 3.18beta1

Описание: Добавление доп.услуги
Обязательные параметры:
 customer_id - id абонента
 service_id - id доп.услуги
Необязательные параметры:
 price - индивидуальная стоимость
 comment - заметки

service_remove

Добавлено в: 3.18beta1

Описание: Удаление доп.услуги
Обязательные параметры:
 customer_id - id абонента
 service_id - id доп.услуги

set_mac_by_ip

Добавлено в: 3.12beta35

Описание: указание MAC-адреса для IP-адреса абонента
Обязательные параметры:
 ip - IP-адрес абонента (например: 192.168.0.1)
 mac - MAC-адрес абонента (например: 00:11:22:33:44:55)

state_change

Доработано в: 3.17dev1 (исключен параметр usercode, добавлен параметр customer_id)

Добавлено в: 3.12.8

Описание: изменение статуса работы у абонента
Обязательные параметры:
 usercode - (для версии 3.16 и ранее) ID абонента
 customer_id - (для версии 3.17 и позже) ID абонента
 state_id - ID статуса абонента (0 - стоп, 1 - пауза, 2 - активен)

tarif_change

Доработано в: 3.17dev1 (исключен параметр usercode, добавлен параметр customer_id)

Описание: смена тарифа абоненту
Обязательные параметры:
 usercode - (для версии 3.16 и ранее) ID абонента
 customer_id - (для версии 3.17 и позже) ID абонента
 tarif - ID нового тарифа

to_ex

Доработано в: 3.17dev1 (исключен параметр usercode, добавлен параметр customer_id)

Добавлено в: 3.12.69

Описание: перевод абонента в категорию "Бывшие абоненты"
Обязательные параметры:
 usercode - (для версии 3.16 и ранее) ID абонента
 customer_id - (для версии 3.17 и позже) ID абонента

to_normal

Доработано в: 3.17dev1 (исключен параметр usercode, добавлен параметр customer_id)

Добавлено в: 3.12.90

Описание: перевод абонента в в обычный статус (из "Бывших абонентов")
Обязательные параметры:
 usercode - (для версии 3.16 и ранее) ID абонента
 customer_id - (для версии 3.17 и позже) ID абонента