Перейти к содержанию

Метод addLeads

Загрузка информации по новым сделкам. В ответ возвращается массив идентификаторов сохраненных сделок или/и массив идентификаторов сделок, которые не загружены с описание причины. Метод: POST Формат: JSON Ссылка: https://api.r7k12.ru/{{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/Flexbe/Tilda и т.д. )
r7k12id string Нет Уникальный идентификатор визита (или источник визита) R7K12
price float Нет Сумма сделки
cost float Нет Себестоимость сделки
clientId string Нет Идентификатор клиента в CRM
manager string Нет Идентификатор менеджера ответственного за сделку
shop string Нет Магазин, к которому относится сделка
appealUrl string Нет Полный URL страницы с которой был осуществлен заказ. Пример: https://magazine.ru/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.ru/'.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',
                       ]
                   ]
               )
           ]
       ]
   )
);