Servicio de Tracking Urbano (GET) - Documentación Técnica

1. Descripción Técnica del Servicio

Este servicio permite consultar el estado detallado de una guía específica mediante una solicitud HTTP GET. La consulta se realiza utilizando un único parámetro llamado json, que debe ser incluido en la URL como parte de la cadena de consulta (query string).

El valor del parámetro json debe ser una cadena JSON válida, con campos como "guia", "docref" y "vp_linea". Es importante destacar que estos datos viajan en la URL, y no en el cuerpo de la petición, lo que puede generar confusión al compararse con métodos POST.

Al final de esta página, puede utilizar el botón "Abrir Formulario de Prueba" para ingresar datos y generar automáticamente ejemplos de código en cURL, PHP y Java listos para usar.

2. Endpoint

URL: https://app.urbanoexpress.cl/ws/ue/tracking/

Método: GET

3. Encabezados HTTP requeridos

user: Usuario autorizado
pass: Contraseña del servicio

4. Parámetros (en el campo `json`)

Campo	Tipo	Descripción	Obligatorio
`guia`	String	Número de guía a consultar	No
`docref`	String	Campo de referencia opcional	No
`vp_linea`	String	Código de línea operativa	Sí

5. Ejemplo de Petición

curl -G "https://app.urbanoexpress.cl/ws/ue/tracking/" \
  --data-urlencode 'json={"guia":"WB174333000","docref":"","vp_linea":"3"}' \
  -H "user: {{user}}" \
  -H "pass: {{pass}}"

6. Ejemplo de Respuesta

