Trazabilidad

URLs

Ambiente certificación

WSDL

Ambiente producción

WSDL

Parámetros

Nombre	Tipo	Requerido	Observaciones
Codigo	texto(50)	Si
CodigoCliente	texto(50)	Si
Usuario	texto(50)	Si	Usuario entregado por CorreosChile para acceder a los servicios web.
Password	texto(50)	Sí	Contraseña entregada por CorreosChile para acceder a los servicios web.

Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:tem="http://tempuri.org/">
   <soapenv:Header/>
   <soapenv:Body>
      <tem:ConsultaEnvio>
         <tem:PEnvio>
            <tem:Codigo>9900XXXXXXX</tem:Codigo>
            <tem:CodigoCliente>XXXXXX</tem:CodigoCliente>
            <tem:Usuario>PRUEBA WS 1</tem:Usuario>
            <tem:Password>b9d591ae8ef9d36bb7d4e18438d6114e</tem:Password>
         </tem:PEnvio>
      </tem:ConsultaEnvio>
   </soapenv:Body>
</soapenv:Envelope>

Response

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <ConsultaEnvioResponse xmlns="http://tempuri.org/">
         <ConsultaEnvioResult>
            <Envio>
               <Estruct_Envio>
                  <Envio>9900XXXXXXX</Envio>
                  <FechaEntrega/>
                  <NombreEntrega/>
                  <RutEntrega/>
                  <Estado>PENDIENTE DE ENTREGA. CONTACTAR SERVICIO AL CLIENTE CORREOSCHILE</Estado>
                  <Referencia>ref9900XXXXXXX</Referencia>
                  <HistorialLen>13</HistorialLen>
                  <Historial>
                     <Estruct_Historial>
                        <HisFecha>03/02/2021 17:09</HisFecha>
                        <HisEstadoDes>RECIBIDO EN PLANTA ORIGEN</HisEstadoDes>
                        <HisOficinaOrigenDes>PLANTA CEP RM</HisOficinaOrigenDes>
                     </Estruct_Historial>
                     <Estruct_Historial>
                        <HisFecha>04/02/2021 09:07</HisFecha>
                        <HisEstadoDes>ENVIO EN REPARTO</HisEstadoDes>
                        <HisOficinaOrigenDes>PLANTA CEP RM</HisOficinaOrigenDes>
                     </Estruct_Historial>
                     <Estruct_Historial>
                        <HisFecha>04/02/2021 14:13</HisFecha>
                        <HisEstadoDes>ENVIO NO PUDO SER ENTREGADO</HisEstadoDes>
                        <HisOficinaOrigenDes>PLANTA CEP RM</HisOficinaOrigenDes>
                     </Estruct_Historial>
                     <Estruct_Historial>
                        <HisFecha>05/02/2021 09:06</HisFecha>
                        <HisEstadoDes>ENVIO EN REPARTO</HisEstadoDes>
                        <HisOficinaOrigenDes>PLANTA CEP RM</HisOficinaOrigenDes>
                     </Estruct_Historial>
                     <Estruct_Historial>
                        <HisFecha>05/02/2021 16:34</HisFecha>
                        <HisEstadoDes>ENVIO NO PUDO SER ENTREGADO</HisEstadoDes>
                        <HisOficinaOrigenDes>PLANTA CEP RM</HisOficinaOrigenDes>
                     </Estruct_Historial>
                     <Estruct_Historial>
                        <HisFecha>08/02/2021 09:08</HisFecha>
                        <HisEstadoDes>ENVIO EN REPARTO</HisEstadoDes>
                        <HisOficinaOrigenDes>PLANTA CEP RM</HisOficinaOrigenDes>
                     </Estruct_Historial>
                     <Estruct_Historial>
                        <HisFecha>08/02/2021 16:33</HisFecha>
                        <HisEstadoDes>ENVIO NO PUDO SER ENTREGADO</HisEstadoDes>
                        <HisOficinaOrigenDes>PLANTA CEP RM</HisOficinaOrigenDes>
                     </Estruct_Historial>
                     <Estruct_Historial>
                        <HisFecha>09/02/2021 11:12</HisFecha>
                        <HisEstadoDes>ENVIO EN REPARTO</HisEstadoDes>
                        <HisOficinaOrigenDes>PLANTA CEP RM</HisOficinaOrigenDes>
                     </Estruct_Historial>
                     <Estruct_Historial>
                        <HisFecha>09/02/2021 14:58</HisFecha>
                        <HisEstadoDes>PENDIENTE DE ENTREGA. CONTACTAR SERVICIO AL CLIENTE CORREOSCHILE</HisEstadoDes>
                        <HisOficinaOrigenDes>PLANTA CEP RM</HisOficinaOrigenDes>
                     </Estruct_Historial>
                     <Estruct_Historial>
                        <HisFecha>04/02/2021 17:53</HisFecha>
                        <HisEstadoDes>NO HAY QUIEN RECIBA ENVÃO EN DOMICILIO</HisEstadoDes>
                        <HisOficinaOrigenDes>PLANTA CEP RM</HisOficinaOrigenDes>
                     </Estruct_Historial>
                     <Estruct_Historial>
                        <HisFecha>05/02/2021 20:16</HisFecha>
                        <HisEstadoDes>NO HAY QUIEN RECIBA ENVÃO EN DOMICILIO</HisEstadoDes>
                        <HisOficinaOrigenDes>PLANTA CEP RM</HisOficinaOrigenDes>
                     </Estruct_Historial>
                     <Estruct_Historial>
                        <HisFecha>08/02/2021 20:38</HisFecha>
                        <HisEstadoDes>NO HAY QUIEN RECIBA ENVÃO EN DOMICILIO</HisEstadoDes>
                        <HisOficinaOrigenDes>PLANTA CEP RM</HisOficinaOrigenDes>
                     </Estruct_Historial>
                     <Estruct_Historial>
                        <HisFecha>09/02/2021 11:12</HisFecha>
                        <HisEstadoDes>DIRECCIÃ“N DE ENTREGA ES INSUFICIENTE/INCORRECTA</HisEstadoDes>
                        <HisOficinaOrigenDes>PLANTA CEP RM</HisOficinaOrigenDes>
                     </Estruct_Historial>
                  </Historial>
               </Estruct_Envio>
            </Envio>
            <Largo>1</Largo>
            <Indice>0</Indice>
            <TipoError/>
         </ConsultaEnvioResult>
      </ConsultaEnvioResponse>
   </soap:Body>
