assessment360.assessment.start

Scope: assessment360

Кто может вызывать: Группы «могут запускать процесс оценки» / админ / HR (canUseStartActions). См. Права доступа

Запускает новую процедуру оценки 360 и формирует набор респондентов.

HTTP: POST

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

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

Булевы значения принимаются как true / 1 / "Y" / "true".

Структура Структура competentionAssessmentTypeList

Объект: ключ — тип охвата компетенций (не xmlId роли респондента), значение — массив ID компетенций.
Допустимы только эти четыре ключа. Нужен хотя бы один ключ с непустым массивом.

Матрица: какой ключ попадает в карточку респондента по Матрица: какой ключ попадает в карточку респондента по role

При создании респондентов компетенции берутся так (filterCompetenciesByRole):

Правила взаимоисключенияПравила взаимоисключения

1. Один ID компетенции — один ключ (как в UI).
Каждый ID из competentionsIds должен попасть не более чем в один ключ карты. В интерфейсе у компетенции выбирается один режим охвата; дубли одного ID в нескольких ключах API не режет, но поведение становится неоднозначным — так делать не нужно.

2. Участники оценки не могут иметь две роли одновременно.
Иначе VALIDATION_ERROR (сообщение о двойной роли):

• userId ≠ managerId
• userId не входит в colleaguesIds и subordinatesIds
• managerId не входит в colleaguesIds и subordinatesIds
• пересечение colleaguesIds ∩ subordinatesIds пустое

3. Согласованность охвата с составом респондентов (рекомендуется, как в UI).

Иначе у коллег/подчинённых после фильтра по роли не останется компетенций.

"competentionAssessmentTypeList": {
          "all": [1049],
          "employee_and_head": [1051],
          "employee_and_head_and_subordinates": [1052],
          "employee_and_head_and_colleagues": [1053]
        }
        

Структура Структура crmContacts

Объект: ключ — ID контакта CRM (строка или число), значение — каналы связи. Контакт попадает в оценку, если указан хотя бы один phone или email.

"crmContacts": {
          "42": { "phone": ["+79001234567"], "email": ["client@example.com"] },
          "57": { "email": ["partner@example.com"] }
        }
        

Структура Структура questionsData[]

Массив объектов вопроса:

XML_ID enum «кто отвечает»: all, head, head_employee, head_employee_subordinates, head_employee_colleagues.
XML_ID enum «обязательность»: not, head, head_employee, all.

"questionsData": [
          {
            "id": 15,
            "name": "Сильные стороны",
            "descr": "Опишите сильные стороны",
            "questionWho": 3,
            "questionReq": 2
          }
        ]
        

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

Объект { id, status } — ID созданной карточки и код статуса (on_approval или assessment_collection).
Допустимые xmlId статусов оценки — см. assessment360.assessment.status.list.

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

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

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

curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/assessment360.assessment.start.json"
          -H "Content-Type: application/json"
          -H "Accept: application/json"
          --data '{
          "userId": 15,
          "managerId": 1,
          "competentionsIds": [1049, 1051],
          "competentionAssessmentTypeList": {
            "all": [1049],
            "employee_and_head_and_colleagues": [1051]
          },
          "isNeedManagerApproval": false,
          "isUserCanSelectColleagues": true,
          "colleaguesIds": [8, 14],
          "subordinatesIds": [22],
          "crmContacts": {
            "42": { "email": ["client@example.com"] }
          },
          "activeTo": "30.06.2026 23:59:59",
          "questionsData": [
            {
              "id": 15,
              "name": "Сильные стороны",
              "descr": "Опишите сильные стороны",
              "questionWho": 3,
              "questionReq": 2
            }
          ],
          "tags": ["Q3-2026", "rest-test"]
        }'
        

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

{
          "result": {
            "result": {
              "id": 1301,
              "status": "assessment_collection"
            },
            "error": null
          }
        }
        

См. такжеСм. также

• assessment360.assessment.approve
• assessment360.task.list
• Коды ошибок