goalsmanagement.goalcard.create
Scope:
goalsmanagementКто может вызывать: Админ модуля / админ / руководитель (isHead). Подробнее: Права доступа
Создать карточку целей для сотрудника отдела. У сотрудника может быть только одна карточка целей: если она уже есть, метод возвращает CARD_ALREADY_EXISTS и не создаёт вторую.
HTTP: POST
Побочные эффекты: создаёт карточку целей
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
departmentId |
int |
да | ID отдела |
employeeId |
int |
да | ID сотрудника |
Возвращаемые данные
Ответ в конверте модуля: result.result — созданная карточка; result.error. Ключи total/next для не-list методов могут отсутствовать в сериализации, если не переданы.
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
ACCESS_DENIED |
Нет прав на операцию (общий запрет) |
VALIDATION_ERROR |
Некорректные или неполные параметры |
CARD_ALREADY_EXISTS |
У сотрудника уже есть карточка целей (details.cardId) |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
Пример запроса (POST)
curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/goalsmanagement.goalcard.create.json" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
--data '{
"departmentId": 12,
"employeeId": 15
}'
Пример ответа
{
"result": {
"result": {
"id": 501,
"needAction": true,
"name": "Карта целей: Иван Петров",
"active": "Y",
"employeeId": 15,
"headId": 8,
"directorId": 3,
"delegateId": 16,
"status": "status_approval",
"deadline": "2026-08-15",
"goals": [
{
"ID": 1001,
"GOALS_TABLE_GOAL_ID": 101,
"GOALS_TABLE_GOAL": "Увеличить выручку отдела",
"GOALS_TABLE_TASK": "Заключить договоры с 20 новыми клиентами",
"GOALS_TABLE_TYPE_GOAL": "Стратегическая",
"GOALS_TABLE_CRITERION": "Рост выручки на 15%",
"GOALS_TABLE_COMMENT_GENERAL": "Согласовано с руководителем",
"GOALS_TABLE_WEIGHT": 40,
"GOALS_TABLE_PROGRESS": 65
}
],
"totalProgress": 65,
"dateStart": "2026-01-01",
"dateEnd": "2026-12-31",
"position": "Менеджер по продажам",
"departmentId": 12,
"deadlineFilling": "2026-01-20",
"deadlineApproval": "2026-01-31",
"processDuration": "12_month",
"reportingPeriod": "3_month",
"statusProcess": "1",
"processId": 42
},
"error": null
}
}
См. также
Предыдущая
Следующая