BX
Geolocation
Pricing
Emission
Tracking Push
Tracking Pull
Bookings
Pickups
{

"Title": "Bienvenido al sitio para desarrolladores de Bluex.",

"Description": "Aquí podrás encontrar documentación necesaria para comprender cada uno de los puntos de integración con la plataforma B2B de Bluex.",

"Overview": "A la izquierda encontrarás los puntos de integración con la plataforma,haz click en cada punto de integración para tener más detalles.",

"Get Started": "Como sugerencia podrías comenzar por el punto de integración Emission ya que es el servicio core de la plataforma. Emission es el servicio que genera las órdenes de servicio (OS) que servirán para que Bluex pueda saber en detalle el tipo de carga que esta trasladando, quien fue el embalador, a quien va dirigido, cuales son los documentos legales asociados a la carga y otros datos que dan valor al servicio Courier de Bluex."

}
Geolocation
Pricing
Emission
Tracking Push
Tracking Pull
Bookings
Pickups
Servicio para la consulta de datos geográficos (región, comuna, ciudad, localidad). El WSDL del servicio es https://portal.bluex.cl/ws_informaciongeografica/BXAUX001InformacionGeografica?wsdl.
Documentos
En la siguiente tabla encontrará documentación asociada al servicio:

Documento Descripción
IntegracionWsGeografica Especificación técnica del servicio de información geográfica.
Regiones-Comunas-Localidades Listado de Regiones-Comunas-Localidades que utiliza Bluex
Regiones
Ejemplo de request:
<?xml version="1.0" encoding="UTF-8"?> <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.bluex.cl/"> <soapenv:Header> <ws:requestHeader> <idToken>@idToken</idToken> <codigoUsuario>@codigoUsuario</codigoUsuario> </ws:requestHeader> </soapenv:Header> <soapenv:Body> <ws:requestRegionFiltrar> <codigoPais>CL</codigoPais> </ws:requestRegionFiltrar> </soapenv:Body> </soapenv:Envelope>
Comunas
Ejemplo de request:
<?xml version="1.0" encoding="UTF-8"?> <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.bluex.cl/"> <soapenv:Header> <ws:requestHeader> <idToken>@idToken</idToken> <codigoUsuario>@codigoUsuario</codigoUsuario> </ws:requestHeader> </soapenv:Header> <soapenv:Body> <ws:requestComunaFiltrar> <codigoPais/> <codigoRegion/> <nombreComuna/> </ws:requestComunaFiltrar> </soapenv:Body> </soapenv:Envelope>
Localidades
Ejemplo de request:
<?xml version="1.0" encoding="UTF-8"?> <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.bluex.cl/"> <soapenv:Header> <ws:requestHeader> <idToken>@idToken</idToken> <codigoUsuario>@codigoUsuario</codigoUsuario> </ws:requestHeader> </soapenv:Header> <soapenv:Body> <ws:requestLocalidadFiltrar> <codigoPais>CL</codigoPais> <codigoComuna>8309</codigoComuna> </ws:requestLocalidadFiltrar> </soapenv:Body> </soapenv:Envelope>
Servicio para la consulta de tarifas. El WSDL del servicio es https://portal.bluex.cl/ws_tarifa_cliente/TarifaClienteWSServiceImpl?wsdl.
Documentos
En la siguiente tabla encontrará documentación asociada al servicio:

