assessment360.assessment.approve
Scope:
assessment360Кто может вызывать: Группы запуска оценки / админ / HR или менеджер карточки в статусе
on_approval(canUseStartActions). См. Права доступа
Подтверждает запуск или изменения карточки оценки в статусе on_approval и создаёт респондентов.
HTTP: POST
Побочные эффекты: Изменяет состояние данных модуля assessment360.
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
id |
int |
да | Идентификатор карточки оценки |
Дополнительные параметры (опционально)
Метод принимает те же вложенные параметры запуска, что и assessment360.assessment.start. Если они переданы, используются вместо значений, сохранённых на карточке при создании черновика:
| Параметр | Описание |
|---|---|
userId, managerId, competentionsIds |
Оцениваемый, руководитель, список компетенций |
competentionAssessmentTypeList |
Карта охвата: all, employee_and_head, employee_and_head_and_subordinates, employee_and_head_and_colleagues (см. assessment.start) |
colleaguesIds, subordinatesIds |
Респонденты-коллеги и подчинённые |
crmContacts |
Внешние респонденты CRM |
activeTo / deadlineDate |
Дедлайн оценки |
emailMessageTemplate, smsMessageTemplate |
Шаблоны уведомлений |
questionsData |
Дополнительные вопросы на карточке |
tags / tagIds, newTag |
Теги (имена строками) |
Если competentionsIds не передан или пуст, опции берутся из полей карточки. Подробные схемы вложенных объектов — в разделах «Структура …» документа assessment360.assessment.start.
Возвращаемые данные
Объект с полями id, status — идентификатор карточки и код статуса после согласования.
Допустимые xmlId статусов — см. assessment360.assessment.status.list.
Ответ в конверте модуля: result.result, result.error.
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
VALIDATION_ERROR |
Ошибка валидации входных параметров |
ASSESSMENT_NOT_FOUND |
Карточка оценки не найдена |
ASSESSMENT_WRONG_STATUS |
Операция недопустима для текущего статуса оценки |
PERMISSION_DENIED |
Недостаточно прав для согласования оценки |
Пример запроса (POST)
curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/assessment360.assessment.approve.json"
-H "Content-Type: application/json"
-H "Accept: application/json"
--data '{
"id": 214
}'
Пример ответа
{
"result": {
"result": {
"id": 1301,
"status": "assessment_collection"
},
"error": null
}
}