[email protected]

Seguimiento de Envíos

    Consiste en rastrear a través de la opción Tracking del Web Service Integrador de URBANO, cada entrega o despacho registrado en el sistema, además permite conocer en detalle el estado de la entrega.
    Para la implementación tenga en cuenta los siguientes métodos

DESCRIPCION DE METODOS

A continuación se detallan los parámetros de envío y el tipo, también la URL para cada método

Tracking

Se utiliza para extraer la información del envío ya sea por el número de guía electrónica proporcionada previamente por UE o por el código de seguimiento propio del cliente


Si el resultado es vacío o el primer parámetro es -1, significa que la GE o código de seguimiento que está consultando no existe en nuestros sistemas. Tenga en cuenta que se muestra la descripción del error en el segundo parámetro.


Parametro de Envio

Guia: Número de guía (GE) proporcionado por Urbano, en caso de no disponer, se envía "" Tipo de dato:Interger
Docref: Documento de referencia o código de seguimiento propio del cliente, este dato debe ser enviado previamente a Urbano, para relacionar con la Orden de Transporte generada por Urbano para él envío. Tipo de dato: String
VP_línea: Código de seguimiento propio del cliente, este dato debe ser enviado previamente a UE, para relacionar con la GE generada por Urbano para él envío. Tipo de dato: String

URL del Servicio
https://app.urbanoexpress.cl/ws/ue/tracking/?json={"guia":"{{guia}}","docref":"","vp_linea":"3"}

Método
GET


Ejemplo cURL

curl -L -g "https://app.urbanoexpress.cl/ws/ue/tracking/?json={%22guia%22%3A%22WB174333000%22%2C%22docref%22%3A%22%22%2C%22vp_linea%22%3A%223%22}" -H "user: {{user}}" -H "pass: {{pass}}"


Ejemplo Google Apps Script

function Urbano() {
  var guia = "WB177553000";
  var docref = '';
  var vp_linea = '3';

  var data = {
    guia: guia,
    docref: docref,
    vp_linea: vp_linea
  };

  var url = 'https://app.urbanoexpress.cl/ws/ue/tracking/?json=' + encodeURIComponent(JSON.stringify(data));
  var headers = { 'user': '{{user}}', 'pass': '{{pass}}', 'Content-Type': 'application/json', 'Cache-Control': 'no-cache' };

  try {
    var response = UrlFetchApp.fetch(url, { method: 'GET', headers: headers });
    var data = JSON.parse(response.getContentText());
    Logger.log(data);
  } catch (e) {
    Logger.log('Error en la solicitud: ' + e.stack + ' ' + e.message);
    return null;
  }
}

DESCRIPCION DE PARAMETROS DE SALIDA DE LOS METODOS USADOS

