VibeFox GLS ParcelShop for PrestaShop — Ayuda
Requisitos
PrestaShop: 8.0 a 9.x. La selección de ParcelShop funciona en los temas Classic y Hummingbird.
PHP: 8.0 o posterior. El módulo no permite la instalación en versiones anteriores de PHP.
GLS: el módulo no usa ni necesita cuenta de GLS ni clave de API. El mapa de ParcelShop es público. Necesitas un contrato con GLS para enviar los paquetes a los ParcelShop elegidos.
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 carga, haz clic en Configure, o busca VibeFox GLS ParcelShop 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 (consulta Clave de licencia).
4. Define tus precios: al menos una fila de Country prices (por ejemplo * Default) o un Fallback cost (consulta Configuración), y haz clic en Save.
Al instalarse, el módulo crea el transportista GLS ParcelShop con el texto del plazo de entrega Delivery to a GLS ParcelShop of your choice. El transportista se asigna a todos los grupos de clientes y a las zonas de los países del mapa de GLS (en una tienda estándar, normalmente Europe y Europe (non-EU)). Puedes cambiar las zonas, los grupos de clientes, el plazo de entrega y el logotipo en Shipping > Carriers. No definas precios allí: el precio siempre procede del módulo.
Configuración
Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox GLS ParcelShop > Configure. Cada sección tiene su propio botón Save, que guarda toda la página.
Las advertencias en la parte superior de la página señalan problemas de configuración: no se encontró el transportista; la unidad de peso de la tienda no la reconoce el módulo (define kg, g, lb u oz en International > Localization, Local units); no hay ningún precio definido; o alguno o todos los Countries (ignore zones mode) seleccionados no están cubiertos por el mapa de GLS. Un número no válido o negativo se rechaza con un mensaje que indica el campo, y se mantiene su valor anterior. Los demás campos se guardan igualmente.
General
La sección muestra los países cubiertos por el mapa de GLS. El transportista no se ofrece para otros países de destino.
Enable/Disable: activa o desactiva GLS ParcelShop. Es el mismo interruptor que el estado del transportista en Shipping > Carriers.
Name: el nombre del método de envío que ve el cliente (el nombre del transportista). Por defecto: GLS ParcelShop. Obligatorio, máximo 64 caracteres.
Tax status: la regla fiscal del transportista. None significa que el envío no tiene impuestos. Elige una regla fiscal para que el envío tribute.
Prices
Los precios se introducen en la moneda predeterminada de tu tienda, sin impuestos. Los decimales pueden escribirse con coma o con punto (4,99 o 4.99). El precio se muestra al cliente en la moneda del carrito.
Calculation type: cómo se aplica el precio.
Country prices: una tabla con 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. Cada fila tiene un Country, un Price y cinco columnas de peso: XS hasta 1 kg, S 1-2 kg, M 2-3 kg, L 3-5 kg y XL más de 5 kg. Se usa la columna del peso del carrito. Una columna de peso dejada en 0 usa la columna Price. La fila * Default se usa para los países sin fila propia. Las filas nuevas empiezan con * Default y 0 en todas las columnas, y una fila con todos los precios en 0 da envío gratis, así que elige el país y rellena los precios antes de guardar. Si un valor de la tabla no es un número válido, no se guarda toda la tabla y el mensaje indica los valores incorrectos.
Fallback cost: el precio que se usa cuando la tabla no tiene fila para el país de destino y no hay fila * Default. Déjalo vacío para ocultar el transportista en esos países.
Free shipping from: el subtotal del carrito (después de descuentos, sin impuestos) a partir del cual el envío con GLS ParcelShop es gratis. Déjalo vacío si el envío nunca es gratis.
Availability
Minimum weight (kg): oculta el transportista cuando el carrito pesa menos. El peso se convierte desde la unidad de peso de tu tienda. Vacío o 0 significa sin límite.
Maximum weight (kg): oculta el transportista cuando el carrito pesa más. Por defecto: 20. Los ParcelShop de GLS suelen aceptar paquetes de hasta 20 kg, así que comprueba tu contrato con GLS. Vacío o 0 significa sin límite. Si el mínimo es mayor que el máximo, se rechazan ambos pesos con un mensaje y se mantienen los valores anteriores.
Minimum cart subtotal: ofrece el transportista solo cuando el subtotal del carrito (después de descuentos, sin impuestos) alcanza este importe. Déjalo vacío si no quieres mínimo.
Ignore shipping zones: cuando está activado, el transportista se vincula a todas las zonas, incluidas las desactivadas, y se ofrece para los países seleccionados abajo, aunque no estén en sus zonas. Las zonas creadas más tarde también se vinculan. Al desactivarlo, el transportista recupera las zonas que tenía antes y se ofrece solo en ellas. Por defecto: desactivado.
Countries (ignore zones mode): los países de destino para ese modo. Déjalo vacío para usar todos los países del mapa de GLS. Los países que no están cubiertos por el mapa de GLS se omiten. Este campo solo se usa cuando Ignore shipping zones está activado.
Advanced
Debug log: escribe los cálculos de tarifas y las elecciones de ParcelShop en logs/vfd_glps_debug.log.php, dentro de la carpeta del módulo. El archivo no se puede abrir desde la web. Los errores siempre se registran. No se registran datos personales de los clientes. Desactiva el registro cuando termines.
Log: muestra el tamaño y las últimas entradas del registro de depuración. Haz clic en Clear log para vaciarlo.
Remove data on uninstall: cuando está activado, al desinstalar el módulo se eliminan los ajustes, el transportista y el registro. Cuando está desactivado, todo se conserva para una reinstalación. El ParcelShop guardado en los pedidos siempre se conserva.
Cómo funciona en la finalización de compra
Cuando PrestaShop muestra el paso de entrega, pide al módulo el precio de GLS ParcelShop. Solo cuentan los productos físicos: los productos virtuales no añaden peso y no se incluyen en el subtotal del carrito. El módulo comprueba primero las condiciones: que el país de entrega esté cubierto por el mapa de GLS (y esté seleccionado en Countries (ignore zones mode) cuando ese modo está activado), el peso del carrito y el subtotal mínimo del carrito. Si el subtotal del carrito alcanza Free shipping from, la entrega es gratis. Si no, el precio se toma de la fila del país (o de la fila * Default) y de la columna de peso, o de Fallback cost. Si no se encuentra ningún precio, el transportista se oculta.
Cuando el cliente selecciona GLS ParcelShop, aparece debajo del transportista un recuadro GLS ParcelShop con un botón Select GLS ParcelShop. Abre el mapa oficial de GLS ParcelShop para el país de entrega. Después de elegir un ParcelShop, se muestran su nombre y su dirección, y el botón cambia a Change ParcelShop. La elección se guarda en el carrito, así que se mantiene cuando el paso de entrega se actualiza o la página se recarga. Si la dirección de entrega cambia a otro país, el cliente tiene que volver a elegir un ParcelShop.
Cuando el cliente hace clic en Continue en el paso de entrega, el módulo comprueba que se haya elegido un ParcelShop y que esté en el país de entrega. Si no, el cliente ve Please select a GLS ParcelShop. o The selected GLS ParcelShop is not in your shipping country. Please choose a ParcelShop again. y permanece en el paso de entrega. Si el ParcelShop no se puede guardar, el cliente ve The ParcelShop could not be saved. Please try again. Si no se puede cargar el script del mapa de GLS, el cliente ve un mensaje para recargar la página o elegir otro método de envío.
El mapa de GLS se ejecuta en el navegador del cliente. En la finalización de compra, el módulo carga el script del mapa desde map.gls-croatia.com, y el mapa carga los datos de los ParcelShop y las teselas del mapa desde GLS. GLS recibe los datos habituales de la solicitud del visitante (dirección IP, navegador). Tu servidor no envía nada a GLS.
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 obtiene tarifas en tiempo real de GLS, no crea envíos de GLS, no imprime etiquetas ni hace el seguimiento de paquetes. No tiene una lista de ParcelShop en tu servidor, así que no puede verificar el ID del ParcelShop con GLS. Entrega el ParcelShop ID del pedido a GLS de la forma habitual (MyGLS, tu software de GLS u otro módulo).
Puntos de recogida
Cuando se realiza el pedido, el ParcelShop del carrito se guarda con el pedido: su ID, su nombre con la dirección y su país. Ya no cambia con el carrito.
Página del pedido en el administrador: un bloque GLS ParcelShop muestra el nombre y la dirección del ParcelShop, con el ParcelShop ID y el país. Si un pedido de GLS ParcelShop no tiene ParcelShop, el bloque muestra No ParcelShop was selected for this order.
Páginas del cliente: el ParcelShop se muestra en la página de confirmación del pedido y en la página de detalles del pedido de la cuenta del cliente.
Correos electrónicos: el ParcelShop se añade al nombre del transportista en el correo de confirmación del pedido que recibe el cliente. El correo de nuevo pedido para el comerciante (módulo Mail alerts) también incluye el ParcelShop ID.
Clave de licencia
El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox GLS ParcelShop es el primer bloque de Modules > Module Manager > VibeFox GLS ParcelShop > Configure, encima de los ajustes. Introduce 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-gls-parcelshop 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 solo 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 GLS ParcelShop no se muestra a los clientes en la finalización de compra y no se calcula ninguna tarifa. El front office 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 requieren 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 por semana. No se necesita ninguna tarea cron. Desinstalar o restablecer el módulo elimina siempre la clave de licencia y el estado de la licencia.
Solución de problemas
GLS ParcelShop 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 activa Ignore shipping zones y revisa Countries (ignore zones mode)). Comprueba que el país de destino sea uno de los países del mapa de GLS y que tenga un precio (una fila de país, la fila * Default o Fallback cost). Revisa los límites de peso y el Minimum cart subtotal. Los productos también pueden estar limitados a ciertos transportistas en la página del producto. Activa el Debug log y revisa el campo Log para ver el motivo.
El mapa no se abre: el cliente ve "The GLS ParcelShop map could not be loaded..." cuando el script de GLS está bloqueado, por ejemplo por un bloqueador de anuncios o de privacidad, por una política de seguridad de contenido o por una caída de GLS. Permite map.gls-croatia.com en tu política de seguridad de contenido.
La entrega es gratis para un país por error: revisa la fila de ese país en Country prices. Una fila en la que el Price y todas las columnas de peso son 0 da envío gratis.
La tabla o un campo no se guardó: un valor no es un número válido. El mensaje en la parte superior de la página indica el valor. Usa dígitos con coma o punto como separador decimal.
La página indica que no se encontró el transportista GLS ParcelShop: el transportista se eliminó en Shipping > Carriers. Usa Reset en Modules > Module Manager para volver a crearlo. Reset mantiene el estado de un transportista existente: un transportista desactivado sigue desactivado.
Un pedido no tiene ParcelShop y el registro indica que el ParcelShop del carrito ya está guardado en otro pedido: un carrito se convirtió en dos pedidos. El primer pedido conserva el ParcelShop. Entrega el segundo pedido a GLS manualmente.
Desinstalación
Ve a Modules > Module Manager, abre el menú junto a VibeFox GLS ParcelShop y elige Uninstall. La clave de licencia y el estado de la licencia siempre se eliminan.Si Remove data on uninstall está activado, el transportista se elimina (los pedidos conservan su historial), y se eliminan los ajustes, el registro y los ParcelShop de los carritos sin pedido. Si está desactivado, el transportista solo se desactiva y se conservan todos los ajustes. Al volver a instalar el módulo, el transportista guardado recupera su estado anterior. El ParcelShop guardado en los pedidos siempre se conserva.
GLS es una marca comercial de su respectivo propietario. Este módulo no está afiliado a GLS ni cuenta con su aprobación.