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 измененных записей

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

переход в не терминальную стадию -> status = Open, close_date = null, чат открыт;
переход в терминальную успешную стадию (is_terminal = true, is_success = true) -> status = Won, close_date = now, чат закрыт;
переход в терминальную неуспешную стадию (is_terminal = true, is_success = false) -> status = Lost, close_date = now, чат закрыт;
переход из терминальной стадии в не терминальную переоткрывает сделку;
повторный переход в терминальную стадию обновляет close_date.

Метод всегда отправляет webhook DealStageSet. При переходе в терминальную стадию дополнительно отправляется DealClosed.

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

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