Documento Descripción
IntegracionWsTarifaCliente Especificación técnica del servicio de tarifas.
Pricing
Ejemplo de request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://service.cliente.tarifa.bluex.cl/"> <soapenv:Header> <ser:cabecera> <codigoUsuario>@codigoUsuario</codigoUsuario> <token>@token</token> </ser:cabecera> </soapenv:Header> <soapenv:Body> <ser:obtenerTarifa> <obtieneTarifa> <RequestObtieneTarifa> <datosCliente> <codigoPais>CL</codigoPais> <codigoEmpresa>2000</codigoEmpresa> <cuentaCorriente>@cuentaCorriente</cuentaCorriente> </datosCliente> <datosEnvio> <tipoServicio>EX</tipoServicio> <fechaCreacion></fechaCreacion> <origen> <region>13</region> <localidad>SCL</localidad> </origen> <destino> <region>8</region> <localidad>ANT</localidad> </destino> </datosEnvio> <datosProducto> <producto>P</producto> <familiaProducto>PAQU</familiaProducto> <largo>50</largo> <ancho>50</ancho> <alto>50</alto> <pesoFisico>2.5</pesoFisico> <cantidadPiezas>5</cantidadPiezas> <unidades>5</unidades> </datosProducto> <otrosServicio> <!--Optional:--> <listaServComplementario>@SE01;@SE02;@SE03;@SE04</listaServComplementario> <!--Decimal: Peso del producto a transportar--> <delimitador>;</delimitador> </otrosServicio> </RequestObtieneTarifa> </obtieneTarifa> </ser:obtenerTarifa> </soapenv:Body> </soapenv:Envelope>
Servicio de emisión de órdenes de servicios. Genera el número de tracking y responde el contenido de la etiqueta listo para ser enviado a la impresora sin necesidad de manipulación. También tiene opción de retorno de los datos que deben ir en la etiqueta en formato XML para poder hacer una etiqueta fusionada o customizada. El WSDL del servicio es https://portal.bluex.cl/ws_emision_integracion/BXEMS001EmisionIntegracionImpl?wsdl.
Lista de Contactos para Notificación
Cada vez que una órden de servicio (OS) es actualizada desde un macro estado a otro se genera un mail y/o un mensaje de notificación a cada uno de los contactos definidos como lista de contactos del request.
Para indicarle a la plataforma de Bluex que debe notificar a los contactos es necesario especificarlo en la sección listaContactosCanal del XML request. A continuación se detalla un snippet del request que contiene la sección listaContactosCanal.
La estructura de los datos es la siguiente: <listaContactosCanal> <!--1 or more repetitions:--> <contactoCanal> <codigoTipoContacto>@codigoTipoContacto</codigoTipoContacto> <codigoTipoCanal>@codigoTipoCanal</codigoTipoCanal> <valorCanal>@valorCanal</valorCanal> <listaMacroestados> <!--1 or more repetitions:--> <macroestado> <codigo>@macroestado</codigo> </macroestado> </listaMacroestados> </contactoCanal> </listaContactosCanal>
Atributo Tipo
@codigoTipoContacto
Tipo del contacto indicado:
  • R: Remitente.
  • D: Destinatario.
 String(1)
@codigoTipoCanal
Tipo de notificación que debe ser realizada.
  • 1: Teléfono (Celular).
  • 2: Correo electrónico.
 Integer
@valorCanal
Es es correo electrónico o el número de telefóno del contacto.
 String(20)
@macroestado
El es valor del macro estado que será notificado. Los macro estado son los siguiente:
  • Código: 1 -> En Retiro: El envío fue retirado de la bodega de origen.
  • Código: 2 -> CD Blue: El envío está en el centro de distribución de Bluex.
  • Código: 3 -> En Tránsito: El envío va en camino a la base Bluex más cercana al destino final.
  • Código: 4 -> En Reparto: El envío están el camino al destino final.
  • Código: 5 -> Entregado: El envío fue entregado al destinatario
  • Código: 21 -> Problema de Entrega: Ocurrió una excepción de entrega.
 Integer
Formato de Response de la o las etiquetas.
El retorno del formato de impresión está condicionado por el parámetro codigoFormatoImpresion el cual puede tomar los siguientes valores:
  • codigoFormatoImpresion = 1 : Retorna formato impresora térmica.
  • codigoFormatoImpresion = 2 : Retorna formato impresora ZPL.
  • codigoFormatoImpresion = 3 : Retorna formato XML.
Documentos
En la siguiente tabla encontrará documentación asociada al servicio:

Documento Descripción
IntegracionWsEmision Especificación técnica del servicio de emisión de órdenes de servicio (OS).
Regiones-Comunas-Localidades Listado de Regiones-Comunas-Localidades que utiliza Bluex.
IntegracionEtiquetas Requerimiento de integración de etiquetas.
Emission
Ejemplo de request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.cl.bluex.cl/"> <soapenv:Header> <ws:requestHeader> <idToken>@idToken</idToken> <codigoUsuario>@codigoUsuario</codigoUsuario> </ws:requestHeader> </soapenv:Header> <soapenv:Body> <ws:requestEmisionIntegracion> <codigoFormatoImpresion>2</codigoFormatoImpresion> <ordenServicio> <cuentaCliente>cuentaCliente</cuentaCliente> <nombreEmbalador>BLUE EXPRESS INTL SERVICIOS DE TRASPORTE LIMITADA</nombreEmbalador> <codigoPaisEmbalador>CL</codigoPaisEmbalador> <codigoRegionEmbalador>5</codigoRegionEmbalador> <codigoComunaEmbalador>5602</codigoComunaEmbalador> <codigoLocalidadOrigen>ABO</codigoLocalidadOrigen> <direccionCompletaEmbalador>CALLE UNO, ALGARROBO</direccionCompletaEmbalador> <numeroTelefonoEmbalador>12345678</numeroTelefonoEmbalador> <nombreDestinatario>YETI SNOwMAN</nombreDestinatario> <codigoPaisDestinatario>CL</codigoPaisDestinatario> <codigoRegionDestinatario>8</codigoRegionDestinatario> <codigoComunaDestinatario>8302</codigoComunaDestinatario> <codigoLocalidadDestino>ANT</codigoLocalidadDestino> <direccionCompletaDestinatario>CALLE 3</direccionCompletaDestinatario> <prefijoTelefonoDestinatario>569</prefijoTelefonoDestinatario> <numeroTelefonoDestinatario>12345678</numeroTelefonoDestinatario> <codigoProducto>P</codigoProducto> <codigoMoneda>CLP</codigoMoneda> <codigoEmpresa>2000</codigoEmpresa> <codigoTipoServicio>EX</codigoTipoServicio> <codigoPersona>@codigoPersona</codigoPersona> <codigoFamiliaProducto>PAQU</codigoFamiliaProducto> <switchNotificar>false</switchNotificar> <observaciones>AQUI PUEDE IR EL SKU</observaciones> <listaEmisionEmbalajesCrearReq> <!--1 or more repetitions:--> <emisionEmbalajeCrearReq> <codigoUnidadMasa>KG</codigoUnidadMasa> <codigoUnidadLongitud>CM</codigoUnidadLongitud> <masa>2.5</masa> <largo>50</largo> <ancho>10</ancho> <alto>30</alto> </emisionEmbalajeCrearReq> <emisionEmbalajeCrearReq> <codigoUnidadMasa>KG</codigoUnidadMasa> <codigoUnidadLongitud>CM</codigoUnidadLongitud> <masa>1.5</masa> <largo>20</largo> <ancho>5</ancho> <alto>10</alto> </emisionEmbalajeCrearReq> </listaEmisionEmbalajesCrearReq> <listaNumerosReferenciaCrearReq> <!--1 or more repetitions:--> <numeroReferencia>123456789</numeroReferencia> <numeroReferencia>321654987</numeroReferencia> </listaNumerosReferenciaCrearReq> <!--Optional:--> <listaContactosCanal> <!--1 or more repetitions:--> <contactoCanal> <codigoTipoContacto>D</codigoTipoContacto> <codigoTipoCanal>2</codigoTipoCanal> <valorCanal>it001@bx.cl</valorCanal> <listaMacroestados> <!--1 or more repetitions:--> <macroestado> <!--En Retiro--> <codigo>1</codigo> </macroestado> <macroestado> <!--CD Blue--> <codigo>2</codigo> </macroestado> <macroestado> <!--En Transito--> <codigo>3</codigo> </macroestado> <macroestado> <!--En reparto--> <codigo>4</codigo> </macroestado> <macroestado> <!--Entregado--> <codigo>5</codigo> </macroestado> <macroestado> <!--Excepción--> <codigo>21</codigo> </macroestado> </listaMacroestados> </contactoCanal> </listaContactosCanal> </ordenServicio> </ws:requestEmisionIntegracion> </soapenv:Body> </soapenv:Envelope>
Servicio que "inyecta" los movimientos de un envío (número de tracking) a un endpoint que el cliente debe desarrollar para tales efectos. El servicio transmite todos los movimientos de un envío en una estructura JSON que contiene:
  • carrier_tracking_number: número para el seguimiento.
  • tracking_data: estructura xml (en formato string) de los movimientos de un envío (tracking number).
