Está en la página 1de 19

Documento de Integración Web Services

Tracking Integrado

Autor: Ricardo Moscoso


Fecha: 09-03-2015
Versión: 1.1

1
Contenido

1. Introducción .................................................................................................................................... 3
1.1. Objetivo .................................................................................................................................... 3
2 Detalle del Servicio ........................................................................................................................... 3
2.1 Autenticación del Servicio Web. .............................................................................................. 3
2.1.1 Ejemplo de XML de error................................................................................................... 3
2.2 Métodos del servicio. ................................................................................................................ 4
2.2.1 Obtener Docuemnto : obtenerDocumento ...................................................................... 4
2.2.1.1 Parámetros de entrada : requestObtenerDocumento .................................................. 4
2.2.3 Ejemplo de Request : requestObtenerDocumento ............................................................ 4
2.2.4 Parámetros de salida (responseObtenerDocumento) ...................................................... 4
2.2.5 Ejemplo Response : responseObtenerDocumento ............................................................ 7
2.3 Obtener reserva : obtenerReserva ...................................................................................... 9
2.3.1 Parámetros de entrada: requestObtenerReserva ............................................................. 9
2.3.2 Ejemplo Request : requestObtenerReserva ..................................................................... 10
2.3.3 Parámetros de salida responseObtenerDocumento ....................................................... 10
2.3.4 Ejemplo Response : responseObtenerDocumento .......................................................... 12
2.4 Obtener Tipo Documento : obtenerTipoDocumento ....................................................... 15
2.4.1 Parámetros de entrada: requestObtenerTipoDocumento ............................................. 15
2.4.2 Ejemplo Request : requestObtenerTipoDocumento........................................................ 15
2.4.3 Parámetros de salida responseObtenerTipoDocumento................................................ 15
2.4.4 Ejemplo Response : responseObtenerTipoDocumento ................................................... 15
3 Macro estados. ............................................................................................................................... 16
3.1 Como construir un macro estado............................................................................................ 17
3.2 Tabla de Colores. ..................................................................................................................... 19

2
1. Introducción

1.1. Objetivo

Detallar la integración al Servicio Web de tracking.

Chile
https://portal.bluex.cl/ws_tracking_integrado/BXTRK002TrackingIntegrado?wsdl

2 Detalle del Servicio

2.1 Autenticación del Servicio Web.

La cabecera estándar de cada web service está formada por un:

 String idToken
 String codigoUsuario

Estos valores son comparados con la lista de tokenes asociados al usuario llamador del web
service.

En caso que el idToken y codigoUsuario recibido no esté activo o no corresponda al usuario


recibido, se genera una excepción, que impedirá la realización de la funcionalidad del método y
provocará como retorno a través del elemento SOAP Fault.

2.1.1 Ejemplo de XML de error.


<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<soap:Fault>
<faultcode>soap:Server</faultcode>
<faultstring>Token no encontrado</faultstring>
<detail>
<ns1:BluexException xmlns:ns1="http://ws.bluex.cl/">
<faultCode xsi:type="ns3:FaultCode" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:ns3="http://ws.bluex.cl/"/>
</ns1:BluexException>
</detail>
</soap:Fault>
</soap:Body>
</soap:Envelope>

3
2.2 Métodos del servicio.
2.2.1 Obtener Docuemnto : obtenerDocumento
Identifica los parámetros de entrada necesarios para realizar una búsqueda de un documento.

2.2.1.1 Parámetros de entrada : requestObtenerDocumento

TAG Descripción Valor de ejemplo


codigoEmpresa Empresa a la que pertenece la guía.
cuentaCorriente Cuenta corriente vigente
numeroReferencia Número de referencia asociado al documento.
numeroDocumento Número del documento deseado.
tipoDocumento Tipo del documento que se busca.

