Сущность.Метод: request.update
Метод изменяет заявку. В fields передаются только те поля, которые нужно изменить.
| Ключ | Описание | Обяз. |
|---|---|---|
| id | ИД заявки | Да |
| fields | Изменяемые поля заявки. Чтобы поменять только чеклист или дополнительные поля, передайте пустой объект | Да |
| checklist | Полный список пунктов чеклиста. Если параметр не передан, чеклист не меняется. Пустой массив удаляет все пункты | Нет |
| entityFields | Дополнительные поля. Пары код / значение. Если параметр не передан, дополнительные поля не меняются | Нет |
Объект полей заявки (fields)
| Ключ | Описание | Обяз. |
|---|---|---|
| name | Название. Пустое значение не принимается | Нет |
| description | Описание | Нет |
| equipment_id | ИД оборудования | Нет* |
| equipment_external_code | Внешний код оборудования. По нему находится оборудование клиента, в заявку записывается его ИД | Нет* |
| responsible_department_id | ИД подразделения исполнителя. Пустое значение не принимается. Смена подразделения без нового исполнителя снимает исполнителя и переводит заявку в статус новой | Нет |
| responsible_user_id | ИД исполнителя. Назначение исполнителя, когда его ещё не было, переводит заявку в статус «исполнитель назначен» | Нет |
| type_id | ИД типа заявки. Пустое значение не принимается | Нет |
| priority_id | ИД приоритета | Нет |
| sla_level_id | ИД уровня SLA | Нет |
| start_date_plan | Планируемая дата начала, дд.мм.гггг чч:мм:сс | Нет |
| end_date_plan | Планируемая дата завершения, дд.мм.гггг чч:мм:сс | Нет |
| duration_plan | Плановое время в виде часы:минуты, например 02:30 | Нет |
| report_required | Требуется отчёт при завершении: Y или N | Нет |
* может быть задан либо equipment_id, либо equipment_external_code. Оборудование должно принадлежать клиенту.
Объект пункта чеклиста (checklist)
Переданный список полностью заменяет чеклист. Пункты, которых нет в списке, удаляются. Пункт без id или с id, в котором есть new, создаётся. Остальные пункты обновляются.
| Ключ | Описание | Обяз. |
|---|---|---|
| id | ИД пункта. Для нового пункта не передаётся или содержит new | Нет |
| name | Название. Пункт с пустым названием пропускается | Да |
| type | Тип: TEXT — комментарий, PHOTO — фото, NUMBER — значение, CHECKBOX — да/нет. Если не передан, используется TEXT | Нет |
| options | Дополнительные настройки. Для пункта PHOTO поле disable_gallery со значением Y отключает выбор фото из галереи. Для существующего пункта настройки меняются, только если options передан | Нет |
| code | Символьный код | Нет |
Объект дополнительных полей (entityFields)
Пары код / значение. Набор полей зависит от типа заявки и настраивается в интерфейсе администрирования. Файловое поле передаётся как multipart, имя поля — entityFields.
Пример:
{
"id": 15,
"fields": {
"name": "Замена оборудования",
"responsible_user_id": 42,
"duration_plan": "02:30"
},
"checklist": [
{
"id": "new1",
"name": "Проверка",
"type": "CHECKBOX"
}
]
}| Ключ | Описание | Обяз. |
|---|---|---|
| id | ИД заявки | Да |