Está en la página 1de 14

Ecommerce Integración

Clientes
Febrero 2020

________________________________________
Consorcio Nacional de Distribución y Logística S.A.
Victoria 339, Santiago
Teléfono: (2) 550.1500
Fax: (2) 550.1501
Servicio al Cliente: 800.204.600
www.chilepost.cl
Ecommerce Integración Clientes / Febrero 2020

Contenido
I. OBJETIVOS ............................................................................................................... 1
II. DESCRIPCION DEL SERVICIO WEB .................................................................... 2
III. CONSUMO SERVICIO WEB ................................................................................... 9

_____________________________________________
© 2018 – ChilePost S.A.
Siempre a T iempo

Consorcio Nacional de Distribución y Logística S.A. - Victoria 339, Santiago


Teléfono: (2) 550.1500 Fax: (2) 550.1501 - www.chilepost.cl
Ecommerce Integración Clientes / Febrero 2020 – Página 1

I. OBJETIVOS

El objetivo de este instructivo es mostrar el uso o consumo del web service de integración
para los clientes.
Siempre a T iempo

Consorcio Nacional de Distribución y Logística S.A. - Victoria 339, Santiago


Teléfono: (2) 550.1500 Fax: (2) 550.1501 - www.chilepost.cl
Ecommerce Integración Clientes / Febrero 2020 – Página 2

II. DESCRIPCION DEL SERVICIO WEB

El servicio web de integración se encuentra publicado en la siguiente ubicación:

http://webs.chilepost.cl/ws_ecommerce_integracion/WebService.asmx

Dentro de la cual se desprenden los siguientes métodos:

1) CrearOT_XML: Corresponde al procedimiento de generación de una orden de


transporte, por parte del cliente al cual le permite imprimir una etiqueta, formato
que se adjunta como muestra:
Siempre a T iempo

2) ConsultarEstadosxOT_XML: Corresponde al ítem mencionado anteriormente,


pero en formato de salida XML

3) ConsultarxOT: Que presenta la información actual de la orden de transporte

Consorcio Nacional de Distribución y Logística S.A. - Victoria 339, Santiago


Teléfono: (2) 550.1500 Fax: (2) 550.1501 - www.chilepost.cl
Ecommerce Integración Clientes / Febrero 2020 – Página 3

4) ConsultarEstadosxOT: Que presenta la información de toda la trazabilidad o


seguimiento de la orden de transporte (Estados)

5) ConsultarxOT_XML: Corresponde al ítem mencionado anteriormente, pero en


formato de salida XML
Siempre a T iempo

Consorcio Nacional de Distribución y Logística S.A. - Victoria 339, Santiago


Teléfono: (2) 550.1500 Fax: (2) 550.1501 - www.chilepost.cl
Ecommerce Integración Clientes / Febrero 2020 – Página 4

Para el caso del uso de los primeros 4 metodos se necesitara enviar los siguientes
parametros:

Variable Tipo Descripcion


ctaCte String o texto Cuenta del cliente
fechaDesde String o texto Fecha de ingreso de la ot (Desde) –
Formato: YYYY-MM-DD
fechaHasta String o texto Fecha de ingreso de la ot (Hasta) –
Formato: YYYY-MM-DD
ot String o texto Numero de la orden de transporte
guia_fact_clte String o texto Numero de referencia principal
referencia2 String o texto Segunda referencia
referencia3 String o texto Tercera referencia

Nota: Como minimo el cliente debera enviar su cuenta y algun otro parametro adicional,
ya sea el rango de fechas (Desde/Hasta), numero de orden de transporte o cualquier
referencia.
Siempre a T iempo

Consorcio Nacional de Distribución y Logística S.A. - Victoria 339, Santiago


Teléfono: (2) 550.1500 Fax: (2) 550.1501 - www.chilepost.cl
Ecommerce Integración Clientes / Febrero 2020 – Página 5

Datos de salida del método: ConsultarxOT

Nombre Campo Descripción del Dato Tipo del Dato/Longitud Ejemplo


