Cotizador de Envíos
- Permite realizar un análisis de valores para el envío de productos según se requiera, previo a la generación de la solicitud o guía electrónica; ésto se genera a través del Web Service Integrador de URBANO, Ejemplo en PHP para mayor información VER Anexo 5 y Tabla: 5.
- Para la implementación tenga en cuenta los siguientes métodos:
DESCRIPCION DE METODOS
Parámetros de envío
El cuerpo de la solicitud incluye un solo parámetro codificado en URL llamado json, que contiene un objeto JSON con los siguientes campos:
| Tag | Tipo | Longitud | Requerido | Ejemplo | Descripción |
|---|---|---|---|---|---|
| linea | Numérico | 1 | Si | 3 | 1: Postal, 2: Valorados, 3: Logistica |
| id_contrato | Numérico | 9 | Si | 1722 | Proporsionado por Urbano |
| origen | Alfanumérico | 5 | Si | 13101 | Código único de comuna (Código INE) |
| destino | Alfanumérico | 5 | Si | 05101 | Código único de comuna (Código INE) |
| peso | Numérico | 4 | Si | En Kilogramos | |
| alto | Numérico | 5 | Si | En centimetros | |
| largo | Numérico | 5 | Si | En centimetros | |
| ancho | Numérico | 5 | Si | En centimetros | |
| tipo_empaque | Alfanumérico | 2 | Si | PQ | Código del tipo de empaque, por defecto debe ser PQ |
| seguro | Numérico | Valor del producto en CLP en caso de contar con seguro adicional |
https://app.urbanoexpress.cl/ws/ue/cotizarenvio
Método HTTP
POST
Método HTTP
Cabeceras Requeridas
user: Identificación del usuario para acceder al servicio.
pass: Contraseña o token de autenticación.
Content-Type: Tipo de contenido de la solicitud. Valor: application/x-www-form-urlencoded
cURL de Ejemplo
curl --location 'https://app.urbanoexpress.cl/ws/ue/cotizarenvio' --header 'user: {{USER}}' --header 'pass: {{PASS}}' --header 'Content-Type: application/x-www-form-urlencoded' --data-urlencode 'json={"linea":"3","id_orden":"1078","origen":"13123","destino":"05101","peso":"2","alto":"15","largo":"15","ancho":"15","tipo_empaque":"PQ","seguro":"100000"}'
DESCRIPCIÓN DE PARÁMETROS DE SALIDA DE LOS MÉTODOS USADOS
A continuación, se detallan los métodos y una breve descripción de los parámetros de salida de cada método:
Esquema de respuesta
A continuación, se muestran algunos mensajes que puede devolver el Web Services:
Cotización Generada Correctamente
[
{
"error_sql": "0",
"error_info": "",
"id_servicio": "1",
"servicio": "Distribucion",
"valor_ennvio": "3304.00",
"time_envio": "1 00:00",
"valor_envio_aereo": "0.00",
"time_aereo": "0 00:00"
},
{
"error_sql": "0",
"error_info": "",
"id_servicio": "3",
"servicio": "Seguro",
"valor_ennvio": "0.00"
}
]
Error en el Proceso:
[
{
"error_sql": "-1",
"error_info": "Origen no valido ...",
"id_servicio": "0",
"servicio": "",
"valor_ennvio": "0.00"
}
]
DESCRIPCIÓN DE MOVIMIENTOS:
| Campo | Descripción |
|---|---|
| error_sql | Indica el código del error, pero también como un contador de la cantidad de check points enviados por este método |
| error_info | Indica la descripción del error en caso de que hubiera uno, si es que hay error es menos < cero, caso contrario es cero |
| id_servicio | Indica el numero servicio |
| Servicio | Indica el nombre del servicio |
| valor_envio | Indica el valor del envio |
| time_envio | Indica el tiempo que se demora en llegar el envio |
| valor_envio_aereo | Indica el valor del envío aéreo |
| time_aereo | Indica el tiempo que se demora en llegar el envío aéreo |
CONSIDERACIONES IMPORTANTES
- Para el envío de direcciones se debe coordinar previamente con Urbano, con la finalidad de poderles compartir la tabla de cobertura (comunas).
- Es importante que el envío de información sea en base a los servicios contratados por el cliente.
- Urbano es quien provee las credenciales de acceso para el consumo del Web Service, la información en las imágenes adjuntas son ejemplos genéricos.