ipr.ipr.reject

Scope: ipr

Кто может вызывать: Руководитель сотрудника карточки (canManageEmployee, не сам сотрудник) либо привилегированный (admin/hr). Подробнее: Роли и права доступа

Отклоняет план или результат, находящийся на согласовании (SOGL или SOGL_RES), и возвращает карточку в статус WORK.

HTTP: POST

Побочные эффекты: Изменяет статус карточки на WORK.

Параметры метода

Параметр Тип Обяз. Описание
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
          }
        }

См. также

Предыдущая
ipr.ipr.approve
Следующая
ipr.ipr.reopen