12.03.2026 20:40

SetStage

[POST] .../v1/deal/setstage

Изменяет стадию CRM-сделки.

Входные параметры

Название Тип данных Обязательность Описание
id Int64 Обязательный ID сделки
stage_id Int64 Обязательный ID новой стадии
comment String Необязательный Комментарий к смене стадии

stage_id должен принадлежать воронке сделки.

Пример запроса

{
  "id": 220,
  "stage_id": 35,
  "comment": "Подписали договор"
}

Выходные параметры

Название Тип данных Описание
result.row_affected Int64 Количество измененных строк
result.ids Array of Int64 ID измененных записей

При переходе в терминальную стадию статус сделки вычисляется автоматически:

  • Won, если стадия успешная (is_success = true);
  • Lost, если стадия терминальная и неуспешная.

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

{
  "ok": true,
  "result": {
    "row_affected": 1,
    "ids": [220]
  }
}