Documentos
En la siguiente tabla encontrará documentación asociada al servicio:

Documento Descripción
IntegracionPushTracking Especificación técnica de integración de tracking push.
IntegracionPushTracking-Events Listado de eventos que utiliza Bluex.
IntegracionPushTracking-Exceptions Listado de excepciones que utiliza Bluex.
Tracking Push
Ejemplo de request:
{ "carrier_tracking_number": 1234567890, "tracking_data": "" }
Ejemplo de tracking_data:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns3:responseObtenerDocumento xmlns:ns4="http://ws.bluex.cl/BXTRK002_TrackingIntegrado/ResponseObtenerReserva" xmlns:ns3="http://ws.bluex.cl/BXTRK002_TrackingIntegrado/ResponseObtenerDocumento" xmlns:ns2="http://ws.bluex.cl/" xmlns:ns5="http://ws.bluex.cl/BXTRK002_TrackingIntegrado/ResponseObtenerTiposDocumento"> <listaDocumento> <documento> <numeroDocumento>6703001992</numeroDocumento> <idEspecieValorada>224107059</idEspecieValorada> <codigoEmpresa>2000</codigoEmpresa> <razonSocial>@razonSocial</razonSocial> <cuentaCliente>@cuentaCliente</cuentaCliente> <codigoTipoServicio>72</codigoTipoServicio> <nombreTipoServicio>EXPRESO-P</nombreTipoServicio> <codigoProducto>P</codigoProducto> <nombreProducto>PAQUETE</nombreProducto> <nombreTipoDocumento>ORDEN DE SERVICIO CARGA</nombreTipoDocumento> <tieneMercanciasPeligrosas>false</tieneMercanciasPeligrosas> <fechaCreacion>28-08-2020 11:48:37</fechaCreacion> <codigoMoneda>CLP</codigoMoneda> <valorSeguro>0</valorSeguro> <cantidadPiezas>1</cantidadPiezas> <remitente> <nombre>@nombre</nombre> <rut-ruc>1-9</rut-ruc> <codigoPais>CL</codigoPais> <nombrePais>Chile</nombrePais> <codigoRegion>13</codigoRegion> <nombreRegion>Metropolitana de Santiago</nombreRegion> <codigoComuna>13124</codigoComuna> <nombreComuna>PUDAHUEL</nombreComuna> <codigoLocalidad>PUD</codigoLocalidad> <nombreLocalidad>PUDAHUEL</nombreLocalidad> <codigoBase>SCL</codigoBase> <nombreBase>SANTIAGO</nombreBase> <direccionCompleta>@direccionCompleta</direccionCompleta> <prefijoTelefono>0</prefijoTelefono> <numeroTelefono>@numeroTelefono</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"/> </remitente> <destinatario> <nombre>JUAN PEREZ</nombre> <rut-ruc>1-9</rut-ruc> <codigoPais>CL</codigoPais> <nombrePais>Chile</nombrePais> <codigoRegion>9</codigoRegion> <nombreRegion>Araucanía</nombreRegion> <codigoComuna>9101</codigoComuna> <nombreComuna>TEMUCO</nombreComuna> <codigoLocalidad>ZCO</codigoLocalidad> <nombreLocalidad>TEMUCO</nombreLocalidad> <codigoBase>ZCO</codigoBase> <nombreBase>TEMUCO</nombreBase> <direccionCompleta>CUATRO VIENTOS 698</direccionCompleta> <prefijoTelefono>+56</prefijoTelefono> <numeroTelefono>@numeroTelefono</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"/> </destinatario> <embalajeTotalizado> <codigoUnidadMasa>KG</codigoUnidadMasa> <nombreUnidadMasa>Kilogramo</nombreUnidadMasa> <codigoUnidadLongitud>CM</codigoUnidadLongitud> <nombreUnidadLongitud>Centímetro</nombreUnidadLongitud> <masa>39.4</masa> <largo>104.0</largo> <ancho>60.0</ancho> <alto>100.0</alto> <volumen>156.0</volumen> </embalajeTotalizado> <listaNumerosReferencia> <numeroReferencia> <valor>0297043354</valor> </numeroReferencia> </listaNumerosReferencia> <listaMacroestados> <macroestado> <orden>1</orden> <nombre>En Retiro</nombre> <color>AZUL</color> <imagen/> </macroestado> <macroestado> <orden>2</orden> <nombre>CD Blue</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 reparto</nombre> <color>AZUL</color> <imagen/> </macroestado> <macroestado> <orden>5</orden> <nombre>Entregado</nombre> <color>VERDE</color> <imagen/> </listaMacroestados> <listaPinchazosNacionales> <pinchazo> <codigo>33006702127600</codigo> <codigoPieza>33006702127600</codigoPieza> <cantidadPiezas>1</cantidadPiezas> <pesoPiezas>0.0</pesoPiezas> <fecha>28/08/2020 09:43:44</fecha> <codigoTipo>LD</codigoTipo> <nombreTipo>EN REPARTO</nombreTipo> <codigoPosta>SCL</codigoPosta> <nombrePosta>SANTIAGO</nombrePosta> <tieneFotoExcepcion>false</tieneFotoExcepcion> <esExcepcion>false</esExcepcion> </pinchazo> <pinchazo> <codigo>33006702127600</codigo> <codigoPieza>33006702127600</codigoPieza> <cantidadPiezas>1</cantidadPiezas> <pesoPiezas>0.0</pesoPiezas> <fecha>28/08/2020 01:16:29</fecha> <codigoTipo>SOB</codigoTipo> <nombreTipo>SOBRE</nombreTipo> <codigoPosta>SCL</codigoPosta> <nombrePosta>SANTIAGO</nombrePosta> <descripcion>PAQ</descripcion> <tieneFotoExcepcion>false</tieneFotoExcepcion> <esExcepcion>false</esExcepcion> </pinchazo> </listaPinchazosNacionales> </documento> </listaDocumento> </ns3:responseObtenerDocumento> </soap:Body> </soap:Envelope>
Lo medular del xml es la lista de macro estados "listaMacroestados" y la lista de eventos y/o excepciones "listaPinchazosNacionales", siendo los eventos el "camino feliz del envío" y las excepciones las bifurcaciones del "camino feliz" como por ejemplo que la dirección no sea correcta o que no se encuentran moradores en el domicilio. La lista de macro estados contiene las etapas por las cuales el envío pasará. Los macro estados son 6:
  • En Retiro.
  • CD Blue.
  • En Tránsito.
  • En Reparto.
  • Entregado.
  • Problema de Entrega.