[
    {
        "sql_error": "1",
        "msg_error": "Ok",
        "guia": "WB186756797",
        "servicio": "CONVATEC",
        "origen": "SCL",
        "f_ingreso": "18/06/2024",
        "destino": "CCP",
        "chk": "EN",
        "estado": "ENTREGADO",
        "sub_estado": "ENTREGADO A TERCERO",
        "fecha": "21/06/2024",
        "hora": "14:03",
        "docref": "82893",
        "codigo_cliente": "2[-10227065",
        "cliente": "Ilustre Municipalidad De Lebu - ilustre municipalidad de lebu",
        "direccion": "IGNACIO CARRERA PINTO 1441   Int.",
        "cli_refere": "",
        "ciudad": "LEBU - BIOBIO",
        "tipo_zona": "Rural",
        "cli_telefono": "",
        "contenido": "- Insumos medicos",
        "piezas": "4",
        "peso": "12.80",
        "peso_volumen": "26.74",
        "remite": "Ceva Freight Management Logistica De Chile Ltda. (Abraham Aquino)",
        "dir_remite": "AV. LO BOZA 120, MODULO D, OF. 2   Int.",
        "ciudad_ubigeo": "PUDAHUEL - SANTIAGO",
        "cod_service": "NO",
        "cod_montos": "0.00",
        "cod_estado": "",
        "cod_fecha": "",
        "cant_cedibles": "1",
        "tipo": "G",
        "guia_pieza": "18675679",
        "nro_pieza": "0",
        "guia_numero": "18675679",
        "seguro_env": "NO",
        "movimientos": [
            {
                "chk": "SS",
                "fecha": "18/06/2024",
                "hora": "15:53",
                "estado": "SOLICITUD DE SERVICIO",
                "sub_estado": "Pick Up (File)",
                "apunts": "",
                "agencia": "SCL",
                "gps_px": "0",
                "gps_py": "0"
            },
            {
                "chk": "AO",
                "fecha": "18/06/2024",
                "hora": "19:29",
                "estado": "ADMITIDO EN HUB",
                "sub_estado": "Arribo En Origen",
                "apunts": "",
                "agencia": "SCL",
                "gps_px": "0",
                "gps_py": "0"
            },
            {
                "chk": "DD",
                "fecha": "18/06/2024",
                "hora": "22:07",
                "estado": "DESPACHADO A DESTINO",
                "sub_estado": "Despacho A Destino",
                "apunts": "De:SCL --> Hacia:CCP ID : 1037997",
                "agencia": "SCL",
                "gps_px": "0",
                "gps_py": "0"
            },
            {
                "chk": "AD",
                "fecha": "19/06/2024",
                "hora": "06:47",
                "estado": "ARRIBADO EN DESTINO",
                "sub_estado": "Arribo Agencia (Manual)",
                "apunts": "En:CCP <-- Desde:SCL",
                "agencia": "CCP",
                "gps_px": "0",
                "gps_py": "0"
            },
            {
                "chk": "ER",
                "fecha": "21/06/2024",
                "hora": "07:14",
                "estado": "SALIO A RUTA",
                "sub_estado": "En Ruta",
                "apunts": "IBANEZ MONTECINOS (KVYP-80) - Ruta:80002",
                "agencia": "CCP",
                "gps_px": "0",
                "gps_py": "0"
            },
            {
                "chk": "EN",
                "fecha": "21/06/2024",
                "hora": "14:03",
                "estado": "ENTREGADO",
                "sub_estado": "Entregado A Tercero",
                "apunts": "Firma : Victor Torres (DNI:179126710)",
                "agencia": "CCP",
                "gps_px": "-37.59798",
                "gps_py": "-73.64206",
                "img": [
                    {
                        "img_path": "https://storage.googleapis.com/18044417_20240621_140133.jpg",
                        "img_px": "-37.59798",
                        "img_py": "-73.64206"
                    },
                    {
                        "img_path": "https://storage.googleapis.com/18044417_20240621_140138.jpg",
                        "img_px": "-37.59798",
                        "img_py": "-73.64206"
                    },
                    {
                        "img_path": "https://storage.googleapis.com/18044417_20240621_140142.jpg",
                        "img_px": "-37.59798",
                        "img_py": "-73.64206"
                    },
                    {
                        "img_path": "https://storage.googleapis.com/18044417_20240621_140148.jpg",
                        "img_px": "-37.59798",
                        "img_py": "-73.64206"
                    }
                ]
            },
            {
                "chk": "RA",
                "fecha": "24/06/2024",
                "hora": "15:38",
                "estado": "POD RENDIDO A ORIGEN",
                "sub_estado": "Pod Rendido A Origen",
                "apunts": "De:CCP --> Hacia:SCL Rendicion:5646",
                "agencia": "CCP",
                "gps_px": "0",
                "gps_py": "0"
            },
            {
                "chk": "AA",
                "fecha": "25/06/2024",
                "hora": "13:07",
                "estado": "POD ADMITIDO EN ORIGEN",
                "sub_estado": "Pod Admitido En Origen(Manual)",
                "apunts": "",
                "agencia": "SCL",
                "gps_px": "0",
                "gps_py": "0"
            },
            {
                "chk": "LA",
                "fecha": "25/06/2024",
                "hora": "16:02",
                "estado": "POD LIQUIDADO",
                "sub_estado": "Liquidado Al Shipper",
                "apunts": "Contacto::Abraham Aquino (ID :73038)",
                "agencia": "SCL",
                "gps_px": "0",
                "gps_py": "0"
            }
        ],
        "img": [
            {
                "img_path": "",
                "img_fecha": "",
                "img_hora": "",
                "n_visita": "0"
            }
        ],
        "piezas_estado": [
            {
                "piezas": "PK220570819CCP",
                "estado": "YA FUE ENTREGADO (ENTREGADO A TERCERO)",
                "fecha_estado": "21/06/2024",
                "hora_estado": "14:03",
                "estado_id": "EN"
            },
            {
                "piezas": "PK220570827CCP",
                "estado": "YA FUE ENTREGADO (ENTREGADO A TERCERO)",
                "fecha_estado": "21/06/2024",
                "hora_estado": "14:03",
                "estado_id": "EN"
            },
            {
                "piezas": "PK220570835CCP",
                "estado": "YA FUE ENTREGADO (ENTREGADO A TERCERO)",
                "fecha_estado": "21/06/2024",
                "hora_estado": "14:03",
                "estado_id": "EN"
            },
            {
                "piezas": "PK220570843CCP",
                "estado": "YA FUE ENTREGADO (ENTREGADO A TERCERO)",
                "fecha_estado": "21/06/2024",
                "hora_estado": "14:03",
                "estado_id": "EN"
            }
        ]
    }
]

7. Notas Adicionales

Las respuestas pueden contener campos vacíos si no hay información registrada.
El campo movimientos refleja el historial logístico de la guía.
La combinación estado + sub_estado puede mapearse a un Macro Estado según tabla de equivalencias.
Los headers user y pass deben ser provistos por el equipo de soporte de Urbano.

Estructura de la Respuesta Exitosa - Servicio Tracking Urbano

1. Campos Principales