2.2.3 Ejemplo de Request : requestObtenerDocumento

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://ws.bluex.cl/">
<soapenv:Header>
<ws:requestHeader>
<idToken>45fa909ab4b6e77806982f42a1337bca</idToken>
<codigoUsuario>2</codigoUsuario>
</ws:requestHeader>
</soapenv:Header>
<soapenv:Body>
<ws:requestObtenerDocumento>
<codigoEmpresa>2000</codigoEmpresa>
<cuentaCorriente>96801150-11-8</cuentaCorriente>
<!--Optional:-->
<numeroReferencia>1</numeroReferencia>
<!--Optional:-->
<numeroDocumento>6165266310</numeroDocumento>
<!--Optional:-->
<tipoDocumento>3</tipoDocumento>
</ws:requestObtenerDocumento>
</soapenv:Body>
</soapenv:Envelope>

2.2.4 Parámetros de salida (responseObtenerDocumento)

TAG Descripción Valor de ejemplo


documento Objeto que contiene datos de la búsqueda
numeroDocumento Numero de documento
idEspecieValorada Numero de especie valorada

4
TAG Descripción Valor de ejemplo
codigoEmpresa Código de la empresa
razonSocial Razón social de la empresa
cuentaCliente Número de cuenta del cliente
codigoTipoServicio Código de tipo de servicio
nombreTipoServicio Nombre tipo de servicio
codigoProducto Código de producto
nombreProducto Nombre de producto
nombreTipoDocumento Nombre del tipo de documento
observaciones Observaciones
tieneMercanciasPeligrosas Identifica si tiene mercancías peligrosas
fechaCreacion Fecha de creación
fechaAnulacion Fecha de anulación
codigoMoneda Código de moneda
valorSeguro Valor del seguro
cantidadPiezas Cantidad de piezas
remitente Objeto que contiene datos del remitente
nombre Nombre del remitente
rut Ruta del remitente
codigoPais Código de país
nombrePais Nombre del país
codigoRegion Código de la región
nombreRegion Nombre de la región
codigoComuna Código de la comuna
nombreComuna Nombre de la comuna
codigoPosta Código de la posta
nombrePosta Nombre de la posta
codigoBase Código de la base
nombreBase Nombre de la base
direccionCompleta Dirección completa
prefijoTelefono Prefijo de teléfono
numeroTelefono Numero de teléfono
anexoTelefono Anexo de teléfono
email Email remitente
destinatario Objeto que contiene datos del destinatario
nombre Nombre del destinatario
rut Rut del destinatario
codigoPais Código de país
nombrePais Nombre del país
codigoRegion Código de la región
nombreRegion Nombre de la región
codigoComuna Código de la comuna
nombreComuna Nobre de la comuna
codigoPosta Código de la posta/localidad
nombrePosta Nombre de la posta/localidad
codigoBase Código de la base
nombreBase Nombre de la base
direccionCompleta Dirección completa
prefijoTelefono Prefijo del teléfono
numeroTelefono Número de teléfono
anexoTelefono Anexo del teléfono

5
TAG Descripción Valor de ejemplo
email Email del destinatario
embalajeTotalizado Objeto que contiene datos del embalaje
codigoUnidadMasa Código de unidad de masa
nombreUnidadMasa Nombre de unidad de masa
codigoUnidadLongitud Código de longitud
nombreUnidadLongitud Nombre unidad de longitud
masa Masa
largo Largo
ancho Ancho
alto Alto
volumen volumen
listaCobrosContraEntrega Objeto que contiene datos de cobros contra entrega
codigoTipoDocumento Código tipo de documento
nombreTipoDocumento Nombre tipo de documento
numeroDocumento Numero de documento
codigoTipoPago Código tipo de pago
nombreTipoPago Nombre tipo de pago
montoPagar Monto a pagar
codigoMoneda Código de moneda
numeroSerieDocto Numero de serie de documento
codigoBancoDocto Código de banco del documento
nombreBancoDocto Nombre del banco del documento
fechaPrimerPago Fecha primer pago
codigoDiaPago Código día de pago
nombreDiaPago Nombre día de pago
listaDocumentosDevolucion Objeto que contiene datos de devolución de documentos
codigoTipoDocumento Código tipo de documento
nombreTipoDocumento Nombre tipo de documento
numeroDocumento Numero de documento
listaNumerosReferencia Objeto que contiene datos de números de referencia
valor Valor de la referencia
listaMacroestados Objeto con datos de macro estados
orden Orden de macro estados
nombre Nombre de macro estado
color Color de macro estado
imagen Imagen de macro estado
listaPinchazosNacionales Objeto que contiene datos de pinchazos nacionales
codigo Código de pinchazo
codigoPieza Código de pieza
cantidadPiezas Cantidad de piezas
pesoPiezas Peso de piezas
fecha Fecha de pinchazo
codigoTipo Tipo código de pinchazo
nombreTipo Nombre de pinchazo
codigoPosta Código de la posta/localidad
nombrePosta Nombre de la posta/localidad
descripcion Descripción
tieneFotoExcepcion Foto excepción
esExcepcion Es excepción
listaPinchazosInternacionales Objeto que contiene datos de pinchazos internacionales

