Обновление сделки

Метод для обновления параметров сделки и её статуса.

Для обновления сделки вам необходимо знать её id и указать его в URL запроса. Все обновляемые параметры сделки указываются в теле запроса. Получить актуальный список идентификаторов дополнительных полей сделки вы можете в методе Список дополнительных полей.

Кроме перечисленных ниже параметров сделки, вы можете изменить и воронку сделки. Для этого укажите в параметре stage_id идентификатор этапа новой воронки. Получить актуальный список воронок вы можете в методе список воронок и этапов продаж.

put /deals/{id} обновление сделки по указанному идентификатору
Запрос
deal object* Собранный объект обновляемых параметров сделки
name string** Название сделки
stage_id integer** Идентификатор этапа воронки продаж
cost integer** Стоимость сделки в рублях
state string** Состояние сделки: working (активная), successful (выполнено), failed (отказ) или archived (архив)
custom_properties array of objects** Обновляемые дополнительные поля
id integer Идентификатор дополнительного поля сделки
value string Устанавливаемое значение
Ответ
data object Обновленная сделка
id integer Идентификатор обновленной сделки
owner_id integer Идентификатор сотрудника, создавшего сделку
created_at string Дата и время создания сделки (ISO-8601, UTC+0) в формате YYYY-MM-DDThh:mm:ss.sssZ
name string Название сделки
client_id integer Идентификатор клиента, привязанного к сделке
stage_id integer Идентификатор этапа воронки продаж, привязанного к сделке
cost integer Стоимость сделки в рублях
state string Состояние сделки: working (активная), successful (выполнено), failed (отказ) или archived (архив)
custom_properties array of objects Дополнительные поля обновленной сделки
id integer Идентификатор поля
name string Название поля
data_type string Тип поля (string, number или date)
value string Значение
Возможные ошибки запроса (errors code)
blank Обязательное поле (не может быть пустым)
too_long Слишком длинное значение (пояснения вы получите в поле message)
not_a_number Поле не является числом (например, вы прислали стоимость сделки не числом)
not_found Не удалось найти
invalid Поле имеет неверное значение
Идентификатор обновляемой сделки передается в URL (например, /deals/2345)
Остальные параметры указываются в теле запроса
{
  "deal": {
    "stage_id": 1036,
    "custom_properties": [
      {
        "id": 1123,
        "value": 1800
      }
    ]
  }
}
{
  "data": {
    "id": 2345,
    "owner_id": 226,
    "created_at": "2020-04-22T12:32:29.000Z",
    "name": "Заказ #22",
    "client_id": 3609,
    "stage_id": 1036,
    "cost": 1800,
    "state": "working",
    "custom_properties": [
      {
        "id": 1123,
        "name": "Предоплата",
        "data_type": "number",
        "value": 1800
      }
    ]
  }
}