plugin oficiales de chilexpress ¿qué contienen?

13
Chilexpress Developers pone a tu disposición tres plugin oficiales, uno para Magento, Prestashop y Woocommerce. Que pueden ser descargados a través de nuestro sitio https://developers.wschilexpress.com de forma gratuita. Nuestros plugin contienen las siguientes operaciones Chilexpress. ¿Qué contienen? PLUGIN OFICIALES DE CHILEXPRESS COBERTURA incorpora en tu sitio el listado de coberturas que posee Chilexpress para sus envíos nacionales. El módulo ofrece el listado de regiones y comunas. TRACKING ten acceso a la información de seguimiento de todas las ordenes de transporte generadas. Pudiendo visualizar tú y tu cliente, el historial y último estado de la OT consultada. COTIZADOR agrega en el carro de compra el costo del envío a través de Chilexpress. Calculado en base a un origen y destino dado, más el volumen y peso de tu pedido. GENERACIÓN DE ORDENES DE TRANSPORTE crea tus ordenes transporte por cada pedido que se genere en tu sitio web. Una OT es un número que permite identificar un envío y que físicamente se transformará en una etiqueta que será adherida al bulto correspondiente.

Upload: others

Post on 06-Jul-2022

5 views

Category:

Documents


0 download

TRANSCRIPT

Page 1: PLUGIN OFICIALES DE CHILEXPRESS ¿Qué contienen?

Chilexpress Developers pone a tu disposición tres plugin oficiales, uno para Magento, Prestashop y Woocommerce. Que pueden ser descargados a través de nuestro sitio https://developers.wschilexpress.com de forma gratuita.

Nuestros plugin contienen las siguientes operaciones Chilexpress.

¿Qué contienen?

PLUGIN OFICIALES DE CHILEXPRESS

COBERTURA incorpora en tu sitio el listado de coberturas que posee Chilexpress para sus envíos nacionales. El módulo ofrece el listado de regiones y comunas.

TRACKING ten acceso a la información de seguimiento de todas las ordenes de transporte generadas. Pudiendo visualizar tú y tu cliente, el historial y último estado de la OT consultada.

COTIZADOR agrega en el carro de compra el costo del envío a través de Chilexpress. Calculado en base a un origen y destino dado, más el volumen y peso de tu pedido.

GENERACIÓN DE ORDENES DE TRANSPORTE crea tus ordenes transporte por cada pedido que se genere en tu sitio web. Una OT es un número que permite identificar un envío y que físicamente se transformará en una etiqueta que será adherida al bulto correspondiente.

Page 2: PLUGIN OFICIALES DE CHILEXPRESS ¿Qué contienen?

Para cada uno de nuestros plugin, se usan las siguientes tecnologías y versiones.

PLUGIN PRESTASHOP (v1.0.4) PHP 7.3 + Prestashop 1.7.6.3 MySql 5.6 +

PLUGIN WOOCOMMERCE (v1.0.9) PHP 7.3 + Wordpress 5.3.2 + Woocommerce 3.9.2 MySql 5.6 +

PLUGIN MAGENTO (v1.0.0) PHP 7.3. 16 + Magento 2.3.4 MySql 5.6 +

El paso a paso de la instalación de cada uno de nuestros plugin se encuentra descrito en el manual adjunto en la descarga del archivo RAR, de cada uno de los plugin por el sitio developers.wschilexpress.com.

Requisitos de Instalación

PLUGIN OFICIALES DE CHILEXPRESS

¿Cómo se instalan?

Page 3: PLUGIN OFICIALES DE CHILEXPRESS ¿Qué contienen?

A continuación se describe el proceso de integración en 8 simples pasos.

PASO 1 Descarga el plugin oficial del sitio developers.wschilexpress.com, ubicado en la

sección DOCUMENTACIÓN < E-COMMERCE haciendo clic en el ícono de la plataforma ecommerce que utilizas.

PASO 2 Instala el plugin en Magento, Prestashop o Woocommerce. Según el procedimiento indicado en el manual anexo. Recuerda que debes descomprimir el archivo RAR descargado, e instalar el ZIP que contiene. Te recomendamos instalar la última versión de nuestro plugin (v1.0.9) , que ya se encuentra disponible en el sitio developers.

¿Cómo me integro?

PLUGIN OFICIALES DE CHILEXPRESS

Page 4: PLUGIN OFICIALES DE CHILEXPRESS ¿Qué contienen?

¿Cómo me integro?