6
TAG Descripción Valor de ejemplo
codigo Codigo pinchazo internacional
codigoPieza Codigo de pieza
cantidadPiezas Cantidad de piezas
pesoPiezas Peso de piezas
fecha Fecha
codigoTipo Tipo de codigo
nombreTipo Nombre de tipo
codigoPosta Codigo pieza
nombrePosta Nombre de posta
descripcion Descripcion
tieneFotoExcepcion Tiene foto excepcion
esExcepcion Es excepcion

2.2.5 Ejemplo Response : responseObtenerDocumento

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:responseObtenerDocumento
xmlns:ns2="http://ws.bluex.cl/BXTRK002_TrackingIntegrado/ResponseObtenerDocumento">
<listaDocumento>
<documento>
<numeroDocumento>6165266310</numeroDocumento>
<idEspecieValorada>138910164</idEspecieValorada>
<codigoEmpresa>2000</codigoEmpresa>
<razonSocial>HUGO FARFAN</razonSocial>
<cuentaCliente>96801150-11-8</cuentaCliente>
<codigoTipoServicio>52</codigoTipoServicio>
<nombreTipoServicio>PREMIUM-P</nombreTipoServicio>
<codigoProducto>P</codigoProducto>
<nombreProducto>PAQUETE</nombreProducto>
<nombreTipoDocumento>ORDEN DE SERVICIO CARGA</nombreTipoDocumento>
<observaciones>PRUEBAS DE WEB SERVICES INTEGRADO CR</observaciones>
<tieneMercanciasPeligrosas>false</tieneMercanciasPeligrosas>
<fechaCreacion>20-02-2015 16:36:38</fechaCreacion>
<codigoMoneda>CLP</codigoMoneda>
<valorSeguro>0</valorSeguro>
<cantidadPiezas>2</cantidadPiezas>
<remitente>
<nombre>HUGO FARFAN</nombre>
<rut-ruc>1-9</rut-ruc>
<codigoPais>CL</codigoPais>
<nombrePais>CHILE</nombrePais>
<codigoRegion>13</codigoRegion>
<nombreRegion>REGION METROPOLITANA DE SANTIAGO</nombreRegion>
<codigoComuna>13101</codigoComuna>
<nombreComuna>SANTIAGO</nombreComuna>
<codigoLocalidad>SCL</codigoLocalidad>
<nombreLocalidad>SANTIAGO</nombreLocalidad>
<codigoBase>SCL</codigoBase>

