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

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


==== get_list ====
==== get_list ====
''Доработано в: 3.12beta29 (добавлен параметр address_id)''
''Доработано в: 3.12beta29 (добавлен параметр house_id)''
  Описание: Список заданий (идентификаторы)
  Описание: Список заданий (идентификаторы)
   
   

Версия от 13:55, 15 января 2018

Раздел API ERP "UserSide"

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

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

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

add

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

Обязательные параметры:
 work_typer - ID ТИПА задания (tbl_conf_journal.TYPER)
 work_datedo - дата на которую назначено выполнение задания (в формате ГГГГ-ММ-ДД чч:мм:сс)

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

change_state

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

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

check_verify_code

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

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

comment_add

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

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

get_related_task_id

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

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

get_list

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

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

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

show

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

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