Методът addLeads¶
Зареждане на информация за нови сделки. В отговор се връща масив с идентификатори на запазените сделки и/или масив с идентификатори на сделките, които не са заредени, с описание на причината. Метод: POST Формат: JSON Линк: https://api.r7k12.com/{{TOKEN}}/addLeads Параметри: Таблица 1 Content-type: application/json Таблица 1
| Име | Стойност | Задължителен | Описание |
| id | string | Да | Уникален идентификатор на сделката в CRM системата |
| name | string | Не | Име на сделката в CRM системата (не повече от 500 символа). |
| dateCreate | unix time | Да | Дата на създаване на сделката във формат UNIX |
| status | string | Да | Идентификатор на статуса на сделката в CRM системата. За коректната обработка на сделките е необходимо да заредите статусите с метода setStatuses |
| dateChangeStatus | string | Не | Дата на промяна на статуса във формат Y-m-d |
| type | string | Не | Тип на запитването (Form/Ringostat/Tilda и т.н. ) |
| r7k12id | string | Не | Уникален идентификатор на посещението (или източник на посещението) в R7K12 |
| 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 | Не | Допълнителни полета на сделката |
Таблица 2
| Име | Стойност | Задължителен | Описание |
| id | string | Да | Уникален идентификатор на продукта |
| name | string | Да | Име на продукта |
| price | float | Да | Цена за единица продукт |
| quantity | integer | Да | Количество |
Таблица 3
| Име | Стойност | Задължителен | Описание |
| id | string | Да | Уникален идентификатор на плащането |
| sum | float | Да | Сума на плащането |
| status | integer | Да | Статус на плащането (1 - плащането е извършено, -1 - плащането е отменено) |
| date | string | Да | Дата на извършване на плащането. Формат ГГГГ-ММ-ДД |
Пример за тяло на заявката:¶
[
{
"id":"1",
"name":"Сделка №1",
"dateCreate": 1508746231,
"status":"57667454",
"dateChangeStatus":"2017-10-21",
"type":"Form",
"r7k12id": "14154465",
"price":80.6,
"cost":70,
"clientId":"876",
"manager": 5,
"products": [
{
"id": "1",
"name": "Продукт 1",
"price": 0,
"quantity": 1
},
{
"id": "2",
"name": "Продукт 2",
"price": 124.6,
"quantity": 2
}
],
"payment": [
{
"id": "6458erg",
"sum": 50,
"status": 1,
"date": "2018-04-16"
},
{
"id": "jf94ksm",
"sum": 100,
"status": 1,
"date": "2018-04-20"
}
],
"fields": {
"1": "fields 1",
"45": "fields 3"
}
},
{
"id":"2",
"name":"Сделка №2",
"dateCreate": 1508746531,
"status":"7454",
"r7k12id": "site_offline"
},
{
"id":"3",
"name":"Сделка №3",
"dateCreate": 1509746531,
"status":"744"
}
]
Пример за отговор:
{
"upload" : [1,2,3],
"notUpload" : [
{
"id" : 4,
"message" : "Не указан параметр 'dateСreate'"
},
{
"id" : 5,
"message" : "Сделка с указанным идентификатором уже существует"
},
{
"id" : 6,
"message" : "Не удалось загрузить сделку. Указана некорректная дата создания сделки"
}
]
}
Пример за скрипт (PHP):
define('TOKEN','XXXXXXXXX');
@file_get_contents(
'https://api.r7k12.com/'.TOKEN.'/addLeads',
0,
stream_context_create(
[
'http' => [
'method' => "POST",
'header' => "Content-Type: application/json\r\n",
'content' => json_encode(
[
[
'id' => '1',
'name' => 'Сделка №1',
'dateCreate' => 1508746231,
'status' => '57667454',
'type' => 'Form',
'r7k12id' => '14154465',
'price' => 80.6,
'cost' => 70,
'clientId' => '876',
'manager' => '5',
'shop' => 'магазин',
'products' => [
[
'id' => '1',
'name' => 'Продукт 1',
'price' => 0,
'quantity' => 1
],
[
'id' => '2',
'name' => 'Продукт 2',
'price' => 124.6,
'quantity' => 2
]
],
'fields' => [
'1' => 'fields 1',
'45' => 'fields 3'
]
],
[
'id' => '2',
'name' => 'Сделка №2',
'dateCreate' => 1508746531,
'status' => '7454',
'r7k12id' => 'site_offline',
],
[
'id' => '3',
'name' => 'Сделка №3',
'dateCreate' => 1509746531,
'status' => '744',
]
]
)
]
]
)
);