This post is also available in: English (Inglés)

Como instalar un módulo

Una vez tengamos generada la licencia y descargado el módulo podemos proceder a la instalación del módulo en PrestaShop.

Hay dos formas de instalar un módulo:

  • Instalándolo desde Prestashop
  • Usando su cliente FTP.

Instalar desde Prestashop

  • Entramos en el Backend del PrestaShop con nuestro usuario y contraseña.
  • Nos dirigimos a la izquierda, sección de Módulos.
  • Buscamos nuestro módulo a instalar en el buscador o podemos filtrar los resultados por módulos no instalados. En el caso de no encontrarlo en el buscador es porque tiene que añadirlo:
  • Escogemos el módulo y le damos a subir a partir de la versión 8 de prestashop ya se instala solo.
  • Nos aparecerá la siguiente ventana en la que se nos informará de que el /los módulos han sido instalados correctamente y nos pedirá la licencia anteriormente generada.
  • Aquí deberemos introducir la licencia generada para poder continuar con la configuración del módulo y guardar.

Utilizando el método FTP

Para instalar un nuevo módulo de PrestaShop manualmente:

  • Descomprimir el fichero del módulo. Esto debería dar lugar a una nueva carpeta.
  • Usando tu cliente FTP, debes conectarte a tu servidor donde esté alojado el PrestaShop y colocar la carpeta descomprimida del módulo en el directorio de módulos, /modules.
  • Busque el nuevo módulo en la lista de módulos.
  • En el nuevo módulo, haga clic en el botón «Instalar».
  • Su módulo está instalado y debe activarse también. Si es necesario, haga clic en el enlace «Configuración» del módulo.

Una vez finalizada la configuración, asegúrese de probar el módulo para comprobar que funciona según lo previsto. Ante cualquier problema puede solicitar soporte en tickets.informax.es

RECUERDA El módulo  puede estar instalado en su servidor web a la vista del público o instalado localmente para realizar pruebas, cambios, actualizaciones y demás en su ordenador sin necesidad de hacerlo en su tienda en producción.

Como descargar los módulos

Para descargar los módulos desde nuestra tienda en tienda.informax.es ha de acceder con su usuario y su contraseña a la zona privada de usuario. En la zona superior, hay que hacer click en «Iniciar Sesión»:

Esto les llevará a la pantalla de inicio de sesión, donde deberán introducir sus datos de cliente:

En caso de no recordar su contraseña, tiene la posibilidad de recuperarla haciendo click en «¿Olvidó su contraseña?». Si lo que no recuerda es el correo de cliente, puede abrirnos un ticket desde tickets.informax.es, donde podremos ayudarle a recuperar su cuenta.

Una vez hayamos introducido el usuario y la contraseña nos llevará a la siguiente pantalla:

Aquí podemos acceder a «Mis Descargas» donde veremos disponibles todas las descargas de módulos adquiridos en nuestra tienda de módulos para Prestashop.

En caso de no ser capaces de realizar la descarga, le recordamos que estamos disponibles en tickets.informax.es, donde puede solicitar ayuda o preguntarnos sobre cualquier problema técnico que le surja con el módulo.

Si quiere puede verlo también en un vídeo:

Como generar la licencia

Una vez hayamos adquirido y completado el pago de nuestros módulos podremos generar la licencia.

Si no se ha realizado en el proceso de la compra, desde la zona de cliente de nuestra tienda tenemos la posibilidad de generarla. Para acceder a la zona privada primero debemos ingresar en la tienda en tienda.informax.es, para ello  iremos al enlace que pone «Iniciar sesión».

Una vez nos hayamos autenticado se nos mostrara la siguiente pantalla:

Aquí nos dirigimos a la sección de «Mis Licencias» que nos llevará a la siguiente pantalla:

Aquí nos pide el nombre de dominio que nos solicita el modulo al instalarlo en su tienda. Importante que el nombre de dominio ha de ponerse sin http:// o https://, generándo la licencia para exactamente el dominio que indica en el módulo:

Ha de copiar el nombre de dominio tal cual se muestra en esa pagina y viene despues del texto:

La Licencia se deberia generar para el dominio: ***.**********.***

También puede verlo en el siguiente vídeo:

 

 

Introducir las credenciales de DHL

Lo primero que hay que hacer es crear una credencial. Para eso tenemos que ir a la pestaña del módulo «Configuración>Nueva Credencial». En ella veremos los siguientes campos:

Nombre de la credencial: Pueden poner el que quieran. Sirve para diferenciar las credenciales en caso de que tengan varias.

URL: Este campo ya viene cubierto y no es necesario cambiarlo

Id Usuario: Aquí tiene que introducir el Username que les ha proporcionado DHL. Tendrá un formato similar a este: 12920155INF

