Към съдържанието

Методът 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
                               ]
                           ]
                       ]
                   ]
               )
           ]
       ]
   )
);