Методът updateLeads¶
Обновяване на информацията за съществуващи сделки. Позволява да обновите всеки параметър на сделката (освен идентификатора). В отговор се връща масив с идентификатори на обновените сделки и/или масив с идентификатори на сделките, които не са обновени, с описание на причината. Метод: POST Формат: JSON Линк: https://api.r7k12.com/{{TOKEN}}/updateLeads Параметри: Таблица 1 Content-type: application/json Таблица 1
| Име | Стойност | Задължителен | Описание |
| id | string | Да | Уникален идентификатор на обновяваната сделка в CRM системата |
| name | string | Не | Име на сделката в CRM системата (не повече от 500 символа). |
| status | string | Не | Идентификатор на статуса на сделката в CRM системата. |
| dateChangeStatus | string | Не | Дата на промяна на статуса във формат Y-m-d |
| type | string | Не | Тип на запитването (Form/Ringostat/Tilda и т.н. ) |
| type | string | Не | Тип на запитването (Form/Ringostat/Tilda и т.н. ) |
| price | float | Не | Сума на сделката |
| cost | float | Не | Себестойност на сделката |
| clientId | string | Не | Идентификатор на клиента в CRM |
| manager | string | Не | Идентификатор на мениджъра, отговорен за сделката |
| shop | string | Не | Магазин, към който се отнася сделката |
| appealUrl | string | Не | Пълен URL адрес на страницата, от която е направена поръчката. Пример: https://magazine.com/page1/product5/?c=1#block=1 |
| appeals | integer | Не | Брой запитвания по сделката |
| appealId | string | Не | Идентификатор на запитването, получен с метода getAppeals |
| number | integer | Не | Пореден номер на сделката при контакта |
| products | array[object] | Не | Масив с продуктите, отнасящи се към сделката (описание: Таблица 2). |
| payment | array[object] | Не | Плащания по сделката (описание: Таблица 3) |
| fields | object | Не | Допълнителни полета на сделката. Забележка: при изпращане на параметъра „fields“ той се презаписва изцяло |
Таблица 2
| Име | Стойност | Задължителен | Описание |
| id | string | Да | Уникален идентификатор на продукта |
| name | string | Да | Име на продукта |
| price | float | Да | Цена за единица продукт |
| quantity | integer | Да | Количество |
Таблица 3
| Име | Стойност | Задължителен | Описание |
| id | string | Да | Уникален идентификатор на плащането |
| sum | float | Да | Сума на плащането |
| status | integer | Да | Статус на плащането (1 - плащането е извършено, -1 - плащането е отменено) |
| date | string | Да | Дата на извършване на плащането. Формат ГГГГ-ММ-ДД |
Пример за тяло на заявката:¶
[
{
"id":"1",
"name":"Сделка закрыта"//Обновить название сделки
"status":"100"//Обновить статус сделки
},
{
"id":"2",
"price":7454//Обновить сумму сделки
},
{
"id":"3",
"products": [//Обновить список продуктов
{
"id": "1",
"name": "Продукт 1",
"price": 0,
"quantity": 1
},
{
"id": "2",
"name": "Продукт 2",
"price": 124.6,
"quantity": 2
}
]
}
]
Пример за отговор:¶
{
"update" : [1,2,3],
"notUpdate" : [
{
"id" : NULL,
"message" : "Не указан идентификатор сделки"
},
{
"id" : 5,
"message" : "Сделка с указанным идентификатором не существует"
}
]
}
Пример за скрипт (PHP):¶
define('TOKEN','XXXXXXXXX');
@file_get_contents(
'https://api.r7k12.com/'.TOKEN.'/updateLeads',
0,
stream_context_create(
[
'http' => [
'method' => "POST",
'header' => "Content-Type: application/json\r\n",
'content' => json_encode(
[
[
'id' => '1',
'name' => 'Сделка закрыта',
'status' => '100'
],
[
'id' => '2',
'price' => 7454
],
[
'id' => '3',
'products' => [
[
'id' => '1',
'name' => 'Продукт 1',
'price' => 0,
'quantity' => 1
],
[
'id' => '2',
'name' => 'Продукт 2',
'price' => 124.6,
'quantity' => 2
]
]
]
]
)
]
]
)
);