Método updateLeads¶
Actualización de la información de negocios existentes. Permite actualizar cualquier parámetro del negocio (excepto el identificador). En la respuesta se devuelve un array de identificadores de los negocios actualizados y/o un array de identificadores de los negocios que no se han actualizado, con la descripción del motivo. Método: POST Formato: JSON Enlace: https://api.r7k12.com/{{TOKEN}}/updateLeads Parámetros: Tabla 1 Content-type: application/json Tabla 1
| Nombre | Valor | Obligatorio | Descripción |
| id | string | Sí | Identificador único del negocio que se actualiza en el sistema CRM |
| name | string | No | Nombre del negocio en el sistema CRM (no más de 500 caracteres). |
| status | string | No | Identificador del estado del negocio en el sistema CRM. |
| dateChangeStatus | string | No | Fecha de cambio de estado en formato Y-m-d |
| type | string | No | Tipo de consulta (Form/Ringostat/Tilda, etc. ) |
| type | string | No | Tipo de consulta (Form/Ringostat/Tilda, etc. ) |
| price | float | No | Importe del negocio |
| cost | float | No | Precio de coste del negocio |
| clientId | string | No | Identificador del cliente en el CRM |
| manager | string | No | Identificador del responsable a cargo del negocio |
| shop | string | No | Tienda a la que pertenece el negocio |
| appealUrl | string | No | URL completa de la página desde la que se realizó el pedido. Ejemplo: https://magazine.com/page1/product5/?c=1#block=1 |
| appeals | integer | No | Número de consultas del negocio |
| appealId | string | No | Identificador de la consulta obtenido con el método getAppeals |
| number | integer | No | Número de orden del negocio del contacto |
| products | array[object] | No | Array de productos relacionados con el negocio (descripción en la Tabla 2). |
| payment | array[object] | No | Pagos del negocio (descripción en la Tabla 3) |
| fields | object | No | Campos adicionales del negocio. Nota: si se envía el parámetro «fields», este se sobrescribe por completo |
Tabla 2
| Nombre | Valor | Obligatorio | Descripción |
| id | string | Sí | Identificador único del producto |
| name | string | Sí | Nombre del producto |
| price | float | Sí | Precio por unidad del producto |
| quantity | integer | Sí | Cantidad |
Tabla 3
| Nombre | Valor | Obligatorio | Descripción |
| id | string | Sí | Identificador único del pago |
| sum | float | Sí | Importe del pago |
| status | integer | Sí | Estado del pago (1 - pago realizado, -1 - pago cancelado) |
| date | string | Sí | Fecha de realización del pago. Formato AAAA-MM-DD |
Ejemplo de cuerpo de la solicitud:¶
[
{
"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
}
]
}
]
Ejemplo de respuesta:¶
{
"update" : [1,2,3],
"notUpdate" : [
{
"id" : NULL,
"message" : "Не указан идентификатор сделки"
},
{
"id" : 5,
"message" : "Сделка с указанным идентификатором не существует"
}
]
}
Ejemplo de script (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
]
]
]
]
)
]
]
)
);