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

Материал из WiKi - UserSide
Строка 108: Строка 108:


==== show ====
==== show ====
''Доработано в: 3.12.64 (добавлен параметр operator_id)''
  Описание: Информация о задании
  Описание: Информация о задании
   
   
''Доработано в: 3.12.64 (добавлен параметр operator_id)''
  Обязательные параметры:
  Обязательные параметры:
   id - ID задания
   id - ID задания
  Необязательные параметры:
  Необязательные параметры:
   operator_id - ID оператора, который просматривает это задание ''(для фиксации в историю по заданию)''
   operator_id - ID оператора, который просматривает это задание ''(для фиксации в историю по заданию)''

Версия от 15:41, 3 ноября 2018

Раздел API ERP "UserSide"

Назначение: Работа с заданиями

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

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

add

Доработано в: 3.12beta31 (добавлен параметр author_operator_id)

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

Доработано в: 3.12.38 (добавлены параметры unit_id, division_id)

Описание: Создание задания

Обязательные параметры:
 work_typer - ID ТИПА задания
 work_datedo - дата на которую назначено выполнение задания

Необязательные параметры:
 author_operator_id - ID оператора-автора задания
 usercode - ID абонента
 uzelcode - ID узла связи/муфты/опоры/колодца
 housecode - ID дома. Если не указан, то берётся из данных по абоненту - usercode, либо из данных по узлу связи - uzelcode
 citycode - ID населенного пункта. Если не указан, то берётся из данных по дому housecode
 apart - номер квартиры
 fio - ФИО клиента (имеется в виду, что "клиент" еще не является абонентом)
 opis - заметки к заданию
 dopf_N - значение дополнительного поля для поля ID N
 work_amount - объем работ
 unit_id - ID исполнителя (допускается несколько значений через запятую)
 division_id - ID подразделения (допускается несколько значений через запятую)

change_state

Описание: Изменения состояния (статуса) задания

Обязательные параметры:
 id - id задания
 state_id - id состояния задания
Необязательные параметры:
 operator_id - id оператора, от имени которого изменять состояние

check_verify_code

Описание: Проверка кода подтверждения для выполнения заявки

Обязательные параметры:
 id - ID задания
 verify_code - код подтверждения

comment_add

Описание: Добавление комментария

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

get_catalog_type

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

Описание: Классификатор заданий

Необязательные параметры:
 id - ID типа заданий (можно через запятую)

get_catalog_state

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

Описание: Классификатор состояний заданий

Необязательные параметры:
 state_id - ID состояния (можно через запятую)

get_list

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

Доработано в: 3.12.24 (добавлены параметры date_do_from, date_do_to)

Доработано в: 3.12beta29 (добавлен параметр house_id)

Описание: Список заданий (идентификаторы)

Необязательные параметры (условия выборки):
 customer_id - ID абонента (можно через запятую)
 date_add_from - дата создания задания (с)
 date_add_to - дата создания задания (до)
 date_do_from - дата на которую назначено выполнение задания (с)
 date_do_to - дата на которую назначено выполнение задания (до)
 date_finish_from - дата выполнения задания (с)
 date_finish_to - дата выполнения задания (до)
 division_id - ID подразделения (можно через запятую)
 house_id - ID дома работ
 staff_id - ID исполнителя (можно через запятую)
 state_id - ID статуса заданий (можно через запятую)
 type_id - ID типа заданий (можно через запятую)

get_related_task_id

Описание: Список связанных заданий с текущим заданием (идентификаторы)

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

set_rate

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

Описание: Указание индивидуального тарифа (для сотрудников) по заданию

Обязательные параметры:
 task_id - ID задания
 rate - тариф

show

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

Описание: Информация о задании

Обязательные параметры:
 id - ID задания
Необязательные параметры:
 operator_id - ID оператора, который просматривает это задание (для фиксации в историю по заданию)