7
<nombreBase>SANTIAGO</nombreBase>
<direccionCompleta>AVENIDA BRASIL 1778 0</direccionCompleta>
<prefijoTelefono>0</prefijoTelefono>
<numeroTelefono>0</numeroTelefono>
<anexoTelefono>0</anexoTelefono>
<email xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</remitente>
<destinatario>
<nombre>CLAUDIA RAMIREZ</nombre>
<rut-ruc>1-9</rut-ruc>
<codigoPais>CL</codigoPais>
<nombrePais>CHILE</nombrePais>
<codigoRegion>13</codigoRegion>
<nombreRegion>REGION METROPOLITANA DE SANTIAGO</nombreRegion>
<codigoComuna>13101</codigoComuna>
<nombreComuna>SANTIAGO</nombreComuna>
<codigoLocalidad>SCL</codigoLocalidad>
<nombreLocalidad>SANTIAGO</nombreLocalidad>
<codigoBase>SCL</codigoBase>
<nombreBase>SANTIAGO</nombreBase>
<direccionCompleta>AVENIDA EL RETIRO 9800 0</direccionCompleta>
<prefijoTelefono>0</prefijoTelefono>
<numeroTelefono>0</numeroTelefono>
<anexoTelefono>0</anexoTelefono>
<email xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
</destinatario>
<embalajeTotalizado>
<codigoUnidadMasa>KG</codigoUnidadMasa>
<nombreUnidadMasa>Kilogramo</nombreUnidadMasa>
<codigoUnidadLongitud>CM</codigoUnidadLongitud>
<nombreUnidadLongitud>Centimetro</nombreUnidadLongitud>
<masa>12.5</masa>
<largo>10.02</largo>
<ancho>10.02</ancho>
<alto>10.02</alto>
<volumen>0.25</volumen>
</embalajeTotalizado>
<listaCobrosContraEntrega/>
<listaDocumentosDevolucion/>
<listaNumerosReferencia>
<numeroReferencia>
<valor>6409612</valor>
</numeroReferencia>
</listaNumerosReferencia>
<listaMacroestados>
<macroestado>
<orden>1</orden>
<color>GRIS</color>
<imagen/>
</macroestado>
<macroestado>
<orden>2</orden>
<color>GRIS</color>

8
<imagen/>
</macroestado>
<macroestado>
<orden>3</orden>
<color>GRIS</color>
<imagen/>
</macroestado>
<macroestado>
<orden>4</orden>
<color>GRIS</color>
<imagen/>
</macroestado>
<macroestado>
<orden>5</orden>
<color>GRIS</color>
<imagen/>
</macroestado>
</listaMacroestados>
<listaPinchazosNacionales/>
<listaPinchazosInternacionales/>
</documento>
</listaDocumento>
</ns2:responseObtenerDocumento>
</soap:Body>
</soap:Envelope>

2.3 Obtener reserva : obtenerReserva


Permite obtener el tracking de una reserva.

2.3.1 Parámetros de entrada: requestObtenerReserva

TAG Descripción Valor de ejemplo


numeroReserva Número de la reserva.
codigoEmpresa Empresa a la que pertenece la guia.
cuentaCorriente Cuenta corriente vigente

9
2.3.2 Ejemplo Request : requestObtenerReserva

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://ws.bluex.cl/">
<soapenv:Header>
<ws:requestHeader>
<idToken>45fa909ab4b6e77806982f42a1337bca</idToken>
<codigoUsuario>2</codigoUsuario>
</ws:requestHeader>
</soapenv:Header>
<soapenv:Body>
<ws:requestObtenerReserva>
<numeroReserva>9133593</numeroReserva>
<codigoEmpresa>2000</codigoEmpresa>
<cuentaCorriente>96801150-11-8</cuentaCorriente>
</ws:requestObtenerReserva>
</soapenv:Body>
</soapenv:Envelope>

2.3.3 Parámetros de salida responseObtenerDocumento

TAG Descripción Valor de ejemplo


reserva Objeto que contiene datos de una reserva
codigoEmpresa Código de empresa
razonSocialRemitente Razón social remitente
cuentaCliente Cuenta de cliente
codigoTipoServicio Código tipo de servicio
nombreTipoServicio Nombre tipo de servicio
codigoProducto Código de producto
nombreProducto Nombre de producto
observacion Observación
fechaSolicitudRetiro Fecha de solicitud de retiro
fechaRetiro Fecha retiro
horaInicio Hora de inicio
horaTermino Hora de termino
codigoEstadoReserva Código estado de reserva
nombreEstadoReserva Nombre estado de reserva
remitente Objeto que contiene datos del remitente
nombre Nombre remitente
rut Rut remitente
codigoPais Código de país
nombrePais Nombre de país
codigoRegion Código de región
nombreRegion Nombre de región
codigoComuna Código de la comuna
nombreComuna Nombre de la comuna
codigoPosta Código de posta
nombrePosta Nombre de la posta