NUMOT Numero OT TEXTO (10)
1017676380
OT_FECHA Fecha Emisión FECHA
03/05/2018 9:41
OT_GUIA_FACT_CLTE Nro Factura o Guía del Cliente NUMERICO (18)
1234567
OT_REFERENCIA2 Referencia 2 en la OT TEXTO (50)
BOLETA 5774
OT_REFERENCIA3 Referencia 3 en la OT TEXTO (50)
PEDIDO 123456
OT_ESTADO Código CHP Ultimo Estado TEXTO (10)
O70
DESTADO Descripción CHP Ultimo Estado TEXTO (140)
ENTREGADO
OT_ORIGEN Ciudad Origen TEXTO (10)
SCL
OT_DESTINO Ciudad Destino TEXTO (10)
SCL
OT_AGENCIA_EMISORA Agencia Emisora de OT TEXTO (10)
SCL
OTP_PRODUCTO Código del Producto CHP TEXTO (10)
820002
PRODUCTO Descripción del Producto CHP TEXTO (60)
ECOMM PAQUETERIA
OT_CCOSTO_REMI Cuenta Corriente TEXTO (15)
SCL7640453701
OT_RUT_DEST Rut Destinatario TEXTO (10)
121231238
OT_NOMBRE_DEST Nombre Destinatario TEXTO (50)
PAULINA MIQUEL
OT_DIRECCION_DEST Dirección Destino TEXTO (50)
CAMINO DEL MISIONERO 9450
OT_CONTACTO_DEST Contacto Destino TEXTO (40)

COMUNA Comuna Destino TEXTO (140)


LO BARNECHEA
OT_FONO_DEST Fono Destino TEXTO (15)
991598601
OTP_CANTIDAD Cantidad Piezas OT NUMERICO (10)
1
OTP_KILOT Kilos en la OT DECIMAL (24)
10,5
OTP_KILOU Kilos Reales Verificados DECIMAL (24)
11,5
OTP_LARGO Dimension_Largo DECIMAL (24)
105
Siempre a T iempo

OTP_ALTO Dimensión_Alto DECIMAL (24)


20
OTP_ANCHO Dimensión_Ancho DECIMAL (24)
15
PESO_ACOBRAR Kilo Mayor a Cobrar NUMERICO (10)
11,5
OT_OBS Obs de la OT TEXTO (200)
ENTREGAR AL CONSERJE
OT_VALOR_DECLARADO Valor Declarado por Cliente NUMERICO (10)
15000000
OTE_FECHA Fecha de Entrega FECHA
04/05/2018 12:44
OTE_RUT_RECEPTOR Rut del Receptor TEXTO (10)
146618502
OTE_NOMBRE_RECEPTOR Nombre del Receptor TEXTO (30)
LILIA GUTIERREZ
OT_VALOR_SERVICIO Valor Total del Servicio NUMERICO (10)
3839
VALOR Valor Total del Servicio TEXTO (40)
3839
VALOR_TOTAL Valor Total del Servicio NUMERICO (10)
3839
OT_RUT_REMI Rut Remitente TEXTO (10)
764045378
OT_NOMBRE_REMI Nombre Remitente TEXTO (50)
JLG IMPORTADORA Y EXPORTADORA
OT_FONO_REMI Fono Remitente TEXTO (15)
995292282

Consorcio Nacional de Distribución y Logística S.A. - Victoria 339, Santiago


Teléfono: (2) 550.1500 Fax: (2) 550.1501 - www.chilepost.cl
Ecommerce Integración Clientes / Febrero 2020 – Página 6

OT_DIRECCION_REMI Dirección Remitente TEXTO (50)


EL ESTRIBO 8588
COMUNA_REMI Comuna Remitente TEXTO (140)
PUDAHUEL
OT_CONTACTO_REMI Contacto Remitente TEXTO (30)
JUAN PEREZ

Datos de salida del método: ConsultarEstadosxOT

Tipo del
Descripción del Dato Dato/Longitud Descripción del Dato
Número de la OT TEXTO (10) 1017676380
Fecha y Hora del Evento FECHA 03/05/2018 9:41
Código del Evento TEXTO (10) O70
Descripción del Evento TEXTO (140) Entregado
Siempre a T iempo

Consorcio Nacional de Distribución y Logística S.A. - Victoria 339, Santiago


Teléfono: (2) 550.1500 Fax: (2) 550.1501 - www.chilepost.cl
Ecommerce Integración Clientes / Febrero 2020 – Página 7

Para el caso del uso en la creación de una orden de transporte se deben enviar los siguientes
parametros:

Nota: Si desea tener acceso a la documentación de dicho metodo puede acceder a la


siguiente direccion:

http://webs.chilepost.cl/ws_ecommerce_integracion/WebService.asmx?op=CrearOT_XML

Datos de entrada del método: CrearOT_XML

