Skip to main content
POST
Выдаёт наказание с актуальной revision. Если действие приводит к снятию сотрудника, требуется confirm_removal. Обязателен заголовок Idempotency-Key.

Доступ

personnel:warnings_issue либо personnel:reprimands_issue.
string
required
Партнёрский Bearer-токен. Подробнее в разделе «Авторизация».

Особенности

Сначала откройте метод подготовки. Перед выполнением операции возьмите revision из его ответа и передайте её как revision. Третье предупреждение может стать выговором. Проверьте will_create_reprimand и scope personnel:reprimands_issue. При will_remove=true для операции необходимы confirm_removal=true и scope personnel:remove.

Параметры

string
required
Уникальный ключ действия: от 16 до 128 печатных ASCII-символов без пробелов. При повторе того же запроса используйте тот же ключ. Для нового действия создайте новый. До 128 символов.

Тело запроса

Передайте JSON с заголовком Content-Type: application/json.
object
required
Модератор, который инициировал действие через бота. CRM определяет его аккаунт по привязанному внешнему ID и проверяет полномочия.
object
required

Успешный ответ

HTTP 200. Запрос выполнен успешно.
string
required
Взыскание: warning — предупреждение, reprimand — выговор.
boolean
required
Был ли сотрудник снят в результате действия.
string
required
Ревизия текущего состояния. Передавайте актуальное значение, полученное при подготовке действия или чтении состояния.
string
required
Идентификатор взыскания (UUID).Формат uuid.
string
required
Идентификатор сервера CRM (UUID). Сервер должен входить в выданный боту доступ.Формат uuid.
string
required
Текущее состояние записи.
string
required
Идентификатор сотрудника в CRM, в том числе незарегистрированного участника состава (UUID).Формат uuid.

Ошибки

См. формат ошибок и правила повторов.

Пример

Подставьте свои ID, а для изменения используйте отдельный ключ операции и ревизию из CRM.