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
]
]
]
]
)
]
]
)
);