Variable Tipo Descripcion Datos de ejemplo


ctaCte String o Cuenta del cliente SCL0000000001
texto
Clave String o Clave de la cuenta del 7000001
texto cliente
NombreDestinatario String o Nombre del destinatario Gerardo Jorquera
texto del envio
Direccion String o Direccion del destinatario Victoria 339
texto
Comuna String o Comuna de destino Santiago
texto
Telefono String o Telefono del destinatario 5501580
texto
Producto String o Codigo de producto que 820001
texto maneja el cliente
CantidadPiezas String o Cantidad de piezas 1
texto
Kilos String o Kilos 0,5
texto
Contenido String o Contenido del envío factura
texto
Siempre a T iempo

Contacto String o Contacto del destinatario


Destinatario texto
Alto String o Alto
texto
Ancho String o Ancho
texto
Largo String o Largo
texto
Observaciones String o Observacion del
Despacho texto despacho
Nro Docto Factura String o Numero de referencia
Guia texto principal
Referencia2 String o Segunda referencia 50712
texto
Referencia3 String o Tercera referencia 50715
texto
Valor Declarado String o Valor declarado 5222
texto

Consorcio Nacional de Distribución y Logística S.A. - Victoria 339, Santiago


Teléfono: (2) 550.1500 Fax: (2) 550.1501 - www.chilepost.cl
Ecommerce Integración Clientes / Febrero 2020 – Página 8

Seguro Adicional String o Tiene seguro si/no NO


texto

Los datos destacados en amarillo, corresponden a datos requeridos para la creación de la


orden de transporte.

Una vez invocado o consumido el servicio web este retornara lo siguiente:

En caso de haberse generado la orden de transporte (Ejecución sin errores), el servicio


entregara la siguiente estructura XML:

Y en caso de error, lo siguiente:


Siempre a T iempo

Consorcio Nacional de Distribución y Logística S.A. - Victoria 339, Santiago


Teléfono: (2) 550.1500 Fax: (2) 550.1501 - www.chilepost.cl
Ecommerce Integración Clientes / Febrero 2020 – Página 9

III. CONSUMO SERVICIO WEB

Para el caso de uso del servicio web, se dará un ejemplo con Microsoft .NET como
lenguaje de desarrollo. Aunque se entiende que el servicio web puede ser consumido desde
múltiples plataformas.

Primero en .NET dentro de un proyecto, agregue una referencia de servicio, la cual


tendrá por dirección la URL indicada al inicio:

http://webs.chilepost.cl/ws_ecommerce_integracion/WebService.asmx
Siempre a T iempo

Consorcio Nacional de Distribución y Logística S.A. - Victoria 339, Santiago


Teléfono: (2) 550.1500 Fax: (2) 550.1501 - www.chilepost.cl
Ecommerce Integración Clientes / Febrero 2020 – Página 10

Segundo, si gusta puede diseñar un formulario que permita pasar las opciones y parametros,
a la invocacion del web service:

Nota: Los controles de la parte superior corresponden a RadioButtons, para permitir solo la
selección de un elemento (Consulta por OT o Consultar Estados). Despues en la seccion
de parametros se enumeran todos los parametros disponibles a traves de TextBox, para que
el usuario introduzca los criterios de busqueda.
Y para finalizar existe el boton Invocar que llamara al servicio web, mostrando los
datos de salida o resultado en una cuadricula/grilla (Tipo Excel).
Siempre a T iempo

Consorcio Nacional de Distribución y Logística S.A. - Victoria 339, Santiago


Teléfono: (2) 550.1500 Fax: (2) 550.1501 - www.chilepost.cl
Ecommerce Integración Clientes / Octubre 2018 – Página 7

Tercer y ultimo paso, dentro del boton Invocar agregue el siguiente codigo:

Con esto ya podrá consumir el servicio web sin problemas.


Siempre a T iempo

Consorcio Nacional de Distribución y Logística S.A. - Victoria 339, Santiago


Teléfono: (2) 550.1500 Fax: (2) 550.1501 - www.chilepost.cl
Ecommerce Integración Clientes / Octubre 2018 – Página 8

Para solicitar a informática la programación y envío de información hacia el cliente, deberá


completar este formulario:
Siempre a T iempo

Consorcio Nacional de Distribución y Logística S.A. - Victoria 339, Santiago


Teléfono: (2) 550.1500 Fax: (2) 550.1501 - www.chilepost.cl

También podría gustarte