Метод для создания новой сделки в вашей компании.
При создании сделки обязательным условием является заполнение названия сделки, указание идентификатора контакта и этапа воронки продаж. Создать новый контакт вы можете в методе новый контакт, а получить актуальный список этапов в методе список воронок и этапов продаж.
Вы можете заполнять дополнительные поля сделки, которые созданы в вашей компании. Получить актуальный список идентификаторов дополнительных полей сделки вы можете в методе Список дополнительных полей.
При создании сделки первым ответственным назначается создатель сделки.
|
Запрос
|
|||
|---|---|---|---|
| deal | object* | Собранный объект параметров создаваемой сделки | |
| name | string* | Название сделки | |
| client_id | integer* | Идентификатор контакта, привязываемого к сделке | |
| stage_id | integer* | Идентификатор этапа воронки продаж, привязываемого к сделке | |
| cost | integer | Стоимость сделки в рублях (по умолчанию 0) | |
| custom_properties | array of objects | Задаваемые дополнительные поля | |
| id | integer | Идентификатор дополнительного поля сделки | |
| value | string | Устанавливаемое значение | |
| note | object | Объект создаваемой заметки к сделке | |
| content | 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) | |
| 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": {
"name": "Заказ #22",
"client_id": 3609,
"stage_id": 1034,
"cost": 1800,
"note": {
"content": "Красная шапка, 50 см, осенняя"
},
"custom_properties": [
{
"id": 1123,
"value": 500
}
]
}
}{
"data": {
"id": 2345,
"owner_id": 226,
"created_at": "2020-04-22T12:32:29.000Z",
"name": "Заказ #22",
"client_id": 3609,
"stage_id": 1034,
"cost": 1800,
"state": "working",
"custom_properties": [
{
"id": 1123,
"name": "Предоплата",
"data_type": "number",
"value": 500
}
]
}
}