10
TAG Descripción Valor de ejemplo
codigoBase Código base
nombreBase Nombre de la base
direccionCompleta Dirección completa
direccionDetalle Detalle dirección
prefijoTelefono Pre fijo de teléfono
numeroTelefono Numero de teléfono
anexoTelefono Anexo de teléfono
email Email
nombreContacto Nombre de contacto
prefijoTelefonoContacto Pre fijo teléfono de contacto
numeroTelefonoContacto Numero teléfono de contacto
anexoTelefonoContacto Anexo teléfono de contacto
razonSocialContacto Razón social contacto
destinatario Objeto que contiene datos del destinatario
nombre Nombre del destinatario
rut Rut destinatario
codigoPais Código de país
nombrePais Nombre de país
codigoRegion Código de región
nombreRegion Nombre de región
codigoComuna Código de comuna
nombreComuna Nombre de la comuna
codigoPosta Código de la posta
nombrePosta Nombre posta
codigoBase Código base
nombreBase Nombre base
direccionCompleta Dirección completa
direccionDetalle Dirección detalle
prefijoTelefono Pre fijo teléfono
numeroTelefono Numero de teléfono
anexoTelefono Anexo de teléfono
email Email
nombreContacto Nombre de contacto
prefijoTelefonoContacto Prefijo de teléfono de contacto
numeroTelefonoContacto Numero de teléfono contacto
anexoTelefonoContacto Anexo teléfono contacto
razonSocialContacto Razón social contacto
embalajeTotalizado Objeto que contiene datos del embalaje
codigoUnidadMasa Código unidad de masa
nombreUnidadMasa Nombre unidad de masa
codigoUnidadLongitud Código unidad de longitud
nombreUnidadLongitud Nombre unidad de longitud
masa Masa
largo Largo
ancho Ancho
alto Alto
volumen Volumen
listaDocumentosAsociados Objeto que contiene datos documentos asociados
codigoEmpresa Código de empresa
tipoDocumento Tipo de documento

11
TAG Descripción Valor de ejemplo
numeroDocumento Numero de documento
listaMacroestados Objeto que contiene datos macro estados
orden Orden macro estado
nombre Nombre macro estado
color Color macro estado
imagen Imagen macro estado
listaPinchazos Objeto que contiene datos de pinchazos
codigo Código de pinchazos
codigoPieza Código de pieza
cantidadPiezas Cantidad de piezas
pesoPiezas Peso piezas
fecha Fecha
codigoTipo Tipo de código
nombreTipo Nombre tipo
codigoPosta Código de posta
nombrePosta Nombre de posta
descripcion Descripción
txieneFotoExcepcion Tiene foto excepción

2.3.4 Ejemplo Response : responseObtenerDocumento

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:responseObtenerReserva
xmlns:ns2="http://ws.bluex.cl/BXTRK002_TrackingIntegrado/ResponseObtenerReserva">
<reserva>
<codigoEmpresa>2000</codigoEmpresa>
<cuentaCliente>96801150-11-8</cuentaCliente>
<codigoTipoServicio>EX</codigoTipoServicio>
<nombreTipoServicio>EXPRESS</nombreTipoServicio>
<codigoProducto>P</codigoProducto>
<nombreProducto>PAQUETE</nombreProducto>
<observacion>test de hugo farfan</observacion>
<fechaSolicitudRetiro>17/12/2014</fechaSolicitudRetiro>
<fechaRetiro>18/12/2014</fechaRetiro>
<horaInicio>08:00:00</horaInicio>
<horaTermino>10:00:00</horaTermino>
<codigoEstadoReserva>VG</codigoEstadoReserva>
<nombreEstadoReserva>CANCELADA</nombreEstadoReserva>
<remitente>
<nombre>HUGO FARFAN</nombre>
<rut>96801150-2</rut>
<codigoPais>CL</codigoPais>
<nombrePais>CHILE</nombrePais>
<codigoPosta>CNH</codigoPosta>
<nombrePosta>CONCHALI</nombrePosta>
<codigoBase xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<nombreBase xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>