Campo	Tipo	Descripción
sql_error	String	Indica si hubo error SQL (1 = sin error).
msg_error	String	Mensaje general de estado de respuesta.
guia	String	Número de guía consultada.
servicio	String	Nombre del servicio utilizado.
origen	String	Código de ciudad de origen.
f_ingreso	String	Fecha de ingreso al sistema (dd/mm/yyyy).
destino	String	Código de ciudad de destino.
chk	String	Último código de estado registrado.
estado	String	Último estado registrado.
sub_estado	String	Subestado del último evento.
fecha / hora	String	Fecha y hora del último evento registrado.
docref	String	Referencia asociada al cliente.
codigo_cliente	String	Código interno del cliente.
cliente	String	Nombre del cliente.
direccion	String	Dirección de entrega.
ciudad	String	Ciudad y región destino.
tipo_zona	String	Rural o Urbano.
contenido	String	Descripción del contenido.
piezas	String	Número total de bultos.
peso	String	Peso físico en kg.
peso_volumen	String	Peso volumétrico.
remite	String	Nombre del remitente.
dir_remite	String	Dirección del remitente.
ciudad_ubigeo	String	Ciudad y comuna de origen.
cod_service	String	SI/NO, si aplica cobro en destino.
cod_montos	String	Monto asociado al servicio adicional.
seguro_env	String	SI/NO, si aplica seguro.
cant_cedibles	String	Cantidad de unidades cedibles.
guia_pieza	String	Versión corta del número de guía.
nro_pieza	String	Número individual de pieza.
tipo	String	Tipo de guía (ej. G = general).

2. Campo movimientos[]

Campo	Tipo	Descripción
chk	String	Código del evento logístico.
fecha	String	Fecha del evento (dd/mm/yyyy).
hora	String	Hora del evento.
estado	String	Descripción del estado general.
sub_estado	String	Descripción específica del evento.
apunts	String	Observaciones internas.
agencia	String	Agencia donde ocurrió el evento.
gps_px	String	Latitud (si aplica).
gps_py	String	Longitud (si aplica).
img[]	Array	Imágenes asociadas al evento.

3. Campo piezas_estado[]

Campo	Tipo	Descripción
piezas	String	ID de la pieza individual.
estado	String	Estado completo de la pieza.
fecha_estado	String	Fecha del último estado.
hora_estado	String	Hora del último estado.
estado_id	String	Código del estado (ej: EN).

Respuesta con Error - Servicio Tracking Urbano

1. Estructura General

Cuando ocurre un error (por ejemplo, credenciales inválidas o problema interno), el servicio retorna una respuesta en formato JSON con la siguiente estructura:

Ejemplo:

[
  {
    "sql_error": "-1",
    "msg_error": "Ocurrio un error al tratar validar el usuario"
  }
]

2. Campos de la Respuesta con Error

Campo	Tipo	Descripción
sql_error	String	Valor `"-1"` indica que ocurrió un error en la ejecución del servicio.
msg_error	String	Mensaje de error explicando la causa (ej. usuario inválido, error interno, etc.).

3. Notas

Este tipo de respuesta puede devolverse incluso con código HTTP 200.
Es responsabilidad del consumidor del servicio validar el campo sql_error.
Errores comunes incluyen autenticación incorrecta, estructura malformada del parámetro json, o problemas internos del servidor.

Guía No Disponible - Servicio Tracking Urbano

1. Estructura General

Si el número de guía ingresado no está disponible para el usuario autenticado, el sistema retorna una estructura de error con el siguiente contenido:

Ejemplo:

[
  {
    "sql_error": "-1",
    "msg_error": "Error en el Numero de GE a Rastrear"
  }
]

2. Descripción de Campos

Campo	Tipo	Descripción
sql_error	String	Siempre `"-1"` para indicar que ocurrió un error de validación.
msg_error	String	Mensaje que indica que la guía no está habilitada para consulta por este usuario.

3. Notas

Este error se devuelve cuando la guía no existe, o no está asociada al usuario autenticado.
No debe interpretarse como una guía con movimientos vacíos, sino como un rechazo de acceso a los datos.
El código HTTP puede seguir siendo 200, por lo que se debe validar sql_error.

Estados del Tracking - Servicio Tracking Urbano

A continuación se presenta la tabla de equivalencias de estados utilizados por el servicio de tracking, incluyendo su código, descripción, subestado y macro estado:

chk_codigo	Estado	mot_codigo	Sub Estado	Macro Estado
PU	SOLICITUD DE SERVICIO	PC	Pick UP (Auto)	Orden
PU	SOLICITUD DE SERVICIO	PD	PENDIENTE	Orden
PU	SOLICITUD DE SERVICIO	PU	Pick UP (File)	Orden
AO	ADMITIDO EN HUB	AS	ARRIBO EN ORIGEN	Arribado
DD	DESPACHADO A DESTINO	DD	DESPACHO A DESTINO	Despachado
DD	DESPACHADO A DESTINO	LDR	Re - Despachado	Despachado
AR	ARRIBADO EN DESTINO	AM	ARRIBO AGENCIA (Manual)	Arribado
AR	ARRIBADO EN DESTINO	AR	ARRIBO AGENCIA (Auto)	Arribado
AR	ARRIBADO EN DESTINO	DLR	Admitido Para Redespacho	Arribado
EE	ERROR DE DIRECCION	EE	ERROR DE DIRECCION	Problemas de entrega
RD	RE - Despacho	MR	Re-Despacho	Despachado
AT	ADMITIDO EN TRANSITO	AET	Arribado en Transito	Arribado
ER	SALIO A RUTA	LD	EN RUTA	En Ruta
ER	SALIO A RUTA	LDP	SALIDA PARCIAL	En Ruta
CA	VISITADO SIN ENTREGA	1	Direccion Insuficiente	Problemas de entrega
CA	VISITADO SIN ENTREGA	2	Cambio Domicilio/Trabajo	Problemas de entrega
CA	VISITADO SIN ENTREGA	4	Direccion Incorrecta	Problemas de entrega
CA	VISITADO SIN ENTREGA	5	No Hay Quien Reciba	Problemas de entrega
CA	VISITADO SIN ENTREGA	6	No Desea Recibir Titular	Problemas de entrega
CA	VISITADO SIN ENTREGA	119	LOCAL CERRADO	Problemas de entrega
CA	VISITADO SIN ENTREGA	CP	No Dispone de Habilitante	Problemas de entrega
CA	VISITADO SIN ENTREGA	SA	No Cobertura/Inaccesible	Problemas de entrega
NT	INCIDENCIA EN RUTA	BH	Bloqueo Por Huelga	Problemas de entrega
NT	INCIDENCIA EN RUTA	DN	Desastre Natural	Problemas de entrega
NT	INCIDENCIA EN RUTA	FM	Falla Mecanica	Problemas de entrega
NT	INCIDENCIA EN RUTA	NT	No Hubo Tiempo	Problemas de entrega
EN	ENTREGADO	RC	ENTREGA EN RECEPCION	Entregado
EN	ENTREGADO	TE	ENTREGADO A TERCERO	Entregado
EN	ENTREGADO	UR	ENTREGA OFICINA URBANO	Entregado
EP	ENTREGA PARCIAL	PAG	EN AGENCIA	Entregado
EP	ENTREGA PARCIAL	PFA	A TERCERO	Entregado
EP	ENTREGA PARCIAL	PVG	EN RECEPCION	Entregado
MR	Mal Ruteo	MR	Mal Ruteo	Problemas de entrega
TR	TRANSFERIDO EN RUTA	TR	Transferido a otra Ruta	En Ruta
RV	PROD. DEVUELTO A ORIGEN	RE	DIRECCION INCORRECTA	Problemas de entrega
RV	PROD. DEVUELTO A ORIGEN	RF	NO HAY QUIEN RECIBA	Problemas de entrega
RV	PROD. DEVUELTO A ORIGEN	RH	NO DESEA RECIBIR TITULAR	Problemas de entrega
RV	PROD. DEVUELTO A ORIGEN	RQ	DIRECCION INSUFICIENTE	Problemas de entrega
SN	ENVIO SINIESTRADO	SRT	Perdido en Ruta	Problemas de entrega
RCO	Recoleccion en Espera	LPR	Llegó a Dirección de Recolección	Orden
RCF	Recolección Confirmada	RCF	Recolección Diario Confirmado	Orden
RCF	Recolección Confirmada	RDC	Recolección Express Confirmado	Orden
RPA	Recolectado	RCO	Recoleccion Completa	Orden
RPA	Recolectado	RPA	Recoleccion Parcial	Orden

Servicio de Tracking Urbano (GET) - Documentación Técnica

1. Descripción Técnica del Servicio

2. Endpoint

3. Encabezados HTTP requeridos

4. Parámetros (en el campo json)

5. Ejemplo de Petición

6. Ejemplo de Respuesta

7. Notas Adicionales

Estructura de la Respuesta Exitosa - Servicio Tracking Urbano

1. Campos Principales

2. Campo movimientos[]

3. Campo piezas_estado[]

Respuesta con Error - Servicio Tracking Urbano

1. Estructura General

Ejemplo:

2. Campos de la Respuesta con Error

3. Notas

Guía No Disponible - Servicio Tracking Urbano

1. Estructura General

Ejemplo:

2. Descripción de Campos

3. Notas

Estados del Tracking - Servicio Tracking Urbano

4. Parámetros (en el campo `json`)