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

Материал из WiKi - UserSide
Строка 15: Строка 15:
   codeti - id абонента в биллинге
   codeti - id абонента в биллинге
   is_potential - флаг - потенциальный абонент
   is_potential - флаг - потенциальный абонент
  billing_id - id биллинга
  Дополнительно возвращаемые данные:
  Дополнительно возвращаемые данные:
   array(
   array(

Версия от 11:37, 22 сентября 2017

Раздел API ERP "UserSide"

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

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

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

add

Описание: Добавление абонента
Обязательные параметры:
 fio - ФИО абонента
Необязательные параметры:
 codeti - id абонента в биллинге
 is_potential - флаг - потенциальный абонент
 billing_id - id биллинга
Дополнительно возвращаемые данные:
 array(
  [Id] => ID нового абонента в случае успеха
 )

abon_hist

Описание: Вывод операций с абонентом (финансовые и прочие)
Обязательные параметры:
 usercode - ID абонента (tbl_base.CODE)
Дополнительно возвращаемые данные:
 перечень тарифов
 array(
  [Id] - ID_ТИП операции
  [DateDo] - дата операции
  [OperID] - ID оператора (tbl_oper.CODE)
  [BalansBefore] - баланс абонента до операции
  [Amount] - сумма операции
  [PKO] - номер приходного кассового ордера
  [Comment] - описание операции
  [BillingDopData] - дополнительные данные по операции из биллинга (используется при импорте данных из сторонних биллингов)
 )

change_balance

Описание: Изменение баланса
Обязательные параметры:
 customer_id - ID абонента
 amount - Сумма
 comment - Заметки к операции

get_abon_id

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

get_data

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

get_last_ip

Описание: Получение последнего используемого IP-адреса для абонентов
Дополнительно возвращаемые данные:
 array(
  [ip] => используемый IP-адрес в hex-формате
 )

list_tarif_available

Описание: Список тарифов, доступных абоненту для смены
Обязательные параметры:
 usercode - ID абонента (tbl_base.CODE)
Дополнительно возвращаемые данные:
 перечень тарифов
 array(
  [TarifList] => array(
   [Id] - ID тарифа (tbl_group.CODE)
   [Name] - Название тарифа
   [Price] - Стоимость тарифа
   [IsDayPrice] - Флаг - ежедневная ли стоимость
  )
 )

msg

Описание: Вывод переписки с абонентом
Обязательные параметры:
 usercode - ID абонента (tbl_base.CODE)
Дополнительно возвращаемые данные:
 перечень тарифов
 array(
  [Id] - ID сообщения (tbl_trouble.CODE)
  [DateMsg] - дата сообщения
  [MsgTyper] - (OperMsg/UserMsg) - тип сообщения. Сообщения от абонента или от оператора
  [Text] - текст сообщения
  [Attach] = array( - массив с прикрепленными файлами
   [Id] - ID файла (tbl_attach.CODE)
   [FilePath] - URL к файлу
   [RealName] - изначальное имя файла
  )
 )

pass_change

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

tarif_change

Описание: Смена тарифа абоненту
Обязательные параметры:
 usercode - ID абонента (tbl_base.CODE)
 tarif - ID нового тарифа (tbl_group.CODE)