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 |