Cada uno de ellos tiene asignado un color el cual indica si el envío ya pasó o no pasó por ese macro estado, los colores son:
  • GRIS: Indica que el envío no ha pasado por la etapa.
  • AZUL: Indica que el envío ya ha pasado por la etapa.
  • VERDE: Indica que el envío ya ha pasado por la etapa. Sólo para el macro estado Entregado.
  • PURPURA: Indica que el envío tuvo problemas en la entrega
La lista de pinchazos nacionales contiene la traza de los bultos por el proceso (eventos y excepciones). Están ordenados desde el más reciente hasta el más antiguo.
Servicio (filtrado por IP) para obtener el detalle de un envío ondemand (mediante su tracking number). El WSDL del servicio es https://portal.bluex.cl/ws_tracking_integrado/BXTRK002TrackingIntegrado?wsdl.
Documentos
En la siguiente tabla encontrará documentación asociada al servicio:

Documento Descripción
IntegracionWsTracking Especificación técnica del servicio de tracking pull.
Regiones-Comunas-Localidades Listado de Regiones-Comunas-Localidades que utiliza Bluex
Tracking Pull
Ejemplo de request:
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.bluex.cl/"> <soapenv:Header> <ws:requestHeader> <idToken>@idToken</idToken> <codigoUsuario>@codigoUsuario</codigoUsuario> </ws:requestHeader> </soapenv:Header> <soapenv:Body> <ws:requestObtenerDocumento> <codigoEmpresa>2000</codigoEmpresa> <cuentaCorriente>@cuentaCorriente</cuentaCorriente> <numeroReferencia></numeroReferencia> <numeroDocumento>6702127643</numeroDocumento> <tipoDocumento>3</tipoDocumento> </ws:requestObtenerDocumento> </soapenv:Body> </soapenv:Envelope>
Ejemplo de response:
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <ns3:responseObtenerDocumento xmlns:ns4="http://ws.bluex.cl/BXTRK002_TrackingIntegrado/ResponseObtenerReserva" xmlns:ns3="http://ws.bluex.cl/BXTRK002_TrackingIntegrado/ResponseObtenerDocumento" xmlns:ns2="http://ws.bluex.cl/" xmlns:ns5="http://ws.bluex.cl/BXTRK002_TrackingIntegrado/ResponseObtenerTiposDocumento"> <listaDocumento> <documento> <numeroDocumento>6703001992</numeroDocumento> <idEspecieValorada>224107059</idEspecieValorada> <codigoEmpresa>2000</codigoEmpresa> <razonSocial>@razonSocial</razonSocial> <cuentaCliente>@cuentaCliente</cuentaCliente> <codigoTipoServicio>72</codigoTipoServicio> <nombreTipoServicio>EXPRESO-P</nombreTipoServicio> <codigoProducto>P</codigoProducto> <nombreProducto>PAQUETE</nombreProducto> <nombreTipoDocumento>ORDEN DE SERVICIO CARGA</nombreTipoDocumento> <tieneMercanciasPeligrosas>false</tieneMercanciasPeligrosas> <fechaCreacion>28-08-2020 11:48:37</fechaCreacion> <codigoMoneda>CLP</codigoMoneda> <valorSeguro>0</valorSeguro> <cantidadPiezas>1</cantidadPiezas> <remitente> <nombre>@nombre</nombre> <rut-ruc>1-9</rut-ruc> <codigoPais>CL</codigoPais> <nombrePais>Chile</nombrePais> <codigoRegion>13</codigoRegion> <nombreRegion>Metropolitana de Santiago</nombreRegion> <codigoComuna>13124</codigoComuna> <nombreComuna>PUDAHUEL</nombreComuna> <codigoLocalidad>PUD</codigoLocalidad> <nombreLocalidad>PUDAHUEL</nombreLocalidad> <codigoBase>SCL</codigoBase> <nombreBase>SANTIAGO</nombreBase> <direccionCompleta>@direccionCompleta</direccionCompleta> <prefijoTelefono>0</prefijoTelefono> <numeroTelefono>223558790</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"/> </remitente> <destinatario> <nombre>JUAN PEREZ</nombre> <rut-ruc>1-9</rut-ruc> <codigoPais>CL</codigoPais> <nombrePais>Chile</nombrePais> <codigoRegion>9</codigoRegion> <nombreRegion>Araucanía</nombreRegion> <codigoComuna>9101</codigoComuna> <nombreComuna>TEMUCO</nombreComuna> <codigoLocalidad>ZCO</codigoLocalidad> <nombreLocalidad>TEMUCO</nombreLocalidad> <codigoBase>ZCO</codigoBase> <nombreBase>TEMUCO</nombreBase> <direccionCompleta>CUATRO VIENTOS 698</direccionCompleta> <prefijoTelefono>+56</prefijoTelefono> <numeroTelefono>123456789</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"/> </destinatario> <embalajeTotalizado> <codigoUnidadMasa>KG</codigoUnidadMasa> <nombreUnidadMasa>Kilogramo</nombreUnidadMasa> <codigoUnidadLongitud>CM</codigoUnidadLongitud> <nombreUnidadLongitud>Centímetro</nombreUnidadLongitud> <masa>39.4</masa> <largo>104.0</largo> <ancho>60.0</ancho> <alto>100.0</alto> <volumen>156.0</volumen> </embalajeTotalizado> <listaCobrosContraEntrega/> <listaDocumentosDevolucion/> <listaNumerosReferencia> <numeroReferencia> <valor>0297043354</valor> </numeroReferencia> </listaNumerosReferencia> <listaMacroestados> <macroestado> <orden>1</orden> <nombre>En Retiro</nombre> <color>AZUL</color> <imagen/> </macroestado> <macroestado> <orden>2</orden> <nombre>CD Blue</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 reparto</nombre> <color>AZUL</color> <imagen/> </macroestado> <macroestado> <orden>5</orden> <nombre>Entregado</nombre> <color>VERDE</color> <imagen/> </listaMacroestados> <listaPinchazosNacionales> <pinchazo> <codigo>33006702127600</codigo> <codigoPieza>33006702127600</codigoPieza> <cantidadPiezas>1</cantidadPiezas> <pesoPiezas>0.0</pesoPiezas> <fecha>28/08/2020 09:43:44</fecha> <codigoTipo>LD</codigoTipo> <nombreTipo>EN REPARTO</nombreTipo> <codigoPosta>SCL</codigoPosta> <nombrePosta>SANTIAGO</nombrePosta> <tieneFotoExcepcion>false</tieneFotoExcepcion> <esExcepcion>false</esExcepcion> </pinchazo> <pinchazo> <codigo>33006702127600</codigo> <codigoPieza>33006702127600</codigoPieza> <cantidadPiezas>1</cantidadPiezas> <pesoPiezas>0.0</pesoPiezas> <fecha>28/08/2020 01:16:29</fecha> <codigoTipo>SOB</codigoTipo> <nombreTipo>SOBRE</nombreTipo> <codigoPosta>SCL</codigoPosta> <nombrePosta>SANTIAGO</nombrePosta> <descripcion>PAQ</descripcion> <tieneFotoExcepcion>false</tieneFotoExcepcion> <esExcepcion>false</esExcepcion> </pinchazo> </listaPinchazosNacionales> <listaPinchazosInternacionales/> </documento> </listaDocumento> </ns3:responseObtenerDocumento> </soap:Body> </soap:Envelope>
Lo medular del xml es la lista de macro estados listaMacroestados y la lista de eventos y/o excepciones listaPinchazosNacionales, siendo los eventos el "camino feliz del envío" y las excepciones las bifurcaciones del "camino feliz" como por ejemplo que la dirección no sea correcta o que no se encuentran moradores en el domicilio. La lista de macro estados contiene las etapas por las cuales el envío pasará. Los macro estados son 5:
  • En Retiro.
  • CD Blue.
  • En Tránsito.
  • En Reparto.
  • Entregado.
  • Problema de Entrega.