12
<direccionCompleta>AVENIDA EL RETIRO 9800</direccionCompleta>
<direccionDetalle>TEST</direccionDetalle>
<prefijoTelefono xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<numeroTelefono>27364227</numeroTelefono>
<anexoTelefono xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<email>hugo.farfan@bx.cl</email>
<nombreContacto>HUGO FARFAN</nombreContacto>
<numeroTelefonoContacto>22904008</numeroTelefonoContacto>
<razonSocialContacto>BLUE EXPRESS INTL SERVICIOS DE</razonSocialContacto>
</remitente>
<destinatario>
<nombre>GASTON</nombre>
<codigoPais>CL</codigoPais>
<nombrePais>CHILE</nombrePais>
<codigoPosta>ZBN</codigoPosta>
<nombrePosta>LA SOMBRA</nombrePosta>
<codigoBase xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<nombreBase xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<direccionCompleta>AV EL TONGO 1234</direccionCompleta>
<direccionDetalle>CASA DE MYRIAM</direccionDetalle>
<prefijoTelefono xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<numeroTelefono>2233445566</numeroTelefono>
<anexoTelefono xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<email xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<nombreContacto>DANIEL ROJAS</nombreContacto>
<numeroTelefonoContacto>22804004</numeroTelefonoContacto>
</destinatario>
<embalajeTotalizado>
<codigoUnidadMasa>KG</codigoUnidadMasa>
<nombreUnidadMasa>Kilogramo</nombreUnidadMasa>
<codigoUnidadLongitud>CM</codigoUnidadLongitud>
<nombreUnidadLongitud>Centimetro</nombreUnidadLongitud>
<masa>20.0</masa>
<largo>10.63</largo>
<ancho>10.63</ancho>
<alto>10.63</alto>
<volumen>0.3</volumen>
</embalajeTotalizado>
<listaDocumentosAsociados/>
<listaMacroestados>
<macroestado>
<orden>1</orden>
<nombre>SOLICITUD RECEPCIONADA</nombre>
<color>AZUL</color>
<imagen/>
</macroestado>
<macroestado>
<orden>2</orden>
<nombre>EN PROCESO</nombre>
<color>AZUL</color>
<imagen/>
</macroestado>
<macroestado>

13
<orden>3</orden>
<color>GRIS</color>
<imagen/>
</macroestado>
</listaMacroestados>
<listaPinchazos>
<pinchazo>
<codigo>1141139</codigo>
<cantidadPiezas>10</cantidadPiezas>
<pesoPiezas>20.0</pesoPiezas>
<fecha>17/12/2014 11:33:00</fecha>
<codigoPosta>CNH</codigoPosta>
<nombrePosta>CONCHALI</nombrePosta>
<tieneFotoExcepcion>false</tieneFotoExcepcion>
<esExcepcion>true</esExcepcion>
</pinchazo>
<pinchazo>
<codigo>1141139</codigo>
<cantidadPiezas>10</cantidadPiezas>
<pesoPiezas>20.0</pesoPiezas>
<fecha>17/12/2014 11:25:17</fecha>
<codigoTipo>RVG</codigoTipo>
<nombreTipo>RESERVA VIGENTE</nombreTipo>
<codigoPosta>CNH</codigoPosta>
<nombrePosta>CONCHALI</nombrePosta>
<tieneFotoExcepcion>false</tieneFotoExcepcion>
<esExcepcion>false</esExcepcion>
</pinchazo>
<pinchazo>
<codigo>1141139</codigo>
<cantidadPiezas>10</cantidadPiezas>
<pesoPiezas>20.0</pesoPiezas>
<fecha>17/12/2014 11:18:45</fecha>
<codigoTipo>RST</codigoTipo>
<nombreTipo>RESERVA STAND BY</nombreTipo>
<codigoPosta>CNH</codigoPosta>
<nombrePosta>CONCHALI</nombrePosta>
<tieneFotoExcepcion>false</tieneFotoExcepcion>
<esExcepcion>false</esExcepcion>
</pinchazo>
</listaPinchazos>
</reserva>
</ns2:responseObtenerReserva>
</soap:Body>
</soap:Envelope>

14
2.4 Obtener Tipo Documento : obtenerTipoDocumento
Permite obtener el tracking de uno o más documentos.

2.4.1 Parámetros de entrada: requestObtenerTipoDocumento

TAG Descripción Valor de ejemplo


tipoTracking Indica tracking de documento
codigoEmpresa Empresa a la que pertenece la guía.

