VibeFox LP Express for PrestaShop — Ayuda
Requisitos
PrestaShop: 8.0 a 9.x.
PHP: 8.0 o posterior. El módulo se niega a instalarse en versiones anteriores de PHP.
LP Express: no hace falta una cuenta de API. LP Express no tiene una API pública de precios, y el módulo no usa la API de Unisend, así que introduces tus propios precios (de contrato). Crea los paquetes en tu cuenta de Unisend ("Mano siuntos").
Lista de terminales de paquetes: el módulo usa la lista abierta de terminales de LP Express (https://www.lpexpress.lt/index.php?cl=terminals&fnc=getTerminals). No se necesita clave. Si esta lista en línea no está disponible, el módulo usa la última copia descargada si existe, y si no, tu propia lista. Prepárate para introducir tu propia lista (ver Configuración).
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un dominio.
Instalación
1. En el back office ve a Modules > Module Manager y haz clic en Upload a module. Elige el archivo ZIP del módulo.
2. Cuando termine la subida, haz clic en Configure, o busca VibeFox LP Express más tarde en la lista de módulos y haz clic en Configure.
3. Introduce tu clave de licencia de VibeFox en License key en el bloque de licencia de la parte superior de la página Configure y haz clic en Activate (ver Clave de licencia).
4. Rellena la tabla de precios (al menos una fila) o un coste alternativo. Comprueba la línea de estado sobre los terminales de paquetes en la parte superior de la página y añade tu propia lista de terminales si la lista en línea no está disponible. Haz clic en Save.
Al instalarse, el módulo crea el transportista LP Express parcel terminal con el texto de plazo de entrega Delivery to an LP Express parcel terminal. El transportista se asigna a la zona de Lituania y a todos los grupos de clientes. Puedes añadir zonas y cambiar los grupos de clientes, el plazo de entrega, el logotipo y los límites de tamaño en Shipping > Carriers. No definas precios allí: el precio siempre proviene del módulo.
Configuración
Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox LP Express > Configure. Cada sección tiene su propio botón Save, que guarda toda la página. Cada guardado también vuelve a cargar la lista de terminales.
En la parte superior de la página, los avisos muestran los problemas y el estado de los terminales. Aparece una advertencia cuando no hay ningún precio configurado o no hay ningún terminal de paquetes disponible, porque entonces el transportista no se muestra en la finalización de compra; también cuando el transportista se ha eliminado, y cuando la unidad de peso de la tienda no es una que el módulo conoce (kg, g, lb, oz), porque entonces los pesos de los productos se leen como kg. Una línea informativa muestra cuántos terminales de paquetes en cuántas ciudades están disponibles y de qué fuente: la lista en línea, una copia guardada de la lista en línea (con su fecha) o tu propia lista.
Al guardar, un título de método vacío o no válido como nombre de transportista se rechaza con Enter a valid method title., y también se rechaza un título de más de 64 caracteres. En ambos casos no se guarda nada. Un importe o un peso que no sea un número (o que sea negativo) se notifica, y se mantiene su valor anterior. Un Minimum weight (kg) mayor que Maximum weight (kg) (30 kg cuando el máximo está vacío) también se notifica, porque el transportista nunca se mostraría, y ambos pesos mantienen sus valores anteriores. Los precios de la tabla que no sean números se notifican y se dejan vacíos.
General
Enable/Disable: activa o desactiva LP Express. Es el mismo interruptor que el estado del transportista en Shipping > Carriers.
Method title: el nombre del transportista que ven los clientes en el carrito y en la finalización de compra. Predeterminado: LP Express parcel terminal. Obligatorio.
Tax status: None significa que los precios de abajo son definitivos. Taxable con una regla de impuesto (una opción por cada regla de impuesto de tu tienda) significa que PrestaShop añade ese impuesto de envío sobre los precios de abajo. Es la regla de impuesto del transportista.
Precios (en la moneda predeterminada de tu tienda; los decimales pueden escribirse como 2.99 o 2,99)
Price table: una fila por país de destino. Haz clic en + Add country para añadir una fila y en el icono de papelera para eliminar una. Elige * Any other country para todos los países que no tengan fila propia. Cada fila tiene un Base price y columnas de peso: XS (≤1 kg), S (≤2 kg), M (≤3 kg), L (≤5 kg) y XL (>5 kg). El peso es el del carrito, o el peso de un artículo con Per item. Una columna vacía usa el precio base de la fila. 0 significa gratis.
Fallback cost: se usa cuando la tabla de precios no tiene una fila para el país de destino. Déjalo vacío para ocultar el transportista en esos países.
Calculation: cómo se calcula el precio.
Free shipping from: el total del carrito (productos que requieren envío, después de descuentos, sin impuestos) a partir del cual LP Express es gratuito. Déjalo vacío si no hay envío gratuito.
Disponibilidad
Minimum weight (kg): oculta el transportista cuando el carrito pesa menos. Vacío o 0 significa sin límite.
Maximum weight (kg): oculta el transportista cuando el carrito pesa más. Los terminales de LP Express aceptan paquetes de hasta 30 kg. Predeterminado: 30. 0 significa sin límite. Vacío significa 30 kg en las zonas del transportista, y sin límite solo para los países de Ignore shipping zones fuera de ellas.
Minimum cart total: muestra el transportista solo a partir de este total del carrito (productos que requieren envío, después de descuentos, sin impuestos). Déjalo vacío para mostrarlo siempre.
Ignore shipping zones: ofrece LP Express para los países indicados abajo sin configurar las zonas tú mismo. El transportista se vincula entonces a todas las zonas activas (también a las zonas creadas más adelante). Las zonas que tenía el transportista antes siguen permitidas para todos sus países. Cuando desactivas la opción, el transportista recupera las zonas que tenía antes. Cuando está desactivada, los países los definen las zonas del transportista en Shipping > Carriers. Se recomienda.
Countries (without zones): los países de destino para ese modo. Este campo solo se usa cuando Ignore shipping zones está activado. Déjalo vacío para ofrecer el transportista en todos los países.
Terminales de paquetes
Terminal list: de dónde proceden los terminales.
Own terminal list: un terminal por línea con el formato ID | Name | City | Address | ZIP, por ejemplo 1234 | LP EXPRESS Akropolis | Vilnius | Ozo g. 25 | LT-07150. ID y City son obligatorios. Las líneas que empiezan por # se ignoran. Usa los ID de terminal que espera tu cuenta de Unisend.
Avanzado
Debug log: escribe el cálculo de precios y los detalles de la lista de terminales en logs/vfd_lpex_debug.log.php, en la carpeta del módulo. El archivo no se puede abrir desde la web. Los errores, como una lista de terminales no disponible, siempre se registran. No se registra ningún dato del cliente.
Log: muestra el tamaño y las últimas entradas del registro. Haz clic en Clear log para vaciarlo.
Remove data on uninstall: si está activado, al desinstalar el módulo se eliminan los ajustes, el transportista y la lista de terminales guardada. Si está desactivado, al desinstalar solo se desactiva el transportista. El terminal guardado en los pedidos siempre se conserva.
Cómo funciona en la finalización de compra
En el paso de envío, PrestaShop pide al módulo el precio de LP Express. Solo cuentan los productos físicos: los productos virtuales no añaden peso y no se incluyen en el total del carrito. El módulo comprueba los países de Ignore shipping zones, el peso del carrito y el total mínimo del carrito. Si se aplica el envío gratuito, el precio es 0. Si no, el precio sale de la fila del país (o de la fila *): la columna de peso; si no hay, el precio base; y si tampoco, el coste alternativo. Si no hay precio, o no hay ningún terminal de paquetes disponible, el transportista se oculta, así que el cliente nunca ve una finalización de compra que no se pueda completar.
Los precios e importes están en la moneda predeterminada de tu tienda. Después, el precio se muestra en la moneda del carrito del cliente, usando el tipo de cambio de PrestaShop.
La lista de terminales en línea se guarda en caché durante 24 horas. Una descarga fallida se recuerda durante 15 minutos, para que la finalización de compra no espere a la lista en cada recarga. El tiempo límite de descarga es de 10 segundos. Solo se ofrecen los terminales activos de la lista.
Si editas el transportista en Shipping > Carriers después de que tenga pedidos, PrestaShop lo guarda como una nueva versión del transportista. El módulo sigue la nueva versión automáticamente.
El módulo no solicita precios de LP Express ni de Unisend, no crea envíos, no imprime etiquetas, no llama a un mensajero ni hace seguimiento de paquetes. Crea los paquetes en tu cuenta de Unisend ("Mano siuntos"). La entrega a domicilio por mensajería (puerta a puerta) no forma parte de este transportista.
Puntos de recogida
Cuando el cliente selecciona LP Express, debajo del transportista aparece el bloque LP Express parcel terminal con dos listas: -- Select city -- y -- Select parcel terminal --. La ciudad de la dirección de entrega se preselecciona cuando coincide con una ciudad de la lista. Cada terminal se muestra con su nombre, dirección y código postal. La elección se guarda en el carrito de inmediato, así que no se pierde cuando la finalización de compra se actualiza. Funciona con los temas Classic y Hummingbird.
Es obligatorio elegir un terminal. Sin uno, Continue en el paso de envío y Place order muestran Please select an LP Express parcel terminal. Cuando el cliente hace clic en Continue, el servidor vuelve a comprobar el terminal en la lista, así que un ID de terminal falsificado o desactualizado se rechaza con The selected LP Express parcel terminal is not available any more. Please select a parcel terminal again.
El ID, el nombre y la ciudad del terminal se guardan con el pedido. Se muestran en el bloque LP Express parcel terminal de la página del pedido en el back office (con Terminal ID), en la página de confirmación del pedido y en los detalles del pedido del cliente. En el correo de confirmación del pedido y en el correo de nuevo pedido al comerciante, se añaden al nombre del transportista como LP Express parcel terminal: seguido del terminal. Si un pedido no tiene terminal, la página del pedido en el back office muestra No parcel terminal was chosen for this order.
Clave de licencia
El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox LP Express es el primer bloque de Modules > Module Manager > VibeFox LP Express > Configure, por encima de los ajustes. Pega la clave en License key y haz clic en Activate. Después, el bloque muestra la clave enmascarada, el estado (por ejemplo, la fecha hasta la que la licencia está activa y tu dominio) y los botones Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para eliminar la clave de esta tienda. Debajo aparecen la línea Product: presta-shipping-lp-express y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los empleados con el permiso Configure del módulo pueden cambiar la clave. Los textos del bloque siguen el idioma del back office (se incluyen inglés y ruso).
Si la clave no se acepta, el bloque indica el motivo, por ejemplo Key not found, This key belongs to another product, Domain limit reached o License expired on seguido de una fecha. Después de cambiar la dirección de la tienda, o después de liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si no se puede contactar con el servidor de licencias, el módulo sigue funcionando con el último estado conocido.
Una clave funciona en un dominio: el dominio de la tienda principal, también en una configuración multitienda. Quitar la clave de la tienda no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.
Sin una clave activa, el transportista LP Express no se muestra a los clientes en la finalización de compra y no se calcula ninguna tarifa. La tienda de PrestaShop no sabe que has iniciado sesión en el back office, así que el transportista también se oculta para ti: puedes configurar el módulo antes de comprar una clave, pero no probarlo en la finalización de compra. Aparece un recordatorio en Modules > Module Manager, en la pestaña Alerts. Los pedidos existentes no se ven afectados.
Cuando una licencia caduca, el módulo sigue funcionando, pero las actualizaciones y el soporte necesitan una renovación. El estado se vuelve a comprobar automáticamente mientras trabajas en el back office: una vez al día durante los primeros 14 días después de introducir la clave, y después una vez a la semana. No se necesita ninguna tarea cron. Desinstalar o restablecer el módulo siempre elimina la clave de licencia y el estado de la licencia.
Solución de problemas
LP Express no aparece en la finalización de compra: comprueba que la licencia esté activa y que Enable/Disable esté activado. En Shipping > Carriers, comprueba que el transportista cubra la zona del país del cliente y el grupo del cliente (o que Ignore shipping zones esté activado y el país esté permitido). Abre la página del módulo: un aviso explica si no hay ningún precio configurado o si no hay ningún terminal de paquetes disponible. Comprueba también los límites de peso y el Minimum cart total. Los productos también pueden limitarse a ciertos transportistas en la página del producto. Con Debug log activado, el campo Log de la página del módulo muestra por qué se ocultó el transportista.
No hay terminales de paquetes: no se pudo cargar la lista en línea y no hay copia guardada ni lista propia. El módulo vuelve a intentarlo cada 15 minutos. Introduce tu propia lista en Own terminal list, o elige Only my own list.
La lista de terminales está desactualizada: haz clic en Save en la página del módulo. Así se vuelve a cargar la lista de terminales. Con tu propia lista, actualiza las líneas tú mismo.
El cliente no puede continuar: hay que elegir un terminal de paquetes. Si el cliente ve The LP Express parcel terminal list is temporarily unavailable. Please try again later or choose another shipping method., no hay terminales disponibles en este momento. Añade tu propia lista.
Moneda de los precios: la moneda predeterminada de tu tienda. Los clientes que paguen en otra moneda ven el precio convertido con el tipo de cambio de PrestaShop.
La página indica que no se encontró el transportista LP Express: el transportista se eliminó en Shipping > Carriers. Restablece el módulo en Modules > Module Manager para volver a crearlo.
Desinstalación
Ve a Modules > Module Manager, abre el menú junto a VibeFox LP Express y elige Uninstall. La clave de licencia y el estado de la licencia siempre se eliminan. La lista de terminales en caché siempre se borra. Si Remove data on uninstall está activado, el transportista se elimina (los pedidos conservan su historial), y se eliminan los ajustes, el registro y la copia guardada de la lista de terminales. Si está desactivado, el transportista solo se desactiva y se conservan todos los ajustes y la copia guardada. Si vuelves a instalar el módulo, el transportista guardado recupera el estado que tenía. El terminal guardado en los pedidos nunca se elimina.
LP Express es una marca comercial de su respectivo titular. Este módulo no está afiliado a LP Express ni cuenta con su respaldo.