Cada uno de ellos tiene asignado un color el cual indica si el envío ya pasó o no pasó por ese macro estado, los colores son:
  • GRIS: Indica que el envío no ha pasado por la etapa.
  • AZUL: Indica que el envío ya ha pasado por la etapa.
  • VERDE: Indica que el envío ya ha pasado por la etapa. Sólo para el macro estado Entregado.
  • PURPURA: Indica que el envío tuvo problemas en la entrega
La lista de pinchazos nacionales contiene la traza de los bultos por el proceso (eventos y excepciones). Están ordenados desde el más reciente hasta el más antiguo.
Servicio que permite realizar el agendamiento para que bluex retire en una fecha programada un conjunto de de envíos (OS) ya etiquetados. El WSDL del servicio es https://portal.bluex.cl/ws_reserva/BXPUP001_PickUp?wsdl.
Documentos
En la siguiente tabla encontrará documentación asociada al servicio:

Documento Descripción
IntegracionWsReserva Especificación técnica del servicio de reservas.
Reservas
Ejemplo de request:
<?xml version="1.0" encoding="UTF-8"?> <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ws="http://ws.bluex.cl/"> <soapenv:Header> <ws:requestHeader> <idToken>@idToken</idToken> <codigoUsuario>@codigoUsuario</codigoUsuario> </ws:requestHeader> </soapenv:Header> <soapenv:Body> <ws:requestCrear> <codigoEmpresa>2000</codigoEmpresa> <aceptaTerminos>1</aceptaTerminos> <reserva> <rutEmbalador>@rutEmbalador</rutEmbalador> <dvEmbalador>@dvEmbalador</dvEmbalador> <razonSocial>@razonSocial</razonSocial> <cuentaCliente>@cuentaCliente</cuentaCliente> <codigoTipoServicio>EX</codigoTipoServicio> <codigoFamiliaProducto>PAQU</codigoFamiliaProducto> <codigoProducto>P</codigoProducto> <fechaRetiro>01/12/2020</fechaRetiro> <horaInicio>13:00</horaInicio> <horaTermino>16:00</horaTermino> <observaciones>prueba de reservas</observaciones> <remitente> <nombre>@nombre</nombre> <rut>@rut</rut> <codigoPais>CL</codigoPais> <codigoRegion>5</codigoRegion> <codigoComuna>5602</codigoComuna> <codigoPosta>ABO</codigoPosta> <direccionCompleta>@direccionCompleta</direccionCompleta> <direccionCalle>UNO</direccionCalle> <direccionNumero>377</direccionNumero> <direccionPiso/> <direccionDepto/> <direccionDetalle>SEGUNDA CASA MAN0 DERECHA</direccionDetalle> <prefijoTelefono>44</prefijoTelefono> <numeroTelefono>1234567</numeroTelefono> <anexoTelefono/> <email>it001@bx.cl</email> <nombreContacto>JUAN PEREZ</nombreContacto> <prefijoTelefonoContacto>56</prefijoTelefonoContacto> <numeroTelefonoContacto>945673498</numeroTelefonoContacto> <anexoTelefonoContacto/> <razonSocialContacto>@razonSocialContacto</razonSocialContacto> </remitente> <destinatario> <nombre>@nombre</nombre> <rut>1-9</rut> <codigoPais>CL</codigoPais> <codigoRegion>8</codigoRegion> <codigoComuna>8302</codigoComuna> <codigoPosta>ANT</codigoPosta> <direccionCompleta>@direccionCompleta</direccionCompleta> <direccionCalle>@direccionCalle</direccionCalle> <direccionNumero>098</direccionNumero> <direccionPiso/> <direccionDepto/> <direccionDetalle>FRENTE AL PORTAL</direccionDetalle> <prefijoTelefono>56</prefijoTelefono> <numeroTelefono>945436789</numeroTelefono> <anexoTelefono/> <email>it001@gmail.com</email> <nombreContacto>@nombreContacto</nombreContacto> <prefijoTelefonoContacto>44</prefijoTelefonoContacto> <numeroTelefonoContacto>433453</numeroTelefonoContacto> <anexoTelefonoContacto/> <razonSocialContacto>@razonSocialContacto</razonSocialContacto> </destinatario> <listaEmbalajes> <embalaje> <codigoUnidadMasa>KG</codigoUnidadMasa> <codigoUnidadLongitud>CM</codigoUnidadLongitud> <masa>2.5</masa> <largo>50</largo> <ancho>10</ancho> <alto>30</alto> </embalaje> <embalaje> <codigoUnidadMasa>KG</codigoUnidadMasa> <codigoUnidadLongitud>CM</codigoUnidadLongitud> <masa>2.5</masa> <largo>50</largo> <ancho>10</ancho> <alto>30</alto> </embalaje> <embalaje> <codigoUnidadMasa>KG</codigoUnidadMasa> <codigoUnidadLongitud>CM</codigoUnidadLongitud> <masa>2.5</masa> <largo>50</largo> <ancho>10</ancho> <alto>30</alto> </embalaje> </listaEmbalajes> </reserva> </ws:requestCrear> </soapenv:Body> </soapenv:Envelope>
Servicio que permite obtener un listado de agencias (puntos pickup). El WSDL del servicio es https://portal.bluex.cl/ws_agencias/AgenciaService?wsdl.
Documentos
En la siguiente tabla encontrará documentación asociada al servicio:

Documento Descripción
IntegracionWsPickup Especificación técnica del servicio de puntos pickups.
Agencias
Ejemplo de request:
<?xml version="1.0" encoding="UTF-8"?> <soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ser="http://service.agenciaws.bluex.cl/"> <soapenv:Header/> <soapenv:Body> <ser:obtenerAgencia> <requestAgencia> <countryId>CL</countryId> <stateName/> <cityName/> <filtroDimension> <largo/> <ancho/> <alto/> <pesoFisico/> </filtroDimension> <carrierInformation> <clientId/> <account/> <password/> </carrierInformation> </requestAgencia> </ser:obtenerAgencia> </soapenv:Body> </soapenv:Envelope>