# assessment360.responder.update
Scope:
assessment360Кто может вызывать: Управление карточкой процедуры (
canManageAssessmentCard). См. Права доступа
Обновляет одну карточку респондента (элемент инфоблока респондентов) по её id. Это не массовое изменение всех респондентов оценки.
HTTP: POST
Побочные эффекты: Изменяет состояние данных модуля assessment360.
Параметры метода
| Параметр | Тип | Обяз. | Описание |
|---|---|---|---|
id |
int |
да | ID карточки респондента (не ID оценки) |
name |
string |
нет | Название элемента |
code |
string |
нет | Символьный код |
active |
bool |
нет | Активность |
dateActiveFrom |
string |
нет | Дата начала активности |
dateActiveTo |
string |
нет | Дата окончания активности |
sort |
int |
нет | Сортировка |
previewText |
string |
нет | Текст анонса |
previewTextType |
string |
нет | text или html |
detailText |
string |
нет | Детальный текст |
detailTextType |
string |
нет | text или html |
assessmentCardId |
int |
нет | ID карточки оценки |
userId |
int |
нет | ID оценивающего сотрудника |
assessorUserId |
int |
нет | Алиас для userId / ASSESSMENT_EMPLOYEES |
contactId |
string |
нет | ID контакта CRM |
assessorContactId |
string |
нет | Алиас для contactId |
shortLink |
string |
нет | Короткая ссылка |
dateFactEnd |
string |
нет | Фактическая дата завершения |
status |
string |
нет | xmlId статуса респондента. Допустимые значения — см. assessment360.responder.status.list |
role |
string |
нет | Роль (employee, manager, collega, subordinate, crm) |
isUserCanSelectColleagues |
bool |
нет | Может ли выбирать коллег |
accessSelectAssessment |
bool |
нет | Явный флаг доступа выбора коллег |
showCommonCommentEmployee |
bool |
нет | Показ общего комментария сотруднику |
showCommonCommentManager |
bool |
нет | Показ общего комментария руководителю |
competencyIds |
array |
нет | Список ID компетенций |
competencies |
object |
нет | Компетенции с типами оценки (если не переданы competencyIds; см. ниже) |
Структура competencies
Та же карта, что и competentionAssessmentTypeList в assessment360.assessment.start: ключ — тип охвата, значение — int[] (ID компетенций). После фильтра по role должен остаться хотя бы один ID.
Полный список ключей, матрица по ролям и правила взаимоисключения — в разделе «Структура competentionAssessmentTypeList» документа assessment.start.
| Ключ | Тип | Описание |
|---|---|---|
all |
int[] |
Компетенции для всех ролей |
employee_and_head |
int[] |
Сотрудник + руководитель |
employee_and_head_and_subordinates |
int[] |
+ подчинённые (роль subordinate) |
employee_and_head_and_colleagues |
int[] |
+ коллеги (роль collega) |
"competencies": {
"all": [11],
"employee_and_head": [13],
"employee_and_head_and_subordinates": [14]
}
Возвращаемые данные
Объект { fields, properties } — карточка респондента после обновления. Ответ в конверте модуля: result.result, result.error.
Обработка ошибок
Справочник кодов: error-codes.md.
| Код | Описание |
|---|---|
UNAUTHORIZED |
Пользователь не авторизован |
INTERNAL_ERROR |
Внутренняя ошибка сервера |
VALIDATION_ERROR |
Ошибка валидации входных параметров |
NOT_FOUND |
Карточка респондента не найдена |
ACCESS_DENIED |
Недостаточно прав для выполнения операции |
Пример запроса (POST)
curl -X POST "https://{портал}/rest/{user_id}/{webhook_code}/assessment360.responder.update.json"
-H "Content-Type: application/json"
-H "Accept: application/json"
--data '{
"id": 214,
"status": "ignored",
"role": "collega",
"userId": 5,
"showCommonCommentEmployee": true
}'
Пример ответа
{
"result": {
"result": {
"fields": {
"id": 214,
"name": "Иванов Иван",
"active": "Y",
"code": "RSP-7F13F9A2",
"dateCreate": "18.06.2026 12:07:44"
},
"properties": {
"STATUS": { "type": "L", "userType": null, "multiple": false, "value": 203, "enumId": 203, "xmlId": "ignored" },
"ROLE": { "type": "L", "userType": null, "multiple": false, "value": 205, "enumId": 205, "xmlId": "collega" },
"ASSESSMENT_CARD": { "type": "E", "userType": null, "multiple": false, "value": 331 }
}
},
"error": null
}
}