ipr.ipr.complete

Scope: ipr

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

Завершает работу над планом. Карточка должна быть в статусе WORK.

Если вызывает сам сотрудник — карточка переходит в SOGL_RES (результат отправлен на согласование руководителю).
Если вызывает руководитель, HR или админ — карточка сразу переходит в FINISHED, и автоматически может быть создана новая программа по правилу «следующий шаблон» (nextTemplateId).

HTTP: POST

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

Администратор, руководитель или HR (WORK → FINISHED): останавливает бизнес-процесс (БП) карточки (как кнопка завершения в интерфейсе), чтобы он не перезаписал фактическую дату завершения; фиксирует фактическую дату завершения и может запускать создание следующей программы. Если остановка не удалась (INTERNAL_ERROR), повторный complete вернёт VALIDATION_ERROR (карточка уже не в WORK); остановку довершает повтор ipr.ipr.update со status=FINISHED.
Сотрудник (WORK → SOGL_RES): БП не затрагивается, как при завершении из интерфейса. Кнопка «Завершение» в БП остаётся — это штатный путь приёмки результата руководителем.

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

Параметр	Тип	Обяз.	Описание
`id`	`int`	да	ID карточки

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

Полная карточка — та же форма, что у ipr.ipr.get, с обновлённым status.

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

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

Код	Описание
`UNAUTHORIZED`	Пользователь не авторизован
`VALIDATION_ERROR`	`id` некорректен, либо карточка не в статусе `WORK`
`NOT_FOUND`	Карточка не найдена
`PERMISSION_DENIED`	Нет прав завершать эту карточку
`INTERNAL_ERROR`	Внутренняя ошибка сервера; не удалось остановить бизнес-процесс (статус к этому моменту уже изменён)

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

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/ipr.ipr.complete.json"
          -H "Content-Type: application/json"
          -H "Accept: application/json"
          --data '{"id": 4201}'

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

{
          "result": {
            "result": {
              "id": 4201,
              "status": "SOGL_RES"
            },
            "total": null,
            "next": null,
            "error": null
          }
        }