PLUGIN OFICIALES DE CHILEXPRESS

*Recuerda que puedes usar las KEY que vienen por defecto o suscribirte en el sitio developers y obtener las tuyas.

A continuación se describe el proceso de integración en 8 simples pasos.

PASO 3 Configúralo en el ambiente de prueba habilitando los módulos (Georeferencia,

Generación Orden de Transporte y Cotización), ingresando las claves de suscripción y seleccionando el ambiente de test. Además debes ingresar tus datos de cliente, como: nombre, número de teléfono y email. Más el número de la TCC de prueba que te otorgamos en este manual (*). Posterior a eso debes ingresar los datos de la dirección de origen de tus envíos ( comuna, calle y numeración). *TCC prueba = 18578680 **RUT prueba = 96756430

Page 5: PLUGIN OFICIALES DE CHILEXPRESS ¿Qué contienen?

A continuación se describe el proceso de integración en 8 simples pasos.

PASO 3 Configúralo en el ambiente de prueba

¿Cómo me integro?

PLUGIN OFICIALES DE CHILEXPRESS

*Utiliza la TCC de prueba que te otorgamos.

**Utiliza el Rut de prueba que te otorgamos. Además debes recordar que estos campos deben ser iguales y no deben poseer guion, ni dígito verificador.

Page 6: PLUGIN OFICIALES DE CHILEXPRESS ¿Qué contienen?

A continuación se describe el proceso de integración en 8 simples pasos.

PASO 4 Obtén tus claves de suscripción ingresando o registrándote en el sitio

developers.wschilexpress.com y siguiendo los siguientes pasos.

Dirígete a la sección REFERENCIAS DE APIS, aparecerán dos botones, uno denominado "Ver API" que te permite revisar sus funcionalidades y otro denominado "Suscribir" que te permite obtener las claves. Haz clic en este último.

¿Cómo me integro?

PLUGIN OFICIALES DE CHILEXPRESS

Page 7: PLUGIN OFICIALES DE CHILEXPRESS ¿Qué contienen?

¿Cómo me integro?

PLUGIN OFICIALES DE CHILEXPRESS

A continuación se describe el proceso de integración en 8 simples pasos.

PASO 4 Obtén tus claves de suscripción te aparecerá una segunda pantalla donde debes

confirmar la suscripción. Una vez hecha la suscripción te van a aparecer las claves de prueba, una principal y otra secundaria (tal como se muestra en la imagen), sólo debes ingresar la principal para probar el funcionamiento del plugin. Recuerda que para habilitarlo debes solicitar las claves de suscripción de la API Envíos, la cual esta asociada a la habilitación del módulo de “Generación de Orden de Transporte”, la API Coberturas esta asociada al módulo de “Georeferenciación” y la API Cotizador asociada al módulo de “Cotización”.

Page 8: PLUGIN OFICIALES DE CHILEXPRESS ¿Qué contienen?

A continuación se describe el proceso de integración en 8 simples pasos.

PASO 5 Crea la evidencia de prueba mediante la generación de 10 órdenes de transporte

hacia diferentes direcciones de entrega, usando el plugin instalado en ambiente de test. El 60% de la muestra debe poseer una dirección en RM y el 40 % en Regiones. La generación de OT se encuentra habilitada solo para el administrador de la plataforma y se crean de la siguiente forma. 1. Como administrador accede a la pestaña de pedidos, donde veras una lista de todas las

ordenes de clientes que han realizado compras en tu sitio ecommerce. Para crear una OT selecciona la opción “Generar OT” que se encuentra en cada elemento de la lista, en la columna “Acciones”.

2. Esto te llevará a una pantalla de confirmación, de los datos asociados al despacho y selección

de bultos.

¿Cómo me integro?

PLUGIN OFICIALES DE CHILEXPRESS

Botón Generar OT

Page 9: PLUGIN OFICIALES DE CHILEXPRESS ¿Qué contienen?

A continuación se describe el proceso de integración en 8 simples pasos.

PASO 5 Crea la evidencia de prueba

Revisa la información faltante y selecciona los productos que conformarán tu envió u orden de transporte. Puedes agregar más de un producto a un mismo bulto o “package”. Esto te permite generar una OT correspondiente a cada “package” creado; o dicho de otra forma una orden de compra puede tener más de una OT asociada. Es pre requisito que tengas configurado en tu sitio las dimensiones de cada producto, con medidas en centímetros (cm) y peso en kilogramos (kg).

