Метод для обновления параметров сделки и её статуса.
Для обновления сделки вам необходимо знать её id
и указать его в URL
запроса. Все обновляемые параметры сделки указываются в теле запроса.
Получить актуальный список идентификаторов дополнительных полей сделки вы можете в методе Список дополнительных полей.
Кроме перечисленных ниже параметров сделки, вы можете изменить и воронку сделки. Для этого укажите в параметре stage_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 | Устанавливаемое значение | |
responsible_user_ids | array of integers | Массив идентификаторов пользователей, привязанных к сделке как «ответственные» | |
Ответ
|
|||
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 или link) | |
value | string | Значение | |
responsible_users | array of objects | Ответственные сотрудники | |
id | integer | Идентификатор отвественного сотрудника | |
Возможные ошибки запроса (errors code)
|
|||
blank | Обязательное поле (не может быть пустым) | ||
too_long | Слишком длинное значение (пояснения вы получите в поле message) | ||
not_a_number | Поле не является числом (например, вы прислали стоимость сделки не числом) | ||
not_found | Не удалось найти | ||
invalid | Поле имеет неверное значение | ||
|
{
"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
}
]
}
}