API task UK: различия между версиями
IronBot (обсуждение | вклад) (Add Ukrainian API docs and trilingual API links) |
IronBot (обсуждение | вклад) (Fix Ukrainian API localization) |
||
| (не показано 5 промежуточных версий этого же участника) | |||
| Строка 1: | Строка 1: | ||
[[API_task_EN|en]] | '''uk''' | [[API task|ru]] | [[API_task_EN|en]] | '''uk''' | [[API task|ru]] | ||
Розділ '''[[API]]''' ERP "UserSide" | Розділ '''[[API_UK|API]]''' ERP "UserSide" | ||
Призначення: | Призначення: Робота із завданнями | ||
Додаткові параметри: | Додаткові параметри: | ||
| Строка 17: | Строка 17: | ||
''Доопрацьовано у: 3.18.29 (додано параметр deadline_hour)'' | ''Доопрацьовано у: 3.18.29 (додано параметр deadline_hour)'' | ||
''Доопрацьовано у: 3.17dev1 ( | ''Доопрацьовано у: 3.17dev1 (виключено параметри usercode, uzelcode і додано параметри customer_id, node_id)'' | ||
''Доопрацьовано у: 3.16dev2 ( | ''Доопрацьовано у: 3.16dev2 (виключено параметри unit_id, author_operator_id і додано параметри employee_id, author_employee_id)'' | ||
''Доопрацьовано у: 3.12.84 (додано параметр parent_task_id)'' | ''Доопрацьовано у: 3.12.84 (додано параметр parent_task_id)'' | ||
| Строка 29: | Строка 29: | ||
''Доопрацьовано у: 3.12beta31 (додано параметр author_operator_id)'' | ''Доопрацьовано у: 3.12beta31 (додано параметр author_operator_id)'' | ||
Опис: | Опис: Створення завдання | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
work_typer - ID | work_typer - ID типу завдання | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
apart - номер | apart - номер квартири | ||
address_id - ''(для | address_id - ''(для версії 3.13 і пізніше)'' id адресної одиниці | ||
author_employee_id - ID співробітника-автора завдання | author_employee_id - ID співробітника-автора завдання | ||
author_operator_id - ID оператора-автора завдання ''(до | author_operator_id - ID оператора-автора завдання ''(до версії 3.16dev2)'' | ||
citycode - ''(для | citycode - ''(для версії 3.12 і раніше)'' id населеного пункту. Якщо не вказано, то береться з даних за будинком housecode | ||
customer_id - ''(для | customer_id - ''(для версії 3.17 і пізніше)'' ID абонента | ||
deadline_hour - час на | deadline_hour - час на виконання завдання ''(від дати прийняття. У годинах)'' | ||
device_id - ID | device_id - ID обладнання | ||
division_id - ID | division_id - ID підрозділу ''(допускається кілька значень через кому)'' | ||
dopf_N - значення | dopf_N - значення додаткового поля для поля ID N | ||
employee_id - ID | employee_id - ID виконавця ''(допускається кілька значень через кому)'' | ||
fio - | fio - ПІБ клієнта ''(мається на увазі, що "клієнт" ще не є абонентом)'' | ||
housecode - ''(для | housecode - ''(для версії 3.12 і раніше)'' id будівлі. Якщо не вказано, то береться з даних за абонентом - customer_id, або з даних за об'єктом інфраструктури - node_id | ||
is_high_priority - прапорець - | is_high_priority - прапорець - високий пріоритет | ||
node_id - ''(для | node_id - ''(для версії 3.17 і пізніше)'' ID об'єкта інфраструктури | ||
opis - нотатки | opis - нотатки до завдання | ||
parent_task_id - ID | parent_task_id - ID батьківського завдання | ||
unit_id - ID | unit_id - ID виконавця ''(допускається кілька значень через кому) (до версії 3.16dev2)'' | ||
usercode - ''(для | usercode - ''(для версії 3.16 і раніше)'' ID абонента | ||
uzelcode - ''(для | uzelcode - ''(для версії 3.16 і раніше)'' ID об'єкта інфраструктури | ||
work_amount - | work_amount - обсяг робіт | ||
work_datedo - дата на | work_datedo - дата, на яку призначено виконання завдання | ||
==== add_cable_line_to_task ==== | ==== add_cable_line_to_task ==== | ||
''Додано у: 3.20.2'' | ''Додано у: 3.20.2'' | ||
Опис: Додавання | Опис: Додавання кабельної лінії до завдання | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
task_id - id завдання | task_id - id завдання | ||
cable_line_id - id | cable_line_id - id кабельної лінії | ||
==== add_customer_to_task ==== | ==== add_customer_to_task ==== | ||
''Додано у: 3.13.70'' | ''Додано у: 3.13.70'' | ||
Опис: Додавання абонента | Опис: Додавання абонента до завдання | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
| Строка 79: | Строка 79: | ||
''Додано у: 3.19beta1'' | ''Додано у: 3.19beta1'' | ||
Опис: Додавання | Опис: Додавання обладнання до завдання | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
task_id - id завдання | task_id - id завдання | ||
device_id - id | device_id - id обладнання | ||
==== add_node_to_task ==== | ==== add_node_to_task ==== | ||
''Додано у: 3.20.17'' | ''Додано у: 3.20.17'' | ||
Опис: Додавання об' | Опис: Додавання об'єкта інфраструктури до завдання | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
task_id - id завдання | task_id - id завдання | ||
node_id - id об' | node_id - id об'єкта інфраструктури | ||
==== add_owner_to_task ==== | ==== add_owner_to_task ==== | ||
''Додано у: 3.19.19'' | ''Додано у: 3.19.19'' | ||
Опис: Додавання власника | Опис: Додавання власника до завдання | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
| Строка 108: | Строка 108: | ||
''Додано у: 3.12.83'' | ''Додано у: 3.12.83'' | ||
Опис: Зміна | Опис: Зміна дати і часу виконання завдання ''(дата, на яку призначені роботи)'' | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
| Строка 114: | Строка 114: | ||
value - дата | value - дата | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
employee_id - id співробітника- | employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)'' | ||
operator_id - id оператора- | operator_id - id оператора-ініціатора ''(для фіксації в історії завдання) (до версії 3.16dev2)'' | ||
==== change_state ==== | ==== change_state ==== | ||
| Строка 122: | Строка 122: | ||
''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)'' | ''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)'' | ||
Опис: | Опис: Зміна стану (статусу) завдання | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id завдання | id - id завдання | ||
state_id - id | state_id - id стану завдання | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
employee_id - id співробітника, | employee_id - id співробітника, від імені якого змінювати стан | ||
operator_id - id оператора, | operator_id - id оператора, від імені якого змінювати стан ''(до версії 3.16dev2)'' | ||
date_hold - дата/час до | date_hold - дата/час, до якої відкласти завдання ''(під час переведення у статус з роллю "Відкладено")'' | ||
==== check_verify_code ==== | ==== check_verify_code ==== | ||
Опис: | Опис: Перевірка коду підтвердження для виконання заявки | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - ID завдання | id - ID завдання | ||
verify_code - код | verify_code - код підтвердження | ||
==== checklist_item_check ==== | ==== checklist_item_check ==== | ||
''Додано у: 3.17dev1'' | ''Додано у: 3.17dev1'' | ||
Опис: | Опис: Позначення пункту чек-листа в завданні | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id | id - id пункту чек-листа | ||
task_id - id завдання | task_id - id завдання | ||
employee_id - id співробітника, | employee_id - id співробітника, від імені якого позначається пункт | ||
==== checklist_item_uncheck ==== | ==== checklist_item_uncheck ==== | ||
''Додано у: 3.17dev1'' | ''Додано у: 3.17dev1'' | ||
Опис: | Опис: Зняття позначення з пункту чек-листа в завданні | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id | id - id пункту чек-листа | ||
task_id - id завдання | task_id - id завдання | ||
| Строка 167: | Строка 167: | ||
''Доопрацьовано у: 3.12.89 (додано параметр author_operator_id)'' | ''Доопрацьовано у: 3.12.89 (додано параметр author_operator_id)'' | ||
Опис: Додавання | Опис: Додавання коментаря | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
| Строка 173: | Строка 173: | ||
comment - текст | comment - текст | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
dateadd - дата | dateadd - дата й час коментаря | ||
employee_id - id співробітника, | employee_id - id співробітника, від імені якого додається коментар | ||
operator_id - id оператора, | operator_id - id оператора, від імені якого додається коментар ''(до версії 3.16dev2)'' | ||
reply_comment_id - id | reply_comment_id - id коментаря, на який відповідаємо | ||
==== comment_edit ==== | ==== comment_edit ==== | ||
| Строка 182: | Строка 182: | ||
''Додано у: 3.18beta1'' | ''Додано у: 3.18beta1'' | ||
Опис: Зміна | Опис: Зміна коментаря | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - ID | id - ID коментаря | ||
task_id - ID завдання | task_id - ID завдання | ||
body - текст | body - текст | ||
| Строка 202: | Строка 202: | ||
''Додано у: 3.13.36'' | ''Додано у: 3.13.36'' | ||
Опис: Додавання | Опис: Додавання підрозділу | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id завдання | id - id завдання | ||
division_id - id | division_id - id підрозділу | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
employee_id - id співробітника- | employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)'' | ||
operator_id - id оператора- | operator_id - id оператора-ініціатора ''(для фіксації в історії завдання) (до версії 3.16dev2)'' | ||
==== division_delete ==== | ==== division_delete ==== | ||
| Строка 216: | Строка 216: | ||
''Додано у: 3.13.36'' | ''Додано у: 3.13.36'' | ||
Опис: | Опис: Вилучення підрозділу | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id завдання | id - id завдання | ||
division_id - id | division_id - id підрозділу | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
employee_id - id співробітника- | employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)'' | ||
operator_id - id оператора- | operator_id - id оператора-ініціатора ''(для фіксації в історії завдання) (до версії 3.16dev2)'' | ||
==== edit ==== | ==== edit ==== | ||
| Строка 251: | Строка 251: | ||
id - id завдання | id - id завдання | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
address_id - id | address_id - id адресної одиниці | ||
apartment - номер | apartment - номер квартири | ||
author_employee_id - id співробітника - автора завдання | author_employee_id - id співробітника - автора завдання | ||
customer_name - | customer_name - довільне ім'я/назва клієнта ''(без прив'язки до абонента)'' | ||
body - текст завдання ''( | body - текст завдання ''(описова частина)'' | ||
deadline_hour - час на | deadline_hour - час на виконання завдання ''(від дати прийняття. У годинах)'' | ||
is_high_priority - прапорець - | is_high_priority - прапорець - високий пріоритет | ||
job_time_hour - час на | job_time_hour - час на виконання завдання ''(з дати початку робіт. У годинах)'' | ||
parent_task_id - id | parent_task_id - id батьківського завдання | ||
type_id - id | type_id - id типу завдання | ||
==== employee_add ==== | ==== employee_add ==== | ||
''Додано у: 3.16dev2'' | ''Додано у: 3.16dev2'' | ||
Опис: Додавання | Опис: Додавання виконавця | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id завдання | id - id завдання | ||
employee_id - id | employee_id - id виконавця | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
author_employee_id - id співробітника- | author_employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)'' | ||
==== employee_delete ==== | ==== employee_delete ==== | ||
''Додано у: 3.16dev2'' | ''Додано у: 3.16dev2'' | ||
Опис: | Опис: Вилучення виконавця | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id завдання | id - id завдання | ||
employee_id - id | employee_id - id виконавця | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
author_employee_id - id співробітника- | author_employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)'' | ||
==== get_allow_staff ==== | ==== get_allow_staff ==== | ||
''Додано у: 3.15.23'' | ''Додано у: 3.15.23'' | ||
Опис: Список | Опис: Список виконавців і підрозділів, які доступні для призначення на завдання ''(згідно з налаштуваннями)'' | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
| Строка 291: | Строка 291: | ||
==== get_catalog_type ==== | ==== get_catalog_type ==== | ||
''Додано у: 3.12.22'' | ''Додано у: 3.12.22'' | ||
Опис: | Опис: Типи завдань | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
id - id | id - id типу завдань ''(можна через кому)'' | ||
==== get_catalog_type_group ==== | ==== get_catalog_type_group ==== | ||
''Додано у: 3.16dev3'' | ''Додано у: 3.16dev3'' | ||
Опис: | Опис: Групи типів завдань | ||
==== get_catalog_state ==== | ==== get_catalog_state ==== | ||
| Строка 305: | Строка 305: | ||
''Додано у: 3.12.22'' | ''Додано у: 3.12.22'' | ||
Опис: | Опис: Класифікатор станів завдань | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
type_id - id | type_id - id типу завдання | ||
state_id - id | state_id - id стану ''(можна через кому)'' | ||
==== get_comment ==== | ==== get_comment ==== | ||
| Строка 318: | Строка 318: | ||
''Доопрацьовано у: 3.14.53 (додано параметр operator_id)'' | ''Доопрацьовано у: 3.14.53 (додано параметр operator_id)'' | ||
''Доопрацьовано у: 3.13.50 (додано параметри date_add_from | ''Доопрацьовано у: 3.13.50 (додано параметри date_add_from і date_add_to)'' | ||
''Додано у: 3.12.75'' | ''Додано у: 3.12.75'' | ||
Опис: | Опис: Коментарі | ||
Необов'язкові параметри ''( | Необов'язкові параметри ''(але має бути хоча б один)'': | ||
id - id | id - id коментаря ''(можна через кому)'' | ||
task_id - id | task_id - id завдання ''(можна через кому)'' | ||
date_add_from - дата | date_add_from - дата додавання коментаря ''(з)'' | ||
date_add_to - дата | date_add_to - дата додавання коментаря ''(до)'' | ||
employee_id - id співробітника-автора | employee_id - id співробітника-автора коментаря | ||
operator_id - id оператора-автора | operator_id - id оператора-автора коментаря ''(до версії 3.16dev2)'' | ||
==== get_list ==== | ==== get_list ==== | ||
| Строка 341: | Строка 341: | ||
''Доопрацьовано у: 3.18beta1 (додано параметр address_id)'' | ''Доопрацьовано у: 3.18beta1 (додано параметр address_id)'' | ||
''Доопрацьовано у: 3.16dev3 (додано параметри task_position, task_position_radius, | ''Доопрацьовано у: 3.16dev3 (додано параметри task_position, task_position_radius, з параметра order_by виключені можливі значення customer_id і house_id)'' | ||
''Доопрацьовано у: 3.16dev2 ( | ''Доопрацьовано у: 3.16dev2 (виключено параметри closer_operator_id, staff_id, author_id, watcher_id додано параметри closer_employee_id, employee_id, author_employee_id, watcher_employee_id)'' | ||
''Доопрацьовано у: 3.15.23 (додано параметр is_expired)'' | ''Доопрацьовано у: 3.15.23 (додано параметр is_expired)'' | ||
| Строка 353: | Строка 353: | ||
''Доопрацьовано у: 3.14.56 (додано параметр division_id_with_staff)'' | ''Доопрацьовано у: 3.14.56 (додано параметр division_id_with_staff)'' | ||
''Доопрацьовано у: 3.14.41 ( | ''Доопрацьовано у: 3.14.41 (до параметра staff_id додано можливе значення -1)'' | ||
''Доопрацьовано у: 3.13.29 (додано параметри date_change_from, date_change_to)'' | ''Доопрацьовано у: 3.13.29 (додано параметри date_change_from, date_change_to)'' | ||
''Доопрацьовано у: 3.13.28 ( | ''Доопрацьовано у: 3.13.28 (до параметра order_by додано варіант date_change)'' | ||
''Доопрацьовано у: 3.12.91 (додано параметр watcher_id)'' | ''Доопрацьовано у: 3.12.91 (додано параметр watcher_id)'' | ||
| Строка 370: | Строка 370: | ||
''Доопрацьовано у: 3.12beta29 (додано параметр house_id)'' | ''Доопрацьовано у: 3.12beta29 (додано параметр house_id)'' | ||
Опис: Список | Опис: Список завдань (ідентифікатори) | ||
Необов'язкові параметри ( | Необов'язкові параметри (умови вибірки): | ||
address_id - ID адресного об'єкта ''(можна через кому)'' | address_id - ID адресного об'єкта ''(можна через кому)'' | ||
apart - номер | apart - номер квартири/приміщення | ||
author_id - ID оператора - автора завдання ''(можна через кому) (до | author_id - ID оператора - автора завдання ''(можна через кому) (до версії 3.16dev2)'' | ||
author_employee_id - ID співробітника - автора завдання ''(можна через кому)'' | author_employee_id - ID співробітника - автора завдання ''(можна через кому)'' | ||
change_employee_id - ID співробітника - автора | change_employee_id - ID співробітника - автора змін за завданням | ||
change_operation_type - тип | change_operation_type - тип дій зі зміни завдання ''(можливі значення: add_comment, change_state)'' | ||
closer_employee_id - ID співробітника, | closer_employee_id - ID співробітника, який закрив ''(виконав)'' завдання ''(можна через кому)'' | ||
closer_operator_id - ID оператора, | closer_operator_id - ID оператора, який закрив ''(виконав)'' завдання ''(можна через кому) (до версії 3.16dev2)'' | ||
customer_id - ID абонента ''(можна через кому)'' | customer_id - ID абонента ''(можна через кому)'' | ||
date_add_from - дата | date_add_from - дата створення завдання (з) | ||
date_add_to - дата | date_add_to - дата створення завдання (до) | ||
date_change_from - дата | date_change_from - дата оновлення завдання (з) | ||
date_change_to - дата | date_change_to - дата оновлення завдання (до) | ||
date_do_from - дата на | date_do_from - дата, на яку призначено виконання завдання (з) | ||
date_do_to - дата на | date_do_to - дата, на яку призначено виконання завдання (до) | ||
date_finish_from - дата | date_finish_from - дата виконання завдання (з) | ||
date_finish_to - дата | date_finish_to - дата виконання завдання (до) | ||
device_id - ID | device_id - ID обладнання ''(можна через кому)'' | ||
division_id - ID | division_id - ID підрозділу ''(можна через кому)'' | ||
division_id_with_staff - ID | division_id_with_staff - ID підрозділу ''(зокрема із завданнями співробітників цього підрозділу) (можна через кому)'' | ||
employee_id - ID | employee_id - ID виконавця ''(можна через кому, використовуйте -1 для отримання завдань без виконавців)'' | ||
house_id - ID | house_id - ID будинку робіт | ||
is_expired - прапорець - | is_expired - прапорець - виводити тільки прострочені завдання | ||
node_id - ID об'єкта | node_id - ID об'єкта розміщення | ||
staff_id - ID | staff_id - ID виконавця ''(можна через кому, використовуйте -1 для отримання завдань без виконавців) (до версії 3.16dev2)'' | ||
state_id - ID | state_id - ID статусу завдань ''(можна через кому)'' | ||
task_position - координати завдання ''(там | task_position - координати завдання ''(там, де це можливо. У форматі lat,lng. Напр: 40.245218,52.333384)'' | ||
task_position_radius - радіус | task_position_radius - радіус від task_position ''(у метрах)'' | ||
type_id - ID | type_id - ID типу завдань ''(можна через кому)'' | ||
watcher_id - ID оператора- | watcher_id - ID оператора-спостерігача за завданням ''(можна через кому) (до версії 3.16dev2)'' | ||
watcher_employee_id - ID співробітника- | watcher_employee_id - ID співробітника-спостерігача за завданням ''(можна через кому)'' | ||
order_by - поле для | order_by - поле для сортування ''(можливі варіанти: date_add, date_change, date_do, date_finish, state_id, type_id)'' | ||
limit - | limit - ліміт вибірки записів | ||
offset - | offset - зміщення вибірки | ||
==== get_related_task_id==== | ==== get_related_task_id==== | ||
Опис: Список | Опис: Список пов'язаних завдань із поточним завданням (ідентифікатори) | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
| Строка 417: | Строка 417: | ||
''Додано у: 3.14.70'' | ''Додано у: 3.14.70'' | ||
Опис: Отримання | Опис: Отримання списку типових коментарів | ||
==== mark_add ==== | ==== mark_add ==== | ||
''Додано у: 3.19.24'' | ''Додано у: 3.19.24'' | ||
Опис: Додавання | Опис: Додавання мітки на завдання | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
task_id - id завдання | task_id - id завдання | ||
mark_id - id | mark_id - id мітки | ||
==== mark_delete ==== | ==== mark_delete ==== | ||
''Додано у: 3.19.24'' | ''Додано у: 3.19.24'' | ||
Опис: Видалення | Опис: Видалення мітки із завдання | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
task_id - id завдання | task_id - id завдання | ||
mark_id - id | mark_id - id мітки | ||
==== overview_task ==== | ==== overview_task ==== | ||
''Додано у: 3.19.7'' | ''Додано у: 3.19.7'' | ||
Опис: | Опис: Фіксація факту перегляду завдання співробітником | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
| Строка 445: | Строка 445: | ||
''Додано у: 3.20.2'' | ''Додано у: 3.20.2'' | ||
Опис: | Опис: Вилучення кабельної лінії із завдання | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
task_id - id завдання | task_id - id завдання | ||
cable_line_id - id | cable_line_id - id кабельної лінії | ||
==== remove_customer_from_task ==== | ==== remove_customer_from_task ==== | ||
''Додано у: 3.15.23'' | ''Додано у: 3.15.23'' | ||
Опис: | Опис: Вилучення абонента із завдання | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
| Строка 463: | Строка 463: | ||
''Додано у: 3.20.17'' | ''Додано у: 3.20.17'' | ||
Опис: | Опис: Вилучення об'єкта інфраструктури із завдання | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
task_id - id завдання | task_id - id завдання | ||
node_id - id об' | node_id - id об'єкта інфраструктури | ||
==== remove_owner_from_task ==== | ==== remove_owner_from_task ==== | ||
''Додано у: 3.19.19'' | ''Додано у: 3.19.19'' | ||
Опис: | Опис: Вилучення власника із завдання | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
| Строка 480: | Строка 480: | ||
==== set_rate ==== | ==== set_rate ==== | ||
''Додано у: 3.12.63'' | ''Додано у: 3.12.63'' | ||
Опис: | Опис: Вказання індивідуального тарифу ''(для співробітників)'' за завданням | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
| Строка 489: | Строка 489: | ||
''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)'' | ''Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)'' | ||
''Доопрацьовано у: 3.13.29 ( | ''Доопрацьовано у: 3.13.29 (у параметрі id можна подавати список через кому)'' | ||
''Доопрацьовано у: 3.13.25 (додано параметр is_without_comments)'' | ''Доопрацьовано у: 3.13.25 (додано параметр is_without_comments)'' | ||
| Строка 495: | Строка 495: | ||
''Доопрацьовано у: 3.12.64 (додано параметр operator_id)'' | ''Доопрацьовано у: 3.12.64 (додано параметр operator_id)'' | ||
Опис: | Опис: Інформація про завдання | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id завдання ''(можна через кому)'' | id - id завдання ''(можна через кому)'' | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
employee_id - id співробітника, | employee_id - id співробітника, який переглядає це завдання ''(для фіксації в історії завдання)'' | ||
is_without_comments - прапорець - не | is_without_comments - прапорець - не виводити коментарі в інформації за завданням | ||
operator_id - id оператора, | operator_id - id оператора, який переглядає це завдання ''(для фіксації в історії завдання) (до версії 3.16dev2)'' | ||
==== (*) staff_add ==== | ==== (*) staff_add ==== | ||
''Виключено у: 3.16dev2 ( | ''Виключено у: 3.16dev2 (використовуйте API->task->[[API_task_UK#employee_add|employee_add]])'' | ||
''Додано у: 3.12.83'' | ''Додано у: 3.12.83'' | ||
Опис: Додавання | Опис: Додавання виконавця | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id завдання | id - id завдання | ||
staff_id - id | staff_id - id виконавця | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
operator_id - id оператора- | operator_id - id оператора-ініціатора ''(для фіксації в історії завдання)'' | ||
==== (*) staff_delete ==== | ==== (*) staff_delete ==== | ||
''Виключено у: 3.16dev2 ( | ''Виключено у: 3.16dev2 (використовуйте API->task->[[API_task_UK#employee_delete|employee_delete]])'' | ||
''Додано у: 3.12.83'' | ''Додано у: 3.12.83'' | ||
Опис: | Опис: Вилучення виконавця | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id завдання | id - id завдання | ||
staff_id - id | staff_id - id виконавця | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
operator_id - id оператора- | operator_id - id оператора-ініціатора ''(для фіксації в історії завдання)'' | ||
==== watcher_add ==== | ==== watcher_add ==== | ||
''Доопрацьовано у: 3.16dev2 ( | ''Доопрацьовано у: 3.16dev2 (виключено параметри staff_id, operator_id, додано параметри employee_id, author_employee_id)'' | ||
''Додано у: 3.14.21'' | ''Додано у: 3.14.21'' | ||
Опис: Додавання | Опис: Додавання спостерігача | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id завдання | id - id завдання | ||
employee_id - id | employee_id - id спостерігача | ||
staff_id - id | staff_id - id спостерігача ''(до версії 3.16dev2)'' | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
author_employee_id - id співробітника- | author_employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)'' | ||
operator_id - id оператора- | operator_id - id оператора-ініціатора ''(для фіксації в історії завдання) (до версії 3.16dev2)'' | ||
==== watcher_delete ==== | ==== watcher_delete ==== | ||
''Доопрацьовано у: 3.16dev2 ( | ''Доопрацьовано у: 3.16dev2 (виключено параметри staff_id, operator_id, додано параметри employee_id, author_employee_id)'' | ||
''Додано у: 3.14.21'' | ''Додано у: 3.14.21'' | ||
Опис: | Опис: Вилучення спостерігача | ||
Обов'язкові параметри: | Обов'язкові параметри: | ||
id - id завдання | id - id завдання | ||
employee_id - id | employee_id - id спостерігача | ||
staff_id - id | staff_id - id спостерігача ''(до версії 3.16dev2)'' | ||
Необов'язкові параметри: | Необов'язкові параметри: | ||
author_employee_id - id співробітника- | author_employee_id - id співробітника-ініціатора ''(для фіксації в історії завдання)'' | ||
operator_id - id оператора- | operator_id - id оператора-ініціатора ''(для фіксації в історії завдання) (до версії 3.16dev2)'' | ||
Текущая версия от 11:19, 10 мая 2026
Розділ API ERP "UserSide"
Призначення: Робота із завданнями
Додаткові параметри: action - підкатегорія запиту (можливе значення: див. нижче)
Підкатегорії
add
Доопрацьовано у: 3.19.30 (додано параметр is_high_priority)
Доопрацьовано у: 3.18.43 (додано параметр device_id)
Доопрацьовано у: 3.18.29 (додано параметр deadline_hour)
Доопрацьовано у: 3.17dev1 (виключено параметри usercode, uzelcode і додано параметри customer_id, node_id)
Доопрацьовано у: 3.16dev2 (виключено параметри unit_id, author_operator_id і додано параметри employee_id, author_employee_id)
Доопрацьовано у: 3.12.84 (додано параметр parent_task_id)
Доопрацьовано у: 3.12.38 (додано параметри unit_id, division_id)
Доопрацьовано у: 3.12.26 (додано параметр work_amount)
Доопрацьовано у: 3.12beta31 (додано параметр author_operator_id)
Опис: Створення завдання Обов'язкові параметри: work_typer - ID типу завдання Необов'язкові параметри: apart - номер квартири address_id - (для версії 3.13 і пізніше) id адресної одиниці author_employee_id - ID співробітника-автора завдання author_operator_id - ID оператора-автора завдання (до версії 3.16dev2) citycode - (для версії 3.12 і раніше) id населеного пункту. Якщо не вказано, то береться з даних за будинком housecode customer_id - (для версії 3.17 і пізніше) ID абонента deadline_hour - час на виконання завдання (від дати прийняття. У годинах) device_id - ID обладнання division_id - ID підрозділу (допускається кілька значень через кому) dopf_N - значення додаткового поля для поля ID N employee_id - ID виконавця (допускається кілька значень через кому) fio - ПІБ клієнта (мається на увазі, що "клієнт" ще не є абонентом) housecode - (для версії 3.12 і раніше) id будівлі. Якщо не вказано, то береться з даних за абонентом - customer_id, або з даних за об'єктом інфраструктури - node_id is_high_priority - прапорець - високий пріоритет node_id - (для версії 3.17 і пізніше) ID об'єкта інфраструктури opis - нотатки до завдання parent_task_id - ID батьківського завдання unit_id - ID виконавця (допускається кілька значень через кому) (до версії 3.16dev2) usercode - (для версії 3.16 і раніше) ID абонента uzelcode - (для версії 3.16 і раніше) ID об'єкта інфраструктури work_amount - обсяг робіт work_datedo - дата, на яку призначено виконання завдання
add_cable_line_to_task
Додано у: 3.20.2
Опис: Додавання кабельної лінії до завдання Обов'язкові параметри: task_id - id завдання cable_line_id - id кабельної лінії
add_customer_to_task
Додано у: 3.13.70
Опис: Додавання абонента до завдання Обов'язкові параметри: task_id - id завдання customer_id - id абонента
add_device_to_task
Додано у: 3.19beta1
Опис: Додавання обладнання до завдання Обов'язкові параметри: task_id - id завдання device_id - id обладнання
add_node_to_task
Додано у: 3.20.17
Опис: Додавання об'єкта інфраструктури до завдання Обов'язкові параметри: task_id - id завдання node_id - id об'єкта інфраструктури
add_owner_to_task
Додано у: 3.19.19
Опис: Додавання власника до завдання Обов'язкові параметри: task_id - id завдання owner_id - id власника
change_date_work
Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)
Додано у: 3.12.83
Опис: Зміна дати і часу виконання завдання (дата, на яку призначені роботи) Обов'язкові параметри: id - id завдання value - дата Необов'язкові параметри: employee_id - id співробітника-ініціатора (для фіксації в історії завдання) operator_id - id оператора-ініціатора (для фіксації в історії завдання) (до версії 3.16dev2)
change_state
Доопрацьовано у: 3.20.3 (додано параметр date_hold)
Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)
Опис: Зміна стану (статусу) завдання Обов'язкові параметри: id - id завдання state_id - id стану завдання Необов'язкові параметри: employee_id - id співробітника, від імені якого змінювати стан operator_id - id оператора, від імені якого змінювати стан (до версії 3.16dev2) date_hold - дата/час, до якої відкласти завдання (під час переведення у статус з роллю "Відкладено")
check_verify_code
Опис: Перевірка коду підтвердження для виконання заявки Обов'язкові параметри: id - ID завдання verify_code - код підтвердження
checklist_item_check
Додано у: 3.17dev1
Опис: Позначення пункту чек-листа в завданні Обов'язкові параметри: id - id пункту чек-листа task_id - id завдання employee_id - id співробітника, від імені якого позначається пункт
checklist_item_uncheck
Додано у: 3.17dev1
Опис: Зняття позначення з пункту чек-листа в завданні Обов'язкові параметри: id - id пункту чек-листа task_id - id завдання
comment_add
Доопрацьовано у: 3.17dev1 (додано параметр dateadd)
Доопрацьовано у: 3.16.19 (додано параметр reply_comment_id)
Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)
Доопрацьовано у: 3.12.89 (додано параметр author_operator_id)
Опис: Додавання коментаря Обов'язкові параметри: id - ID завдання comment - текст Необов'язкові параметри: dateadd - дата й час коментаря employee_id - id співробітника, від імені якого додається коментар operator_id - id оператора, від імені якого додається коментар (до версії 3.16dev2) reply_comment_id - id коментаря, на який відповідаємо
comment_edit
Додано у: 3.18beta1
Опис: Зміна коментаря Обов'язкові параметри: id - ID коментаря task_id - ID завдання body - текст
delete
Додано у: 3.14.35
Опис: Видалення завдання Обов'язкові параметри: id - id завдання
division_add
Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)
Додано у: 3.13.36
Опис: Додавання підрозділу Обов'язкові параметри: id - id завдання division_id - id підрозділу Необов'язкові параметри: employee_id - id співробітника-ініціатора (для фіксації в історії завдання) operator_id - id оператора-ініціатора (для фіксації в історії завдання) (до версії 3.16dev2)
division_delete
Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)
Додано у: 3.13.36
Опис: Вилучення підрозділу Обов'язкові параметри: id - id завдання division_id - id підрозділу Необов'язкові параметри: employee_id - id співробітника-ініціатора (для фіксації в історії завдання) operator_id - id оператора-ініціатора (для фіксації в історії завдання) (до версії 3.16dev2)
edit
Доопрацьовано у: 3.20.23 (додано параметр customer_name)
Доопрацьовано у: 3.19.41 (додано параметр author_employee_id)
Доопрацьовано у: 3.19.30 (додано параметр is_high_priority)
Доопрацьовано у: 3.19.15 (додано параметр job_time_hour)
Доопрацьовано у: 3.19.12 (додано параметр apartment)
Доопрацьовано у: 3.18.30 (додано параметр deadline_hour)
Доопрацьовано у: 3.18beta1 (додано параметр address_id)
Доопрацьовано у: 3.16dev3 (додано параметр type_id)
Доопрацьовано у: 3.15.12 (додано параметр parent_task_id)
Додано у: 3.13.18
Опис: Зміна завдання Обов'язкові параметри: id - id завдання Необов'язкові параметри: address_id - id адресної одиниці apartment - номер квартири author_employee_id - id співробітника - автора завдання customer_name - довільне ім'я/назва клієнта (без прив'язки до абонента) body - текст завдання (описова частина) deadline_hour - час на виконання завдання (від дати прийняття. У годинах) is_high_priority - прапорець - високий пріоритет job_time_hour - час на виконання завдання (з дати початку робіт. У годинах) parent_task_id - id батьківського завдання type_id - id типу завдання
employee_add
Додано у: 3.16dev2
Опис: Додавання виконавця Обов'язкові параметри: id - id завдання employee_id - id виконавця Необов'язкові параметри: author_employee_id - id співробітника-ініціатора (для фіксації в історії завдання)
employee_delete
Додано у: 3.16dev2
Опис: Вилучення виконавця Обов'язкові параметри: id - id завдання employee_id - id виконавця Необов'язкові параметри: author_employee_id - id співробітника-ініціатора (для фіксації в історії завдання)
get_allow_staff
Додано у: 3.15.23
Опис: Список виконавців і підрозділів, які доступні для призначення на завдання (згідно з налаштуваннями) Обов'язкові параметри: id - id завдання
get_catalog_type
Додано у: 3.12.22
Опис: Типи завдань Необов'язкові параметри: id - id типу завдань (можна через кому)
get_catalog_type_group
Додано у: 3.16dev3
Опис: Групи типів завдань
get_catalog_state
Доопрацьовано у: 3.19.1 (додано параметр type_id)
Додано у: 3.12.22
Опис: Класифікатор станів завдань Необов'язкові параметри: type_id - id типу завдання state_id - id стану (можна через кому)
get_comment
Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)
Доопрацьовано у: 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 - дата додавання коментаря (до) employee_id - id співробітника-автора коментаря operator_id - id оператора-автора коментаря (до версії 3.16dev2)
get_list
Доопрацьовано у: 3.18.43 (додано параметр device_id)
Доопрацьовано у: 3.18.40 (додано параметр apart)
Доопрацьовано у: 3.18.30 (додано параметри change_operation_type, change_employee_id)
Доопрацьовано у: 3.18beta1 (додано параметр address_id)
Доопрацьовано у: 3.16dev3 (додано параметри task_position, task_position_radius, з параметра order_by виключені можливі значення customer_id і house_id)
Доопрацьовано у: 3.16dev2 (виключено параметри closer_operator_id, staff_id, author_id, watcher_id додано параметри closer_employee_id, employee_id, author_employee_id, watcher_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)
Опис: Список завдань (ідентифікатори) Необов'язкові параметри (умови вибірки): address_id - ID адресного об'єкта (можна через кому) apart - номер квартири/приміщення author_id - ID оператора - автора завдання (можна через кому) (до версії 3.16dev2) author_employee_id - ID співробітника - автора завдання (можна через кому) change_employee_id - ID співробітника - автора змін за завданням change_operation_type - тип дій зі зміни завдання (можливі значення: add_comment, change_state) 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 - дата виконання завдання (до) device_id - ID обладнання (можна через кому) 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 статусу завдань (можна через кому) task_position - координати завдання (там, де це можливо. У форматі lat,lng. Напр: 40.245218,52.333384) task_position_radius - радіус від task_position (у метрах) type_id - ID типу завдань (можна через кому) watcher_id - ID оператора-спостерігача за завданням (можна через кому) (до версії 3.16dev2) watcher_employee_id - ID співробітника-спостерігача за завданням (можна через кому) order_by - поле для сортування (можливі варіанти: date_add, date_change, date_do, date_finish, state_id, type_id) limit - ліміт вибірки записів offset - зміщення вибірки
Опис: Список пов'язаних завдань із поточним завданням (ідентифікатори) Обов'язкові параметри: id - ID завдання
get_typical_comments
Додано у: 3.14.70
Опис: Отримання списку типових коментарів
mark_add
Додано у: 3.19.24
Опис: Додавання мітки на завдання Обов'язкові параметри: task_id - id завдання mark_id - id мітки
mark_delete
Додано у: 3.19.24
Опис: Видалення мітки із завдання Обов'язкові параметри: task_id - id завдання mark_id - id мітки
overview_task
Додано у: 3.19.7
Опис: Фіксація факту перегляду завдання співробітником Обов'язкові параметри: task_id - id завдання employee_id - id співробітника
remove_cable_line_from_task
Додано у: 3.20.2
Опис: Вилучення кабельної лінії із завдання Обов'язкові параметри: task_id - id завдання cable_line_id - id кабельної лінії
remove_customer_from_task
Додано у: 3.15.23
Опис: Вилучення абонента із завдання Обов'язкові параметри: task_id - id завдання customer_id - id абонента
remove_node_from_task
Додано у: 3.20.17
Опис: Вилучення об'єкта інфраструктури із завдання Обов'язкові параметри: task_id - id завдання node_id - id об'єкта інфраструктури
remove_owner_from_task
Додано у: 3.19.19
Опис: Вилучення власника із завдання Обов'язкові параметри: task_id - id завдання owner_id - id власника
set_rate
Додано у: 3.12.63
Опис: Вказання індивідуального тарифу (для співробітників) за завданням Обов'язкові параметри: task_id - ID завдання rate - тариф
show
Доопрацьовано у: 3.16dev2 (виключено параметр operator_id, додано параметр employee_id)
Доопрацьовано у: 3.13.29 (у параметрі id можна подавати список через кому)
Доопрацьовано у: 3.13.25 (додано параметр is_without_comments)
Доопрацьовано у: 3.12.64 (додано параметр operator_id)
Опис: Інформація про завдання Обов'язкові параметри: id - id завдання (можна через кому) Необов'язкові параметри: employee_id - id співробітника, який переглядає це завдання (для фіксації в історії завдання) is_without_comments - прапорець - не виводити коментарі в інформації за завданням operator_id - id оператора, який переглядає це завдання (для фіксації в історії завдання) (до версії 3.16dev2)
(*) 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.16dev2 (виключено параметри staff_id, operator_id, додано параметри employee_id, author_employee_id)
Додано у: 3.14.21
Опис: Додавання спостерігача Обов'язкові параметри: id - id завдання employee_id - id спостерігача staff_id - id спостерігача (до версії 3.16dev2) Необов'язкові параметри: author_employee_id - id співробітника-ініціатора (для фіксації в історії завдання) operator_id - id оператора-ініціатора (для фіксації в історії завдання) (до версії 3.16dev2)
watcher_delete
Доопрацьовано у: 3.16dev2 (виключено параметри staff_id, operator_id, додано параметри employee_id, author_employee_id)
Додано у: 3.14.21
Опис: Вилучення спостерігача Обов'язкові параметри: id - id завдання employee_id - id спостерігача staff_id - id спостерігача (до версії 3.16dev2) Необов'язкові параметри: author_employee_id - id співробітника-ініціатора (для фіксації в історії завдання) operator_id - id оператора-ініціатора (для фіксації в історії завдання) (до версії 3.16dev2)