3. Una vez generada la OT, puedes ver en la columna acciones la opción de “Imprimir OT” , la

cual te permite generar la etiqueta que debe incluirse en el bulto correspondiente.

¿Cómo me integro?

PLUGIN OFICIALES DE CHILEXPRESS

Botón Imprimir OT

Número de Orden de Transporte (OT), con el cual puedes realizar seguimiento del envío.

Page 10: PLUGIN OFICIALES DE CHILEXPRESS ¿Qué contienen?

¿Cómo me integro?

PLUGIN OFICIALES DE CHILEXPRESS

A continuación se describe el proceso de integración en 8 simples pasos.

PASO 5 Crea la evidencia de prueba 4. Selecciona el botón “Imprimir OT” y visualiza una pantalla la información del detalle de la

orden y una imagen de la etiqueta generada. Descarga la etiqueta en el formato PDF, presionando el botón Imprimir.

5. Repite este paso 10 veces hasta obtener la totalidad de muestra solicitada y recuerda utilizar 10 direcciones de destino diferentes, según la estructura de 60% en RM y 40% hacia regiones.

PASO 6 Comparte tu evidencia al mail [email protected] a través de un

correo con el motivo “Validación de Etiquetas Portal Developers” que posea tú información de cliente y la muestra de etiquetas adjunta en el formato original obtenido. Datos Cliente • Razón Social • Rut Empresa • N°TCC

Page 11: PLUGIN OFICIALES DE CHILEXPRESS ¿Qué contienen?

A continuación se describe el proceso de integración en 8 simples pasos.

PASO 7 Recibe las credenciales del ambiente productivo una vez que nosotros

validemos la muestra de etiqueta, te compartiremos las claves productivas de cada módulo. Las cuales debes configurar dentro de este ambiente, para quedar operativo. En caso de presentarse errores en la muestra, estos deben ser corregidos tal como se indiquen hasta obtener la validación correspondiente. Debes saber que nos demoramos un plazo máximo de 48 hrs hábiles para hacerte entrega de las KEY.

PASO 8 Configura el ambiente productivo ingresando las credenciales productivas

otorgadas por Chilexpress en la pestaña de habilitación y seleccionando la opción de ambiente productivo.

¿Cómo me integro?

PLUGIN OFICIALES DE CHILEXPRESS

**Modifica del ambiente de test al productivo.

*Ingresa las KEY que te otorgaron en cada módulo

Page 12: PLUGIN OFICIALES DE CHILEXPRESS ¿Qué contienen?

A continuación se describe el proceso de integración en 8 simples pasos.

PASO 8 Configura el ambiente productivo posterior a eso debes configurar los siguientes

datos.

Guarda los cambios realizados y ya estas listo para generar envíos a través de Chilexpress en tu sitio ecommerce.

¿Cómo me integro?

PLUGIN OFICIALES DE CHILEXPRESS

*Utiliza la TCC con la que te otorgaron las KEY

**Cambia los datos por el “Rut Empresa” que poseas. Debes recordar que estos campos deben ser iguales y no deben poseer guion, ni dígito verificador.

Page 13: PLUGIN OFICIALES DE CHILEXPRESS ¿Qué contienen?

Una etiqueta Chilexpress debe poseer las siguientes características, para evitar que el envío sufra inconvenientes durante nuestros procesos. Toda etiqueta debe medir 10 x 5 cm y poseer la estructura que se presenta a continuación. Y debe ser impresa bajo estándares de alta calidad y resolución.

Recuerda que cada etiqueta debe ser adherida al bulto correspondiente, en la cara superior de la encomienda. Durante la validación se podrán detectar los siguientes errores: márgenes y dimensiones fuera del estándar, envío de campos de información erróneos, mala ubicación de los datos en la etiqueta, duplicación de datos en el total de la muestra y adecuaciones a la etiqueta en PDF que alteran la estructura inicial. Que harán que se deba iterar en el transcurso del proceso, solicitando al cliente que realice los ajustes pertinentes. Este proceso posee un tiempo máximo de respuesta de 48 hrs a contar de la recepción del correo, con el detalle de los casos de etiquetas solicitadas en este instructivo. Si el cliente posterior a la validación modifica la calidad y/o dimensiones las etiquetas, sus envíos serán retenidos, teniendo como consecuencia la imposibilidad de admisión de sus envíos pre-chequeados por alguno de nuestros canales. Y deberá volver a solicitar la validación de sus etiquetas.

Recuerda…

PLUGIN OFICIALES DE CHILEXPRESS