Saltar a contenido

Método addLeads

Carga de información sobre nuevos negocios. En la respuesta se devuelve un array de identificadores de los negocios guardados y/o un array de identificadores de los negocios que no se han cargado, con la descripción del motivo. Método: POST Formato: JSON Enlace: https://api.r7k12.com/{{TOKEN}}/addLeads Parámetros: Tabla 1 Content-type: application/json Tabla 1

Nombre Valor Obligatorio Descripción
id string Sí Identificador único del negocio en el sistema CRM
name string No Nombre del negocio en el sistema CRM (no más de 500 caracteres).
dateCreate unix time Sí Fecha de creación del negocio en formato UNIX
status string Sí Identificador del estado del negocio en el sistema CRM. Para que los negocios se procesen correctamente, es necesario cargar los estados mediante el método setStatuses
dateChangeStatus string No Fecha de cambio de estado en formato Y-m-d
type string No Tipo de consulta (Form/Ringostat/Tilda, etc. )
r7k12id string No Identificador único de la visita (o fuente de la visita) de R7K12
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

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":"Сделка №1",
   "dateCreate": 1508746231,
   "status":"57667454",
   "dateChangeStatus":"2017-10-21",
   "type":"Form",
   "r7k12id": "14154465",
   "price":80.6,
   "cost":70,
   "clientId":"876",
   "manager": 5,
   "products": [
     {
       "id": "1",
       "name": "Продукт 1",
       "price": 0,
       "quantity": 1
     },
     {
       "id": "2",
       "name": "Продукт 2",
       "price": 124.6,
       "quantity": 2
     }
   ],
   "payment": [
     {
       "id": "6458erg",
       "sum": 50,
       "status": 1,
       "date": "2018-04-16"
     },
     {
       "id": "jf94ksm",
       "sum": 100,
       "status": 1,
       "date": "2018-04-20"
     }
   ],
   "fields": {
     "1": "fields 1",
     "45": "fields 3"
   }
 },
 {
   "id":"2",
   "name":"Сделка №2",
   "dateCreate": 1508746531,
   "status":"7454",
   "r7k12id": "site_offline"
 },
 {
   "id":"3",
   "name":"Сделка №3",
   "dateCreate": 1509746531,
   "status":"744"
 }
]

Ejemplo de respuesta:

{
 "upload" : [1,2,3],
 "notUpload" : [
   {
     "id" : 4,
     "message" : "Не указан параметр 'dateСreate'"
   },
   {
     "id" : 5,
     "message" : "Сделка с указанным идентификатором уже существует"
   },
   {
     "id" : 6,
     "message" : "Не удалось загрузить сделку. Указана некорректная дата создания сделки"
   }
 ]
}

Ejemplo de script (PHP):

define('TOKEN','XXXXXXXXX');
@file_get_contents(
   'https://api.r7k12.com/'.TOKEN.'/addLeads',
   0,
   stream_context_create(
       [
           'http' => [
               'method' => "POST",
               'header' => "Content-Type: application/json\r\n",
               'content' => json_encode(
                   [
                       [
                           'id' => '1',
                           'name' => 'Сделка №1',
                           'dateCreate' => 1508746231,
                           'status' => '57667454',
                           'type' => 'Form',
                           'r7k12id' => '14154465',
                           'price' => 80.6,
                           'cost' => 70,
                           'clientId' => '876',
                           'manager' => '5',
                           'shop' =>  'магазин',
                           'products' => [
                               [
                                   'id' => '1',
                                   'name' => 'Продукт 1',
                                   'price' => 0,
                                   'quantity' => 1
                               ],
                               [
                                   'id' => '2',
                                   'name' => 'Продукт 2',
                                   'price' => 124.6,
                                   'quantity' => 2
                               ]
                           ],
                           'fields' => [
                               '1' => 'fields 1',
                               '45' => 'fields 3'
                           ]
                       ],
                       [
                           'id' => '2',
                           'name' => 'Сделка №2',
                           'dateCreate' => 1508746531,
                           'status' => '7454',
                           'r7k12id' => 'site_offline',
                       ],
                       [
                           'id' => '3',
                           'name' => 'Сделка №3',
                           'dateCreate' => 1509746531,
                           'status' => '744',
                       ]
                   ]
               )
           ]
       ]
   )
);