Clave: Aquí tiene que introducir la Password que les ha proporcionado DHL. Tendrá un formato similar a este: mem6540f-myt5-4gb8-opl2-990yhj80p54b

Código de cliente: Aquí tiene que introducir el Customer que les ha proporcionado DHL. Tendrá un formato similar a este: 14-114529

Seleccione la tienda de origen: Aquí podrá elegir la tienda que quiere asociar a su credenciales. Si no le sale nada, significa que no tiene ninguna creada. Podrá crearla desde «Parámetros de la tienda>Contacto>Tiendas>Añadir nueva tienda»

Seleccione el producto, por defecto es B2B: Aquí puede elegir entre entorno B2B o B2C

Una vez esté cubierto todo, pulsamos el botón de Guardar y se creará nuestra credencial.

Configuración general

Desde la pestaña «Configuración>Configuración» podremos establecer la configuración general del módulo. En ella veremos los siguientes campos:

Seleccione el numero de elementos a procesar en cada llamada del cron: Cantidad de pedidos que el módulo leerá cada vez que se ejecute

Seleccione el estado cuando este enviado: Estado al que pasará el pedido una vez esté enviado

Seleccione el estado en el que quiere enviar los pedidos: Los pedidos se enviarán cuando tengan uno de los estados marcados en esta sección. Puede marcar uno o varios

Seleccione las formas de pago contrareembolso: Si en su tienda no admite pago contrarembolso, no es necesario que marque ninguna

Poner el mismo transportista en distintas credenciales: Marcarla le permite usar el mismo transportista en varias de sus credenciales

Seleccione una credencial por defecto: Pueden seleccionar la credenciales que quieren que el módulo utilice de forma predeterminada

Realizar hold o release sobre los pedidos enviados a Dhl: Permite bloquear un pedido para que no salga en el cierre del día. No aparecerá en él hasta que lo libere.

Ignorar tiempo de espera: Esta opción aparece únicamente cuando la opción Hold/Release está activada. Al realizar el release de varios pedidos en el cierre del día, el módulo introduce una pausa de 3 segundos entre cada operación para evitar sobrecargar la API de DHL. Activando esta opción se elimina esa pausa y el proceso se ejecuta sin esperas. Solo es recomendable si tiene un gran volumen de pedidos y el proceso de cierre diario tarda demasiado.

Forzar peso mínimo: Hace que los pedidos siempre tengan el peso mínimo

Configuración de las credenciales

Para configurar una credencial en concreto nos iremos a la pestaña «Configuración>Credencial: Nombre credencial-Nombre tienda de origen>Configuración».

Desde aquí se configura el transportista de PrestaShop que el módulo usará para identificar los pedidos de DHL. Las etiquetas solo se generarán en pedidos que tengan asignado uno de los transportistas seleccionados; el resto serán ignorados por el módulo.

Crear un nuevo transportista desde el módulo

