ipr.ipr.reject
Scope:
iprКто может вызывать: Руководитель сотрудника карточки (
canManageEmployee, не сам сотрудник) либо привилегированный (admin/hr). Подробнее: Роли и права доступа
Отклоняет план или результат, находящийся на согласовании (SOGL или SOGL_RES), и возвращает карточку в статус WORK.
HTTP: POST
Побочные эффекты: Изменяет статус карточки на WORK. Бизнес-процесс (БП) карточки не затрагивается: из SOGL_RES — как возврат в работу из интерфейса; из SOGL — тоже, но с расхождением: собственное событие БП «На доработку» переводит карточку в NEW, а REST возвращает её в WORK, поэтому событие не используется. БП остаётся в состоянии «На согласовании»; позже его кнопка «Согласовать» перезапишет startFact и поставит WORK, а «На доработку» переведёт карточку в NEW.
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
id |
int |
да | ID карточки |
comment |
string |
нет | Комментарий к отклонению (обрезается до 10000 символов, добавляется в ответ полем rejectComment; отдельно не сохраняется в истории) |
Возвращаемые данные
Полная карточка — та же форма, что у ipr.ipr.get, плюс:
| Поле | Тип | Описание |
|---|---|---|
rejectComment |
string |
Присутствует только если был передан непустой comment |
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
VALIDATION_ERROR |
Статус карточки не SOGL/SOGL_RES |
NOT_FOUND |
Карточка не найдена |
PERMISSION_DENIED |
Отклонять может только руководитель сотрудника, HR или админ |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
Пример запроса (POST)
curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/ipr.ipr.reject.json"
-H "Content-Type: application/json"
-H "Accept: application/json"
--data '{"id": 4201, "comment": "Дополните результат по курсу"}'
Пример ответа
{
"result": {
"result": {
"id": 4201,
"status": "WORK",
"rejectComment": "Дополните результат по курсу"
},
"total": null,
"next": null,
"error": null
}
}