API task EN
Section API ERP "UserSide"
Purpose: Working with tasks
Additional parameters: action - request subcategory (possible value: see below)
Subcategories
add
Modified in: 3.18.29 (added deadline_hour parameter)
Modified in: 3.17dev1 (removed usercode, uzelcode parameters and added customer_id, node_id parameters)
Modified in: 3.16dev2 (removed unit_id, author_operator_id parameters and added employee_id, author_employee_id parameters)
Modified in: 3.12.84 (added parent_task_id parameter)
Modified in: 3.12.38 (added unit_id, division_id parameters)
Modified in: 3.12.26 (added work_amount parameter)
Modified in: 3.12beta31 (added author_operator_id parameter)
Description: Task creation Obligatory parameters: work_datedo - date on which the task is scheduled to run work_typer - task TYPE ID Optional parameters: apart - flat number address_id - (for version 3.13 and later) address unit id author_employee_id - ID of the employee author of the task author_operator_id - task author operator ID (before version 3.16dev2) citycode - (for version 3.12 and earlier) the id of the location. If not specified, it is taken from the housecode data. customer_id - (for version 3.17 and later) user ID deadline_hour - time to complete the task (from the date of acceptance. In hours) division_id - division ID (multiple values separated by commas are allowed) dopf_N - value of additional field for field ID N employee_id - employee ID (several values separated by commas are allowed) fio - client's full name (meaning that 'client' is not yet a user) housecode - (for version 3.12 and earlier) the building id. If not specified, it is taken from the user data - customer_id, or from the communication facility data - node_id node_id - (for version 3.17 and later) communication facility ID opis - task notes parent_task_id - ID of parent task unit_id - ID of executor (multiple values separated by commas are allowed) (up to version 3.16dev2) usercode - (for version 3.16 and earlier) user ID uzelcode - (for version 3.16 and earlier) ID of communication facility work_amount - scope of work
add_customer_to_task
Added in: 3.13.70
Description: Add a user to a task Required parameters: task_id - task id customer_id - id of customer
add_device_to_task
Added in: 3.19beta1
Description: Add equipment to a task Obligatory parameters: task_id - task id device_id - equipment id
change_date_work
Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)
Added in: 3.12.83
Description: Change the date and time of the task (date on which the work is scheduled) Obligatory parameters: id - id of the task value - date Optional parameters: employee_id - id of the initiating employee (to be recorded in the task history) operator_id - id of the initiator operator (to be recorded in the task history) (before version 3.16dev2)
change_state
Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)
Description: Changing the state (status) of a task Obligatory parameters: id - id of the task state_id - task state id Optional parameters: employee_id - id of the employee on whose behalf to change the state operator_id - id of the operator on whose behalf to change the state (before version 3.16dev2)
check_verify_code
Description: Checks the verification code to perform the request Obligatory parameters: id - task ID verify_code - verification code
checklist_item_check
Added in: 3.17dev1
Description: Marks a checklist item in a task Obligatory parameters: id - id of checklist item task_id - task id employee_id - id of the employee on whose behalf the item is marked
checklist_item_uncheck
Added in: 3.17dev1
Description: Uncheck a checklist item in a task Required parameters: id - id of checklist item task_id - task id
comment_add
Modified in: 3.17dev1 (added dateadd parameter)
Modified in: 3.16.19 (added reply_comment_id parameter)
Modified in: 3.16dev2 (removed operator_id parameter, added employee_id parameter)
Modified in: 3.12.89 (added author_operator_id parameter)
Description: Add comment Obligatory parameters: id - task ID comment - text Optional parameters: dateadd - date-time of the comment employee_id - id of the employee on whose behalf the comment is made operator_id - id of the operator on whose behalf the comment is (before version 3.16dev2) reply_comment_id - id of the comment we are replying to
comment_edit
Added in: 3.18beta1
Description: Edit comment Obligatory parameters: id - comment ID task_id - task ID body - text
delete
Added in: 3.14.35
Description: Deleting a task Obligatory parameters: id - id of the task
division_add
Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)
Added in: 3.13.36
Description: Adding a division Mandatory parameters: id - task id division_id - id of division Optional parameters: employee_id - id of the initiating employee (to be recorded in the history by the task) operator_id - id of the initiator operator (to be recorded in the task history) (before version 3.16dev2)
division_delete
Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)
Added in: 3.13.36
Description: Exclusion of division Obligatory parameters: id - task id division_id - id of division Optional parameters: employee_id - id of the initiating employee (to be recorded in the task history) operator_id - id of the initiator operator (to be recorded in the task history) (before version 3.16dev2)
edit
Modified in: 3.18.30 (added deadline_hour parameter)
Modified in: 3.18beta1 (added address_id parameter)
Modified in: 3.16dev3 (added type_id parameter)
Modified in: 3.15.12 (added parent_task_id parameter)
Added in: 3.13.18
Description: Task modification Obligatory parameters: id - task id Optional parameters: address_id - id of the address unit body - text of the task (descriptive part) deadline_hour - time to complete the task (from the date of acceptance. In hours) parent_task_id - id of parent task type_id - id of the task type
employee_add
Added in: 3.16dev2
Description: Adding an employee Obligatory parameters: id - task id employee_id - employee id Optional parameters: author_employee_id - id of the initiating employee (to commit to history by task)
employee_delete
Added in: 3.16dev2
Description: Exclude employee Obligatory parameters: id - task id employee_id - employee id Optional parameters: author_employee_id - id of the initiating employee (to commit to the history by task)
get_allow_staff
Added in: 3.15.23
Description: List of performers and divisions that are available for assignment to a task (according to settings)' Obligatory parameters: id - task id
get_catalog_type
Added in: 3.12.22
Description: Task types Optional parameters: id - job type id (can be comma separated)
get_catalog_type_group
Added in: 3.16dev3
Description: Task type groups
get_catalog_state
Added in: 3.12.22
Description: Task state classifier Optional parameters: state_id - state id (can be comma separated)
get_comment
Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)
Modified in: 3.14.67 (added id parameter)
Modified in: 3.14.53 (added operator_id parameter)
Modified in: 3.13.50 (added date_add_from and date_add_to parameters)
Added in: 3.12.75
Description: Comments Optional parameters (but there must be at least one): id - id of comment (can be comma separated) task_id - id of tasks (can be comma separated) date_add_from - date of adding comment (from) date_add_to - date of adding a comment (to) employee_id - id of the employee-author of the comment operator_id - id of operator-author of the comment (before version 3.16dev2)
get_list
Modified in: 3.18.30 (added parameters change_operation_type, change_employee_id)
Modified in: 3.18beta1 (added address_id parameter)
Modified in: 3.16dev3 (added task_position, task_position_radius parameters, excluded possible customer_id and house_id values from order_by parameter)
Modified in: 3.16dev2 (removed parameters closer_operator_id, staff_id, author_id, watcher_id, added parameters closer_employee_id, employee_id, author_employee_id, watcher_employee_id)
Modified in: 3.15.23 (added is_expired parameter)
Modified in: 3.14.71 (added node_id parameter)
Modified in: 3.14.62 (added closer_operator_id parameter)
Modified in: 3.14.56 (added division_id_with_staff parameter)
Modified in: 3.14.41 (added possible value -1 to staff_id parameter)
Modified in: 3.13.29 (added date_change_from, date_change_to parameters)
Modified in: 3.13.28 (added date_change to order_by parameter)
Modified in: 3.12.91 (added watcher_id parameter)
Modified at: 3.12.83 (added author_id parameter)
Modified at: 3.12.78 (added order_by, limit, offset parameters)
Modified at: 3.12.62 (added customer_id parameter)
Modified in: 3.12.24 (added date_do_from, date_do_to parameters)
Modified in: 3.12beta29 (added house_id parameter)
Description: List of tasks (identifiers) Optional parameters (sampling conditions): address_id - ID of the address object (can be comma separated) author_id - ID of operator - task author (comma separated) (up to version 3.16dev2) author_employee_id - ID of the employee - author of the task (can be comma separated)' change_employee_id - ID of the employee - author of the task changes change_operation_type - type of actions to change the task (possible values: add_comment, change_state) closer_employee_id - ID of the employee who closed (completed) the task (can be comma separated)' closer_operator_id - ID of the operator who closed the (completed) task (can be comma separated) (before version 3.16dev2) customer_id - ID of the user (can be comma separated) date_add_from - task creation date (from) date_add_to - task creation date (to) date_change_from - task update date (from) date_change_to - task update date (to) date_do_from - date on which the task is scheduled to be executed (from) date_do_to - date on which the task is scheduled to be executed (to) date_finish_from - date on which the task is executed (from) date_finish_to - date on which the task is executed (to) division_id - division ID (can be comma separated) division_id_with_staff - division ID (including tasks of employees of this division) (can be comma separated) employee_id - employee ID (can be comma separated, use -1 to get tasks without employees) house_id - ID of the work house is_expired - flag - output only expired tasks node_id - ID of the location object staff_id - ID of executor (can be comma separated, use -1 to get tasks without executors) (up to version 3.16dev2) state_id - task status ID (can be comma separated) task_position - task coordinates (where possible. In lat,lng format. e.g. 40.245218,52.333384) task_position_radius - radius from task_position (in meters) type_id - task type ID (can be comma separated) watcher_id - task observer operator ID (comma separated) (up to version 3.16dev2) watcher_employee_id - ID of the task observer employee (comma separated) order_by - sorting field (possible variants: date_add, date_change, date_do, date_finish, state_id, type_id) limit - record sampling limit offset - sampling offset
Description: List of related tasks to the current task (identifiers) Obligatory parameters: id - task ID
get_typical_comments
Added in: 3.14.70
Description: Get list of typical comments
remove_customer_from_task
Added in: 3.15.23
Description: Excludes a user from a task Obligatory parameters: task_id - task id customer_id - id of user
set_rate
Added in: 3.12.63
Description: Specifies the individual rate (for employees) for the task Obligatory parameters: task_id - task ID rate - rate
show
Modified in: 3.16dev2 (excluded operator_id parameter, added employee_id parameter)
Modified in: 3.13.29 (the id parameter can be a comma separated list)
Modified in: 3.13.25 (added is_without_comments parameter)
Modified in: 3.12.64 (added operator_id parameter)
Description: Information about the task Obligatory parameters: id - task id (can be comma separated) Optional parameters: employee_id - id of the employee who is viewing this task (to be recorded in the history by task) is_without_comments - flag - do not display comments in the task information operator_id - id of the operator who is viewing this task (to be recorded in the task history) (before version 3.16dev2)
(*) staff_add
Deprecated in: 3.16dev2 (use API->task->employee_add)
Added in: 3.12.83
Description: Adding an executor Obligatory parameters: id - task id staff_id - id of the executor Optional parameters: operator_id - id of the initiating operator (to be recorded in the history by the task)
(*) staff_delete
Deprecated in: 3.16dev2 (use API->task->employee_delete)
Added in: 3.12.83
Description: Exclude an executor Obligatory parameters: id - task id staff_id - id of the executor Optional parameters: operator_id - id of the initiating operator (to be recorded in the job history)
watcher_add
Modified in: 3.16dev2 (removed staff_id, operator_id parameters, added employee_id, author_employee_id parameters)
Added in: 3.14.21
Description: Add observer Obligatory parameters: id - task id employee_id - id of observer staff_id - observer id (before 3.16dev2) Optional parameters: author_employee_id - id of the initiating employee (to be recorded in the job history) operator_id - id of the initiating operator (to be recorded in the job history) (before version 3.16dev2)
watcher_delete
Modified in: 3.16dev2 (removed staff_id, operator_id parameters, added employee_id, author_employee_id parameters)
Added in: 3.14.21
Description: Exclusion of observer Obligatory parameters: id - task id employee_id - id of observer staff_id - observer id (before 3.16dev2) Optional parameters: author_employee_id - id of the initiating employee (to be recorded in the job history) operator_id - id of the initiating operator (to be recorded in the job history) (before version 3.16dev2)