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

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


==== staff_delete ====
==== staff_delete ====
''Исключено в: 3.16dev2 (используйте API->task->[[API task#employee_delete|employee_delete]])''
''Добавлено в: 3.12.83''
''Добавлено в: 3.12.83''



Версия от 20:50, 23 февраля 2021

Раздел API ERP "UserSide"

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

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

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

add

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

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

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

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

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

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

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

add_customer_to_task

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

Описание: Добавление абонента к заданию

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

change_date_work

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

Описание: Изменение даты и времени выполнения задания (дата, на которую назначены работы)

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

change_state

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

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

check_verify_code

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

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

comment_add

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

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

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

delete

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

Описание: Удаление задания

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

division_add

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

Описание: Добавление подразделения

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

division_delete

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

Описание: Исключение подразделения

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

edit

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

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

Описание: Изменение задания

Обязательные параметры:
 id - id задания
Необязательные параметры:
 body - текст задания (описательная часть)
 parent_task_id - id родительского задания

get_allow_staff

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

Описание: Список исполнителей и подразделений, которые доступны для назначение на задание (согласно настроек)

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

get_catalog_type

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

Описание: Типы заданий

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

get_catalog_state

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

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

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

get_comment

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

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

Доработано в: 3.13.50 (добавлены параметры date_add_from и date_add_to)

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

Описание: Комментарии

Необязательные параметры (но должен быть хотя-бы один):
 id - id комментария (можно через запятую)
 task_id - id заданий (можно через запятую)
 date_add_from - дата добавления комментария (с)
 date_add_to - дата добавления комментария (до)
 operator_id - id оператора - автора комментария

get_list

Доработано в: 3.16dev2 (исключены параметры closer_operator_id, staff_id, author_id, добавлены параметры closer_employee_id, employee_id, author_employee_id)

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

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

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

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

Доработано в: 3.14.41 (в параметр staff_id добавлено возможное значение -1)

Доработано в: 3.13.29 (добавлены параметры date_change_from, date_change_to)

Доработано в: 3.13.28 (в параметр order_by добавлен вариант date_change)

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

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

Доработано в: 3.12.78 (добавлены параметры order_by, limit, offset)

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

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

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

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

Необязательные параметры (условия выборки):
 author_id - ID оператора - автора задания (можно через запятую) (до версии 3.16dev2)
 author_employee_id - ID сотрудника - автора задания (можно через запятую)
 closer_employee_id - ID сотрудника, который закрыл (выполнил) задание (можно через запятую)
 closer_operator_id - ID оператора, который закрыл (выполнил) задание (можно через запятую) (до версии 3.16dev2)
 customer_id - ID абонента (можно через запятую)
 date_add_from - дата создания задания (с)
 date_add_to - дата создания задания (до)
 date_change_from - дата обновления задания (с)
 date_change_to - дата обновления задания (до)
 date_do_from - дата на которую назначено выполнение задания (с)
 date_do_to - дата на которую назначено выполнение задания (до)
 date_finish_from - дата выполнения задания (с)
 date_finish_to - дата выполнения задания (до)
 division_id - ID подразделения (можно через запятую)
 division_id_with_staff - ID подразделения (в т.ч. с заданиями сотрудников этого подразделения) (можно через запятую)
 employee_id - ID исполнителя (можно через запятую, используйте -1 для получения заданий без исполнителей)
 house_id - ID дома работ
 is_expired - флаг - выводить только просроченные задания
 node_id - ID объекта размещения
 staff_id - ID исполнителя (можно через запятую, используйте -1 для получения заданий без исполнителей) (до версии 3.16dev2)
 state_id - ID статуса заданий (можно через запятую)
 type_id - ID типа заданий (можно через запятую)
 watcher_id - ID оператора - наблюдателя за заданием (можно через запятую)
 order_by - поле для сортировки (возможные варианты: customer_id, date_add, date_change, date_do, date_finish, house_id, state_id, type_id)
 limit - лимит выборки записей
 offset - смещение выборки

get_related_task_id

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

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

get_typical_comments

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

Описание: Получение списка типовых комментариев

remove_customer_from_task

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

Описание: Исключение абонента с задания

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

set_rate

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

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

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

show

Доработано в: 3.13.29 (в параметре id можно подавать список через запятую)

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

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

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

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

(*) staff_add

Исключено в: 3.16dev2 (используйте API->task->employee_add)

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

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

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

staff_delete

Исключено в: 3.16dev2 (используйте API->task->employee_delete)

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

Описание: Исключение исполнителя

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

watcher_add

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

Описание: Добавление наблюдателя

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

watcher_delete

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

Описание: Исключение наблюдателя

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