Przejdź do treści

Metoda updateLeads

Aktualizacja informacji o istniejących transakcjach. Pozwala zaktualizować dowolny parametr transakcji (oprócz identyfikatora). W odpowiedzi zwracana jest tablica identyfikatorów zaktualizowanych transakcji i/lub tablica identyfikatorów transakcji, które nie zostały zaktualizowane, wraz z opisem przyczyny. Metoda: POST Format: JSON Link: https://api.r7k12.com/{{TOKEN}}/updateLeads Parametry: Tabela 1 Content-type: application/json Tabela 1

Nazwa Wartość Wymagany Opis
id string Tak Unikalny identyfikator aktualizowanej transakcji w systemie CRM
name string Nie Nazwa transakcji w systemie CRM (nie więcej niż 500 znaków).
status string Nie Identyfikator statusu transakcji w systemie CRM.
dateChangeStatus string Nie Data zmiany statusu w formacie Y-m-d
type string Nie Typ zapytania (Form/Ringostat/Tilda itp. )
type string Nie Typ zapytania (Form/Ringostat/Tilda itp. )
price float Nie Kwota transakcji
cost float Nie Koszt własny transakcji
clientId string Nie Identyfikator klienta w CRM
manager string Nie Identyfikator menedżera odpowiedzialnego za transakcję
shop string Nie Sklep, do którego należy transakcja
appealUrl string Nie Pełny URL strony, z której złożono zamówienie. Przykład: https://magazine.com/page1/product5/?c=1#block=1
appeals integer Nie Liczba zapytań w ramach transakcji
appealId string Nie Identyfikator zapytania uzyskany metodą getAppeals
number integer Nie Numer porządkowy transakcji danego kontaktu
products array[object] Nie Tablica produktów powiązanych z transakcją (opis: Tabela 2).
payment array[object] Nie Płatności w ramach transakcji (opis: Tabela 3)
fields object Nie Dodatkowe pola transakcji. Uwaga: w przypadku przesłania parametru „fields” jest on nadpisywany w całości

Tabela 2

Nazwa Wartość Wymagany Opis
id string Tak Unikalny identyfikator produktu
name string Tak Nazwa produktu
price float Tak Cena jednostkowa produktu
quantity integer Tak Ilość

Tabela 3

Nazwa Wartość Wymagany Opis
id string Tak Unikalny identyfikator płatności
sum float Tak Kwota płatności
status integer Tak Status płatności (1 - płatność dokonana, -1 - płatność anulowana)
date string Tak Data dokonania płatności. Format RRRR-MM-DD

Przykładowa treść żądania:

[
 {
   "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
     }
   ]
 }
]

Przykładowa odpowiedź:

{
 "update" : [1,2,3],
 "notUpdate" : [
   {
     "id" : NULL,
     "message" : "Не указан идентификатор сделки"
   },
   {
     "id" : 5,
     "message" : "Сделка с указанным идентификатором не существует"
   }
 ]
}

Przykładowy skrypt (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
                               ]
                           ]
                       ]
                   ]
               )
           ]
       ]
   )
);