Saltar a contenido

Método setShippingTrackingId

El método permite añadir o actualizar el número de seguimiento del envío postal en un negocio. Al indicar el número de guía de envío electrónica, el servicio de entrega debe estar conectado en las integraciones de R7K12CRM. La cantidad máxima de datos de entrada es 100. Método: POST Enlace: https://api.r7k12.com/{{TOKEN}}/R7K12Crm Parámetros: Tabla n.º 1 Datos de entrada:

{

 "method": "setShippingTrackingId",

 "input": [

   {

     "dealId": (string),

     "type": (string),

     "shippingId": (string)

   },

   ...

 ]

}

Tabla n.º 1

Parámetro Tipo Obligatorio Descripción
method string Sí Método invocado. Siempre «setShippingTrackingId»
input array[object] Sí Parámetros de entrada del método
input[index].dealId string Sí ID del negocio
input[index].type string Sí Identificador del servicio de entrega al que pertenece el número de seguimiento - «novaPoshta» - Nova Poshta
input[index].shippingId string Sí Número de seguimiento del envío postal

Ejemplo de solicitud:

define('TOKEN','YOURTOKEN');

function POST ($request) {
   $curl = curl_init();
   curl_setopt($curl, CURLOPT_URL, 'https://api.r7k12.com/'.TOKEN.'/R7K12Crm');
   curl_setopt($curl, CURLOPT_RETURNTRANSFER,true);
   curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_POSTFIELDS, json_encode($request,JSON_UNESCAPED_UNICODE));
   $out = curl_exec($curl);
   curl_close($curl);
   return json_decode($out,true);
}

$response = POST(
   [
            'method' => 'setShippingTrackingId' ,
            'input' => [
                    [
'dealId' => '5e450c947e7c21254b42a942',
'fields' => 'novaPoshta',
'fields' => '1234567890',
]
]
       ]
);

print_r($response);

Procesamiento de la respuesta:

{

 "success": true,

 "warning": [

   {

     "dealId": (string),

     "type": (syting),

     "shippingId": (string),

     "error": (string)

   }

 ]

}

Tabla n.º 2

Parámetro Tipo Obligatorio Descripción
success true No Indicador de procesamiento correcto de todos los datos cargados. Solo está presente si todos los datos se han procesado correctamente
warning array[object] No Array de datos de entrada no procesados
warning[index].dealId string Sí ID del negocio
warning[index].type string Sí Identificador del servicio de entrega al que pertenece el número de seguimiento - «novaPoshta» - Nova Poshta
warning[index].shippingId string Sí Número de seguimiento del envío postal
warning[index].error string Sí Motivo por el que no se procesaron los datos: - Field "dealId": must be string (a-z0-9) - Deal not found - Incorrect field "shippingId" - Incorrect shipping system - The electronic invoice number "XXXXX" is already set on another deal - Shipping system is not enabled

Errores de la API

Formato de la respuesta:

{

 "error": {

   "code": (int),

   "error": (string),

   "error_detail": (string)

 }

}

Tabla n.º 3

Código Error Descripción
-1 No se pudo ejecutar la solicitud Se ha producido un error interno de la API. Póngase en contacto con el soporte técnico indicando el requestId
20 Clave de acceso incorrecta
21 Método incorrecto
22 Formato de datos no válido
23 No se han indicado los parámetros obligatorios
24 La integración con la API no está conectada
25 Error de escritura
26 La cantidad máxima de registros por solicitud es 100
27 El intervalo entre solicitudes debe ser de al menos 3 segundos
28 No hay acceso al proyecto seleccionado
29 Permisos insuficientes para ejecutar este método
210 Para ejecutar el método seleccionado se necesita la clave de acceso del usuario Es necesario obtener la clave mediante el esquema OAUTH2
211 El token de acceso está bloqueado Para más información, póngase en contacto con el soporte técnico
212 No es posible ejecutar en paralelo solicitudes con los mismos métodos El método de la API seleccionado ya se está usando en una solicitud paralela con el token indicado
301 Invalid API Method Se ha invocado un método incorrecto de la API de R7K12 CRM
302 R7K12 CRM is not connected in the project R7K12 CRM no está conectado en el proyecto
303 Integration not connected in R7K12 CRM La integración no está conectada dentro de R7K12 CRM
304 Incorrect input data Datos de entrada no válidos
305 A lot of data Se ha superado la cantidad máxima de datos de entrada