</soap:Envelope>

Error

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema">
   <soap:Body>
      <ConsultaEnvioResponse xmlns="http://tempuri.org/">
         <ConsultaEnvioResult>
            <Envio/>
            <Largo>0</Largo>
            <Indice>-1</Indice>
            <TipoError>004</TipoError>
         </ConsultaEnvioResult>
      </ConsultaEnvioResponse>
   </soap:Body>
</soap:Envelope>

Códigos de error

Código	Descripción
000	Error al validar usuario.
002	Password incorrecta.
003	Usuario no registrado.
004	Código de cliente erróneo.
005	Código de envío proporcionado por CorreosChile o número de referencia del cliente vacío.

Ejemplos

using RestSharp;
using System;
using System.Collections.Generic;
using System.IO;
using System.Text;
using System.Xml;

namespace Ejemplos.WsTrazabilidad
{
    public class ServicioTrazabilidad
    {
        private readonly string _url;
        private readonly string _usuario;
        private readonly string _password;
        private readonly string _codigoCliente;

        public ServicioTrazabilidad(string url, string usuario, string password, string codigoCliente)
        {
            _url = url;
            _usuario = usuario;
            _password = password;
            _codigoCliente = codigoCliente;
        }

        public Encabezado ConsultaCabeceraEnvio(string codigo)
        {
            var restClient = new RestClient(_url)
            {
                Timeout = -1
            };
            WsTrazabilidadException wsTrazabilidadException = null;
            Encabezado encabezado = null;
            try
            {
                var stringBuilder = new StringBuilder();
                stringBuilder.AppendLine("<soapenv:Envelope xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" xmlns:tem=\"http://tempuri.org/\">");
                stringBuilder.AppendLine("<soapenv:Header/>");
                stringBuilder.AppendLine("<soapenv:Body>");
                stringBuilder.AppendLine("<tem:ConsultaCabeceraEnvio>");
                stringBuilder.AppendLine("<tem:PEnvio>");
                stringBuilder.AppendLine("<tem:Codigo>" + codigo + "</tem:Codigo>");
                stringBuilder.AppendLine("<tem:CodigoCliente>" + _codigoCliente + "</tem:CodigoCliente>");
                stringBuilder.AppendLine("<tem:Usuario>" + _usuario + "</tem:Usuario>");
                stringBuilder.AppendLine("<tem:Password>" + _password + "</tem:Password>");
                stringBuilder.AppendLine("</tem:PEnvio>");
                stringBuilder.AppendLine("</tem:ConsultaCabeceraEnvio>");
                stringBuilder.AppendLine("</soapenv:Body>");
                stringBuilder.AppendLine("</soapenv:Envelope>");

                var request = new RestRequest(Method.POST);
                request.AddHeader("Content-Type", "text/xml");
                request.AddParameter("text/xml", stringBuilder.ToString(), ParameterType.RequestBody);
                IRestResponse restResponse = restClient.Execute(request);

                switch (restResponse.StatusCode)
                {
                    case System.Net.HttpStatusCode.OK:
                        try
                        {
                            var xmlDocument = new XmlDocument();
                            using (StringReader stringReader = new StringReader(restResponse.Content))
                            {
                                xmlDocument.Load(stringReader);
                            }
                            XmlNamespaceManager xmlNamespaceManager = new XmlNamespaceManager(xmlDocument.NameTable);
                            xmlNamespaceManager.AddNamespace("soap", "http://schemas.xmlsoap.org/soap/envelope/");
                            var xmlResults = xmlDocument.SelectNodes("soap:Envelope/soap:Body", xmlNamespaceManager);
                            foreach (XmlNode xmlResult in xmlResults)
                            {
                                var xmlEnvioResult = xmlResult["ConsultaCabeceraEnvioResponse"]["ConsultaCabeceraEnvioResult"];
                                if(int.TryParse(xmlEnvioResult["Indice"].InnerText, out int indice))
                                {
                                    if (indice >= 0)
                                    {
                                        var xmlEnvio = xmlEnvioResult["Envio"]["Estruct_Envio"];
                                        encabezado = new Encabezado
                                        {
                                            Tipo = "env",
                                            Envio = xmlEnvio["Envio"] == null ? "" : xmlEnvio["Envio"].InnerText,
                                            FechaEntrega = xmlEnvio["FechaEntrega"] == null ? "" : xmlEnvio["FechaEntrega"].InnerText,
                                            NombreEntrega = xmlEnvio["NombreEntrega"] == null ? "" : xmlEnvio["NombreEntrega"].InnerText,
                                            RutEntrega = xmlEnvio["RutEntrega"] == null ? "" : xmlEnvio["RutEntrega"].InnerText,
                                            Referencia = xmlEnvio["Referencia"] == null ? "" : xmlEnvio["Referencia"].InnerText,
                                            EstadoDes = xmlEnvio["Estado"] == null ? "" : xmlEnvio["Estado"].InnerText
                                        };
                                    }
                                }
                            }
                        }
                        catch(Exception exception)
                        {
                            wsTrazabilidadException = new WsTrazabilidadException("Ocurrio un error intentando leer el xml de la trazabilidad.", exception);
                        }
                        break;
                    default:
                        wsTrazabilidadException = new WsTrazabilidadException("Ocurrio un error intentando obtener la trazabilidad.");
                        break;
                }
            }
            catch (Exception exception)
            {
                wsTrazabilidadException = new WsTrazabilidadException("Ocurrio un error intentando obtener la trazabilidad.", exception);
            }
            if (wsTrazabilidadException != null)
            {
                throw wsTrazabilidadException;
            }
            if (encabezado != null && string.IsNullOrWhiteSpace(encabezado.EstadoDes))
            {
                return null;
            }
            return encabezado;
        }
    }

    public class Encabezado
    {
        public string Tipo { get; set; }
        public string Envio { get; set; }
        public string EstadoDes { get; set; }
        public string Referencia { get; set; }
        public string FechaEntrega { get; set; }
        public string NombreEntrega { get; set; }
        public string RutEntrega { get; set; }
        public string EstadoBase { get; set; }

        public Encabezado()
        {
            EstadoBase = "";
        }
    }

    public class WsTrazabilidadException : Exception
    {
        public bool ErrorCritico { get; set; }
        public WsTrazabilidadException(string message, bool errorCritico = true) : base(message)
        {
            ErrorCritico = errorCritico;
        }
        public WsTrazabilidadException(string message, Exception innerException, bool errorCritico = true) : base(message, innerException)
        {
            ErrorCritico = errorCritico;
        }
    }
}

Métodos

Métodos

Métodos

Trazabilidad

URLs

Ambiente certificación

Ambiente producción

Parámetros

Request

Response

Error

Códigos de error

Ejemplos