Saltar a contenido

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