2.4.2 Ejemplo Request : requestObtenerTipoDocumento

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://ws.bluex.cl/">
<soapenv:Header>
<ws:requestHeader>
<idToken>45fa909ab4b6e77806982f42a1337bca</idToken>
<codigoUsuario>2</codigoUsuario>
</ws:requestHeader>
</soapenv:Header>
<soapenv:Body>
<ws:requestObtenerTiposDocumento>
<tipoTracking>1</tipoTracking>
<codigoEmpresa>2000</codigoEmpresa>
</ws:requestObtenerTiposDocumento>
</soapenv:Body>
</soapenv:Envelope>

2.4.3 Parámetros de salida responseObtenerTipoDocumento

TAG Descripción Valor de ejemplo


listaTiposDocumentos Lista que contiene objetos con tipo de documentos
tipoDocumento Objeto que contiene datos de tipo de documentos
codigoTipoDocumento Código tipo de documento
descripcionTipoDocumento Descripción tipo de documento

2.4.4 Ejemplo Response : responseObtenerTipoDocumento

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns2:responseObtenerTiposDocumento
xmlns:ns2="http://ws.bluex.cl/BXTRK002_TrackingIntegrado/ResponseObtenerTiposDocumento">
<listaTiposDocumentos>

15
<tipoDocumento>
<codigoTipoDocumento>1</codigoTipoDocumento>
<descripcionTipoDocumento>BOLETAS</descripcionTipoDocumento>
</tipoDocumento>
<tipoDocumento>
<codigoTipoDocumento>2</codigoTipoDocumento>
<descripcionTipoDocumento>FACTURAS</descripcionTipoDocumento>
</tipoDocumento>
<tipoDocumento>
<codigoTipoDocumento>3</codigoTipoDocumento>
<descripcionTipoDocumento>OS</descripcionTipoDocumento>
</tipoDocumento>
<tipoDocumento>
<codigoTipoDocumento>4</codigoTipoDocumento>
<descripcionTipoDocumento>SKY</descripcionTipoDocumento>
</tipoDocumento>
</listaTiposDocumentos>
</ns2:responseObtenerTiposDocumento>
</soap:Body>
</soap:Envelope>

3 Macro estados.
El proceso de tracking despliega hasta 5 estados que describen el progreso actual en que se
encuentra el envío. Estos pueden ser:

1.- Retiro.
2.- En hub.
3.- En tránsito.
4.- En ruta para Entregar.
5.- Entregado.

16
Ejemplo Macro Estado Exitoso.

3.1 Como construir un macro estado.

Al momento de consultar un documento, en XML de salida viene dentro del tag


<listaMacroestados> una lista con los datos necesarios para poder interpretar y construir los
estados actuales de los macro estados.

Ejemplo XML y sus macro estados.

<listaMacroestados>
<macroestado>
<orden>1</orden>
<nombre>RETIRO</nombre>
<color>AZUL</color>
<imagen/>
</macroestado>

17
<macroestado>
<orden>2</orden>
<nombre>EN HUB</nombre>
<color>AZUL</color>
<imagen/>
</macroestado>
<macroestado>
<orden>3</orden>
<nombre>EN TRANSITO</nombre>
<color>AZUL</color>
<imagen/>
</macroestado>
<macroestado>
<orden>4</orden>
<nombre>EN RUTA PARA ENTREGAR</nombre>
<color>AZUL</color>
<imagen/>
</macroestado>
<macroestado>
<orden>5</orden>
<nombre>ENTREGADO</nombre>
<color>VERDE</color>
<imagen/>
</macroestado>
</listaMacroestados>

Donde :
Tag <listaMacroestados>, corresponde a la lista de los macro estados a desplegar.
Tag <macroestado>, corresponde al macro estado a desplegar.
Tag <orden>, corresponde a la posición en donde se debe incluir el macro estado.
Tag <nombre>, corresponde a la descripción actual del macro estado.
Tag <color>, corresponde al color con el que se debe desplegar el macro estado.

18
3.2 Tabla de Colores.
Nombre Color Descripción
VERDE Indica macro estado con estrega exitosa.
AZUL Indica el progreso del macro estado.
GRIS Indica que no hay movimiento.
NARANJO Indica que ocurrió una excepción.
PURPURA Indica que ocurrió una excepción.

19

También podría gustarte