ipr.point.set

Scope: ipr

Кто может вызывать: Руководитель карточки (CUR_MANAGER) — оценку руководителя; владелец карточки в статусе WORK — самооценку; администратор — любую роль в любом статусе. Подробнее: Модель доступа

Ставит оценку компетенции в карточке ИПР от имени сотрудника или руководителя. Роль определяется по карточке; администратор обязан указать role.

HTTP: POST

Побочные эффекты: Каждый вызов без pointId создаёт новую запись (история оценок). Автор записи — CUR_MANAGER карточки (роль manager) или сотрудник (роль employee), в том числе когда вызывает администратор: ФИО в комментарии, отправитель IM и автор записи журнала компетенций — он же.

  • Роль manager: фиксируется дата оценки (date или текущая), сотруднику уходит IM-уведомление, обновляется статус компетенции в ИПР; при последних оценках p2/p3 компетенция добавляется сотруднику (UF_COMPETENTIES) с записью в журнал (источник — ИПР, дата записи — текущая).
  • Роль employee: IM-уведомление руководителям.
  • date для новой записи сдвигает и дату её создания.

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

Параметр Тип Обяз. Описание
iprCompetencyId int да ID компетенции в карточке ИПР
point string да Оценка: p0, p1, p2, p3
comment string да Комментарий
role string условно employee или manager. Для администратора обязателен; для остальных выводится из карточки, несовпадающее значение — PERMISSION_DENIED
pointId int нет ID существующей записи этой компетенции — обновить её вместо создания новой
date string нет Только администратор. YYYY-MM-DD или YYYY-MM-DD HH:MM:SS, не в будущем
notify bool нет По умолчанию true. Значение false (без IM-уведомлений) — только администратор

Для идемпотентных повторов сохраняйте id из ответа и передавайте его как pointId либо ищите запись через ipr.point.list: иначе повторный вызов добавит ещё одну запись.

Возвращаемые данные

Запись оценки в форме элемента ipr.point.list плюс поле competencyStatus — текущий статус компетенции в карточке ИПР (NOT_RECEIVED, AWAITING_EVALUATION, RECEIVED).

Обработка ошибок

Справочник кодов: error-codes.md.

Код Описание
UNAUTHORIZED Пользователь не авторизован
VALIDATION_ERROR Некорректные point, role, comment, pointId, date; для администратора не указан role. В error.details.reason: point_excess_locked (руководитель уже поставил p3 — самооценка закрыта), comment_required, point, role, point_id
NOT_FOUND Компетенция в ИПР или карточка не найдены / недоступны
PERMISSION_DENIED Нет прав ставить оценку в этой роли; date / notify=false от не-администратора
INTERNAL_ERROR Внутренняя ошибка сервера

Пример запроса (POST)

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/ipr.point.set.json"
          -H "Content-Type: application/json"
          -H "Accept: application/json"
          --data '{
          "iprCompetencyId": 9101,
          "point": "p2",
          "comment": "Уверенно применяет на практике",
          "role": "manager"
        }'

Пример ответа

{
          "result": {
            "result": {
              "id": 7001,
              "iprId": 4201,
              "iprCompetencyId": 9101,
              "dateCreate": "2026-10-12 12:00:00",
              "createdBy": 8,
              "employeePoint": null,
              "employeeComment": "",
              "managerPoint": "p2",
              "managerComment": "Иван Петров: Уверенно применяет на практике",
              "managerDate": "2026-10-12 12:00:00",
              "competencyStatus": "RECEIVED"
            },
            "total": null,
            "next": null,
            "error": null
          }
        }

См. также

Предыдущая
ipr.point.list
Следующая
Обзор раздела