API Trazabilidad


Contenidos
Objetivo

Disponer a nuestros clientes un medio seguro donde consultar la trazabilidad de sus envíos.

Importante:
Cada cliente poseerá una credencial de acceso para la integración.
Puede consultar en Control de Acceso para mas información.


Formato Request

Se enviará un mensaje con la siguiente estructura:

Dentro de la URL enviarán los campos listados a continuación:

Nombre Descripción
numEnvio Número de envío de CorreosChile o referencia al envío de cliente.

Formato Response
Respuesta Satisfactoria

Dentro del body, el sistema devolverá un objeto JSON con los datos listados a continuación:

Nombre Tipo de dato Descripción
numeroEnvio texto Número de envío de CorreosChile.
servicio texto Identificador del servicio al que corresponde el envío.
rutEntrega texto Rut de la persona que recibio el envío.
nombreEntrega texto Nombre de la persona que recibio el envío.
referencia texto Referencia ingresada al generar la etiqueta.
encaminamiento texto Código de encaminamiento de CorreosChile.
devolucion texto Número de envío de CorreosChile, en caso que el envío proceda a ser devuelto.
fechaEntrega texto Fecha de la entrega.
historial nodo Arreglo con el historial de eventos del envío, ordenados por fecha descendente.
historial.fecha texto Fecha en que ocurrió el evento formato ISO 8601
historial.fechaString texto Fecha en que ocurrió el evento como texto.
historial.estado texto Nombre del estado detallado.
historial.oficina texto Nombre de la oficina.


Ejemplos
Request
Response

Ok (200)



Error (400)



Error (500)



Códigos de ejemplo
//Si desea utilizar usuario y contraseña
var usuario = "[USUARIO]";
var password = "[CONTRASEÑA]";
var authorization = "basic " + Buffer.from(usuario + ":" + password).toString('base64');

//Si desea utilizar el token de acceso
var authorization = "token [TOKEN DE ACCESO]";

var request = require('request');
var options = {
  'method': 'GET',
  'url': 'https://cert-apib2bv2.correos.cl:8000/trazabilidad/880000108638',
  'headers': {
    'Authorization': authorization
  }
};
request(options, function (error, response) {
  if (error) throw new Error(error);
  console.log(response.body);
});

var client = new RestClient("https://cert-apib2bv2.correos.cl:8000/trazabilidad/880000108638") {
    client.Timeout = -1
}
var request = new RestRequest(Method.GET);

//Si desea utilizar usuario y contraseña
var usr = "[USUARIO]";
var pwd = "[CONTRASEÑA]";
var authorization = Convert.ToBase64String(Encoding.GetEncoding("ISO-8859-1").GetBytes(usr + ":" + pwd));
request.AddHeader("Authorization", "basic " + authorization);

//Si desea utilizar el token de acceso
var token = "[TOKEN DE ACCESO]"

request.AddHeader("Authorization", authorization);
IRestResponse response = client.Execute(request);
Console.WriteLine(response.Content);
//import okhttp3.Credentials;
//import okhttp3.OkHttpClient;

//Si desea utilizar usuario y contraseña
String usuario = "[USUARIO]";
String contrasena = "[CONTRASEÑA]";
String authorization = "basic " + Credentials.basic(usuario, contrasena);

//Si desea utilizar token de acceso
String authorization = "token [TOKEN DE ACCESO]";

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
Request request = new Request.Builder()
  .url("https://cert-apib2bv2.correos.cl:8000/trazabilidad/880000108638")
  .method("GET", null)
  .addHeader("Authorization", authorization)
  .build();
Response response = client.newCall(request).execute();
//Si desea utilizar usuario y contraseña
$usuario = '[USUARIO]';
$contrasena = '[CONTRASEÑA]';
$authorization = 'basic' . base64_encode($usuario . ':' . $contrasena);

//Si desea utilizar token de acceso
$token = '[TOKEN DE ACCESO]';
$authorization = 'token' . token;

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://cert-apib2bv2.correos.cl:8000/trazabilidad/880000108638',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'GET',
  CURLOPT_HTTPHEADER => array(
    'Authorization: ' . $authorization
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response