Si aún no tiene ningún transportista DHL en su PrestaShop, el módulo puede crearlo automáticamente. Pulse el botón Crear nuevo transportista. El módulo creará un transportista llamado «Dhl» con el logo y la URL de seguimiento de DHL Parcel ya configurados (https://www.dhl.com/es-es/home/tracking/tracking-parcel.html?tracking-id=@&submit=1), y lo asignará automáticamente a esta credencial.

Usar un transportista existente

Si ya tiene un transportista DHL creado en PrestaShop, puede asociarlo a esta credencial marcándolo en la lista de transportistas. Puede asociar varios transportistas a la misma credencial si lo necesita.

Importante: Para que el enlace de seguimiento funcione correctamente en los correos al cliente, el transportista debe tener configurada la siguiente URL de seguimiento:

https://www.dhl.com/es-es/home/tracking/tracking-parcel.html?tracking-id=@&submit=1

El símbolo @ es sustituido automáticamente por PrestaShop con el número de seguimiento real. Si ha creado el transportista desde el módulo con el botón Crear nuevo transportista, esta URL ya viene configurada.

Una vez seleccionados, pulse Guardar.

 

Automatizar el módulo

Para que el módulo pueda generar las etiquetas de forma automática, tendrán que configurar en su servidor la tarea cron que encontrarán en la pestaña «Configuración>Cron».

También se pueden generar de forma manual desde los pedidos que tengan cómo transportista a los que ha seleccionado mientras configuraban las credenciales.

Para poder generar el cierre del día de forma automática, tiene que configurar la tarea cron que encontrará en la pestaña «Configuración>Credencial: Nombre credencial-Nombre tienda de origen>Cron Cierre del día».

Este cron lo debe configurar para que se ejecute antes de que llegue el transportista a recoger los paquetes. Puede ejecutarlo varias veces al día sin problema.

El cierre del día es imprescindible: Si no se ejecuta, DHL no recibirá la información de los envíos y no habrá actualizaciones de seguimiento. Las etiquetas existirán, pero los pedidos quedarán retenidos sin ser procesados por DHL.

Los datos pueden tardar hasta 24 horas en aparecer en la plataforma de seguimiento de DHL.

Una vez generado, el módulo guarda automáticamente el PDF con el resumen de los pedidos de ese día. Todos los cierres quedan almacenados en el servidor, organizados por fecha, por lo que puede descargar cierres de días anteriores cuando lo necesite. Los encontrará en la pestaña Cierre del día, seleccionando la fecha correspondiente.

Desactivar control de solapamiento: El módulo incluye un mecanismo para evitar que dos tareas cron se ejecuten al mismo tiempo. Si por algún motivo un proceso quedó bloqueado y la tarea cron no puede ejecutarse, puede activar esta opción para ignorar ese bloqueo.

Gestión de etiquetas desde la ficha de pedido

El módulo añade un bloque DHL Parcel en la ficha de cada pedido del panel de administración de PrestaShop. Desde aquí puedes gestionar las etiquetas de envío de forma manual, independientemente de la automatización por cron.

Cuando no hay etiqueta generada, verás un formulario con las siguientes opciones:

Bultos: Indica el número de paquetes que componen el envío (por defecto 1).

Credencial: Si tienes varias credenciales configuradas, selecciona cuál quieres usar para generar la etiqueta.

Generar etiqueta: Pulsa este botón para enviar el pedido a DHL y obtener la etiqueta PDF al instante.

Cuando la etiqueta ya está generada, el bloque muestra:

Descargar PDF: Enlace para descargar la etiqueta en formato PDF.

Cancelar envío: Cancela la etiqueta generada ante DHL. Úsalo si necesitas modificar el pedido antes de entregarlo al transportista.

Realizar hold: Retiene el pedido en DHL para que no se procese en el cierre del día. Útil cuando el pedido está pendiente de alguna comprobación.

Realizar release: Libera un pedido que estaba en hold para que se incluya en el próximo cierre del día.

Generar etiqueta de devolución: Crea una etiqueta adicional para que el cliente pueda devolver el pedido.

Cancelar etiqueta de devolución: Cancela la etiqueta de devolución si ya no es necesaria.

En la parte inferior del bloque se muestra una tabla con el histórico completo de acciones realizadas sobre el pedido: fecha, credencial usada, tipo (normal o devolución), acción, estado, número de tracking DHL, mensaje de respuesta y enlace al PDF si está disponible.

Número de seguimiento

Cuando el módulo genera una etiqueta DHL correctamente, guarda automáticamente el número de seguimiento en el pedido de PrestaShop. Este número es visible en la ficha del pedido, dentro de la pestaña Transportistas, en el campo Número de seguimiento.

Número de seguimiento en la pestaña Transportistas de PrestaShop

PrestaShop utiliza ese número para enviárselo al cliente en el correo electrónico de cambio de estado «En tránsito» (plantilla in_transit), donde aparece como enlace de seguimiento.

¿Por qué no aparece el número de seguimiento en el correo al cliente?

Si el cliente no recibe el número de seguimiento en el correo, el módulo está funcionando correctamente: el problema está en la plantilla de correo de PrestaShop. Para que el número aparezca en el email, la plantilla in_transit de su tema de correos debe incluir las variables {shipping_number} y {followup}.

Para comprobarlo y corregirlo:

  1. Vaya a Parámetros avanzados > Correos electrónicos en el panel de PrestaShop.
  2. Localice la plantilla in_transit y verifique que contiene {shipping_number}.
  3. Si la plantilla no existe o no tiene esa variable, deberá crearla o editarla manualmente añadiendo el número de seguimiento en el cuerpo del correo.

Estados de seguimiento en la ficha del pedido

El módulo actualiza automáticamente el estado del pedido en PrestaShop únicamente en dos casos:

  • Enviado: cuando se genera la etiqueta y el pedido pasa por uno de los estados configurados en la sección de configuración general.
  • Entregado: cuando DHL confirma la entrega (código de evento R o RS).

El resto de eventos de seguimiento que DHL va registrando (en tránsito, en reparto, intento de entrega, etc.) no cambian el estado del pedido en PrestaShop, pero sí quedan guardados y son visibles en la ficha del pedido, dentro del bloque DHL Parcel, en el apartado de seguimiento.

Con esto ya estaría configurado su módulo de DHL Parcel para Prestashop .

 

 

Una vez más, si tiene problemas para configurar el importador puede solicitarnos ayuda abriendo un ticket en https://tickets.informax.es o escribiendo un correo a soportemodulos@informax.es.