A continuacion se detallan los metodos y una breve descripcion de los parametros de salida de cada metodo
[
    {
        "sql_error": "1",
        "msg_error": "Ok",
        "guia": "WB167423086",
        "servicio": "PAQUETERIA",
        "origen": "SCL",
        "f_ingreso": "08/05/2023",
        "destino": "SCL",
        "chk": "EN",
        "estado": "ENTREGADO",
        "sub_estado": "ENTREGADO A TERCERO",
        "fecha": "09/05/2023",
        "hora": "17:41",
        "docref": "",
        "codigo_cliente": "7P-8798813",
        "cliente": "Alexandra Ayleen Daz Maza",
        "direccion": "Mar de Las Antillas 3655   Int.",
        "cli_refere": "",
        "ciudad": "CONCHALI - METROPOLITANA DE SANTIAGO",
        "tipo_zona": "Urbana",
        "cli_telefono": "971748641",
        "contenido": "- Sobres",
        "piezas": "1",
        "peso": "0.50",
        "peso_volumen": "0.15",
        "remite": "Digitapro Spa (Paurany Moya)",
        "dir_remite": "BALMACEDA 489, LT UNICO, OFICINA 405E   Int.",
        "ciudad_ubigeo": "PUENTE ALTO - CORDIL",
        "cod_service": "NO",
        "cod_montos": "0.00",
        "cod_estado": "",
        "cod_fecha": "",
        "cant_cedibles": "0",
        "tipo": "P",
        "guia_pieza": "19275781",
        "nro_pieza": "0",
        "guia_numero": "16742308",
        "seguro_env": "NO",
        "movimientos": [
            {
                "chk": "SS",
                "fecha": "08/05/2023",
                "hora": "10:30",
                "estado": "SOLICITUD DE SERVICIO",
                "sub_estado": "Pick Up (File)",
                "apunts": "",
                "agencia": "SCL",
                "gps_px": "0",
                "gps_py": "0"
            },
            {
                "chk": "AO",
                "fecha": "08/05/2023",
                "hora": "20:19",
                "estado": "ADMITIDO EN HUB",
                "sub_estado": "Arribo En Origen",
                "apunts": "",
                "agencia": "SCL",
                "gps_px": "0",
                "gps_py": "0"
            },
            {
                "chk": "DD",
                "fecha": "08/05/2023",
                "hora": "22:28",
                "estado": "DESPACHADO A DESTINO",
                "sub_estado": "Despacho A Destino",
                "apunts": "",
                "agencia": "SCL",
                "gps_px": "0",
                "gps_py": "0"
            },
            {
                "chk": "AD",
                "fecha": "08/05/2023",
                "hora": "22:28",
                "estado": "ARRIBADO EN DESTINO",
                "sub_estado": "Arribo Agencia (Manual)",
                "apunts": "En:SCL <-- Desde:SCL",
                "agencia": "SCL",
                "gps_px": "0",
                "gps_py": "0"
            },
            {
                "chk": "ER",
                "fecha": "09/05/2023",
                "hora": "04:14",
                "estado": "SALIO A RUTA",
                "sub_estado": "En Ruta",
                "apunts": "IBARRA CARRILLO (HPRF-25) - Ruta:295338",
                "agencia": "SCL",
                "gps_px": "0",
                "gps_py": "0"
            },
            {
                "chk": "EN",
                "fecha": "09/05/2023",
                "hora": "17:41",
                "estado": "ENTREGADO",
                "sub_estado": "Entregado A Tercero",
                "apunts": "Firma : Alexandra Dias (DNI:1674)",
                "agencia": "SCL",
                "gps_px": "-33.39674",
                "gps_py": "-70.68239",
                "img": [
                    {
                        "img_path": "https://storage.googleapis.com/urbano_log_cl/fotos_iridio/20230509/15823764_20230509_174044.jpg",
                        "img_px": "-33.39674",
                        "img_py": "-70.68239"
                    },
                    {
                        "img_path": "https://storage.googleapis.com/urbano_log_cl/fotos_iridio/20230509/15823764_20230509_174050.jpg",
                        "img_px": "-33.39674",
                        "img_py": "-70.68239"
                    },
                    {
                        "img_path": "https://storage.googleapis.com/urbano_log_cl/fotos_iridio/20230509/15823764_20230509_174103.jpg",
                        "img_px": "-33.39674",
                        "img_py": "-70.68239"
                    }
                ]
            }
        ],
        "img": [
            {
                "img_path": "",
                "img_fecha": "",
                "img_hora": "",
                "n_visita": "0"
            }
        ],
        "piezas_estado": [
            {
                "piezas": "PK192757819SCL",
                "estado": "YA FUE ENTREGADO (ENTREGADO A TERCERO)",
                "fecha_estado": "09/05/2023",
                "hora_estado": "17:41",
                "estado_id": "EN"
            }
        ]
    }
]
Metodo 1:get_datos_servicio
Campo Descripción
Envia los datos del servicio
sql_error Indica el código del error en el informix, pero también como un contador de la cantidad de check points enviados por este método
msg_error Indica la descripción del error en caso de que hubiera uno, si no hay errores y se está enviando solo un contador se presenta el mensaje "OK"
guia Indica el numero de guia
servicio indica el servicio
origen indica la ciudad de Origen
f_ingreso Indica la fecha de ingreso de la guia
chk Indica el ultimo check point resgistrado para la guia
estado Indica la descripcion del ultimo check point registrado
fecha Indica la fecha del ultimo check point
docref Indica el numero del Documento de Referencia
cliente Indica el Nombre del Cliente a quien se realiza la entrega
Metodo 2
Campo Descripción
Envia los datos del cliente al que debe llegarle la entrega
sql_error Indica el código del error en el informix, pero también como un contador de la cantidad de check points enviados por este método
msg_error Indica la descripción del error en caso de que hubiera uno, si no hay errores y se está enviando solo un contador se presenta el mensaje "OK"
remite Indica el nombre del Shipper o cliente que hace uso de este Web Service
direccion Indica la dirección de entrega del cliente al que le debe llegar su pedido
tipo Indica el tipo de zona: Periférico, Rural o Urbano
piezas Indica el tipo de zona: Periférico, Rural o Urbano
peso Indica el peso de la entrega
destinatario Indica el nombre del destinatario
contenido Indica el contenido de la entrega
Metodo 3
Campo Descripción
Envía los datos históricos de la entrega, este método puede enviar varios registros
sql_error Indica el código del error en el informix, pero también como un contador de la cantidad de check points enviados por este método
msg_error Indica la descripción del error en caso de que hubiera uno, si no hay errores y se está enviando solo un contador se presenta el mensaje "OK"
chk Indica el check point
fecha Indica la fecha en la que se registro el chek point
hora Indica la hora en la que se registro el check point
detalle Indica el detalle es decir la descripcion del check point
apunts Indica las observaciones que se huieran registrado con el check point
agencia Indica la agencia en la que se registro el check point
2 Esquema de Movimientos
Consiste en las respuestas de los movimientos de la guía electrónica, a continuación detallamos los siguientes:
Solicitud de Servicio:Consiste en la generación de nuevas Guias
[0] => Array ( [chk] => SS [fecha] => 27/06/2018 [hora] => 17:26 [estado] => SOLICITUD DE SERVICIO [sub_estado] => Pick Up (Manual) [apunts] => [agencia] => SCL [gps_px] => 0 [gps_py] => 0
Admitido en HUB:Las guías con este motivo son aquellas que se encuentran arribadas en origen.
[1] => Array ( [chk] => AO [fecha] => 27/06/2018 [hora] => 17:27 [estado] => ADMITIDO EN HUB [sub_estado] => Arribo En Origen [apunts] => [agencia] => SCL [gps_px] => 0 [gps_py] => 0 )
Despachado A Destino:Guías con este motivo son aquellas que se encuentran despachadas a su destino.
Guías con este motivo son aquellas que se encuentran despachadas a su destino.
Arribado de Destino:Guias con este motivo son aquellas que se encuentran arribado en destino
[3] => Array ( [chk] => AD [fecha] => 27/06/2018 [hora] => 17:33 [estado] => ARRIBADO EN DESTINO [sub_estado] => Arribo Agencia (Auto) [apunts] => En:SCL <-- Desde:SCL [agencia] => SCL [gps_px] => 0 [gps_py] => 0 )
Salida a RutaGuias con este motivo son aquellas que se encuentran arribado en destino
[4] => Array ( [chk] => ER [fecha] => 27/06/2018 [hora] => 17:36 [estado] => SALIO A RUTA [sub_estado] => En Ruta [apunts] => ALARCON GATICA (HFKY31) - Ruta:48015 [agencia] => SCL [gps_px] => 0 [gps_py] => 0 )
No Hubo tiempo:Guias con este motivo son aquellas que no se visitaron por falta de tiempo
[5] => Array ( [chk] => NT [fecha] => 15/12/2016 [hora] => 21:09 [estado] => INCIDENCIA EN RUTA [sub_estado] => No Hubo Tiempo [apunts] => [agencia] => SCL [gps_px] => 0 [gps_py] => 0 )
Entrega Efectiva:Guias con este motivo que se visitaron y que si se pudo realizar la Entrega
[5] => Array ( [chk] => EN [fecha] => 27/06/2018 [hora] => 17:36 [estado] => ENTREGADO [sub_estado] => Entrega A Titular [apunts] => Firma : (DNI:) [agencia] => SCL [gps_px] => 0 [gps_py] => 0 )
Entrega No Efectiva:Son aquellas guías que se visitaron, pero que no se pudo efectuar la Entrega.
[5] => Array ( [chk] => CV [fecha] => 02/07/2018 [hora] => 17:53 [estado] => VISITADO [sub_estado] => No Desea Recibir 3Ra. Persona [apunts] => [agencia] => SCL [gps_px] => 0 [gps_py] => 0 )
3 Descripcion de los Movimientos
DESCRIPCION DE MOVIMIENTOS
Campo Descripción
chk Indica el último check point registrado para la guía
estado Indica la descripción del último check point registrado
fecha Indica la fecha del último check poin
hora Indica la hora del último check point
sub_estado Indica la descripción de la subdivisión de un estado.
apunts Indica las observaciones que se hubieran registrado con el check point
agencia Indica la agencia en la que se registró el check point
gps_px Indica la latitud geográfica
gps_py Indica la longitud geográfico
SS Indica el estado de la guía : Solicitud de Servicio
AO Indica el estado de la guía : Admitido en Origen
DD Indica el estado de la guía : Despachadas a su Destino
AD Indica el estado de la guía : Arribado en Destino
ER Indica el estado de la guía : Salió a Ruta
NT Indica el estado de la guía : No hubo tiempo (incidencia en ruta)
EN Indica el estado de la guía : Entregado
CV Indica el estado de la guía : Visitado