VibeFox GLS ParcelShop for OpenCart — Ayuda
Requisitos
OpenCart: 3.0.x (probado con la versión 3.0.5.0) o 4.0.2 y posteriores (probado con la versión 4.1.0.3), con el tema predeterminado y su finalización de compra en una sola página.
PHP: 8.0 o posterior.
GLS: la extensión no usa ni necesita una cuenta de GLS ni una clave de API. El mapa de ParcelShop es público. Necesitas un contrato con GLS para enviar los paquetes a los ParcelShop elegidos.
Política de seguridad de contenido: si tu tienda envía una política de seguridad de contenido, permite map.gls-croatia.com, desde donde se carga el script del mapa de GLS.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo dominio.
Instalación
La descarga es un único archivo zip con los paquetes para ambas versiones de OpenCart. Descomprímelo en tu ordenador. Contiene README.txt, el paquete de OpenCart 3 vfd_gls_parcelshop-oc3-(version).ocmod.zip y el paquete de OpenCart 4 vfd_gls_parcelshop.ocmod.zip. Instala solo el paquete de tu versión de OpenCart. La clave de licencia es la misma para ambas versiones.
OpenCart 3
1. En el área de administración ve a Extensions > Installer, haz clic en Upload y elige el archivo vfd_gls_parcelshop-oc3-(version).ocmod.zip. La extensión no añade modificaciones OCMOD, así que no necesitas actualizar Extensions > Modifications. En lugar del instalador, también puedes copiar el contenido de la carpeta upload de este paquete en la carpeta raíz de tu tienda.
2. Ve a Extensions > Extensions y elige el tipo de extensión Shipping. Busca VibeFox GLS ParcelShop y haz clic en Install (el botón verde +).
3. Haz clic en Edit (el botón del lápiz) para abrir la página de ajustes.
4. Introduce tu clave de licencia de VibeFox en License key del bloque de licencia de la parte superior de la página Edit y haz clic en Activate (consulta License key).
5. Define tus precios: al menos una fila de Country prices (por ejemplo * Default) o un Fallback cost (consulta Configuración). Activa Enable/Disable y haz clic en Save.
OpenCart 4
1. En el área de administración ve a Extensions > Installer, haz clic en Upload y elige el archivo vfd_gls_parcelshop.ocmod.zip. No cambies el nombre del archivo: OpenCart 4 toma el código de la extensión del nombre del archivo, y un paquete renombrado no funciona.
2. El paquete aparece en la lista de extensiones instaladas en la misma página. Haz clic en Install (el botón verde +) junto a él.
3. Ve a Extensions > Extensions y elige el tipo de extensión Shipping. Busca VibeFox GLS ParcelShop, haz clic en Install (el botón verde +) y, después, en Edit (el botón del lápiz).
4. Introduce la clave de licencia y los ajustes como en los pasos 4 y 5 de OpenCart 3. La página de ajustes y sus campos son los mismos en ambas versiones.
Tras la instalación, el método está desactivado hasta que actives Enable/Disable y guardes. Si vuelves a instalar la extensión después de desinstalarla, se usan de nuevo los ajustes que conservaste.
Configuración
Todos los ajustes están en la página de la extensión: Extensions > Extensions > Shipping > VibeFox GLS ParcelShop > Edit. Las secciones aparecen en la parte izquierda. Un botón Save en la parte inferior guarda toda la página sin recargarla. Solo los usuarios administradores con el permiso de modificación para esta extensión pueden guardar los ajustes.
Las advertencias en la parte superior de la página, y de nuevo tras cada guardado, señalan problemas de configuración: no hay ningún precio definido, algunos o todos los Countries (ignore zones mode) seleccionados no están cubiertos por el mapa de GLS, o la unidad de peso de la tienda no es reconocida por la extensión y no hay una clase de peso con la unidad kg (añade una en System > Localisation > Weight Classes). Un número no válido o negativo se rechaza con un mensaje que indica el campo, por ejemplo Fallback cost: "abc" is not a valid number of 0 or more - the previous value was kept. Los demás campos sí se guardan. Un Name, un orden de clasificación, una clase de impuesto o una zona geográfica no válidos se rechazan de la misma manera.
General
La sección muestra los países cubiertos por el mapa de GLS: Austria, Bélgica, Bulgaria, Croacia, la República Checa, Dinamarca, Finlandia, Francia, Alemania, Grecia, Hungría, Italia, Luxemburgo, los Países Bajos, Polonia, Portugal, Rumanía, Serbia, Eslovaquia, Eslovenia y España. El método no se ofrece para otros países de destino.
Enable/Disable: muestra u oculta GLS ParcelShop en la finalización de compra. Por defecto: desactivado.
Name: el nombre del método de envío que ve el cliente. Por defecto: GLS ParcelShop. Obligatorio, como máximo 64 caracteres, sin los caracteres < > ; = # { }.
Tax status: None (shipping is not taxed), o la clase de impuesto que se aplica cuando el envío tiene impuestos.
Sort order: la posición entre los métodos de envío en la finalización de compra. Un número entero.
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 cliente ve el precio en su moneda.
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. Cada fila tiene un Country, un Price y cinco columnas de peso: XS hasta 1 kg, S de 1 a 2 kg, M de 2 a 3 kg, L de 3 a 5 kg y XL más de 5 kg. Se usa la columna del peso del carrito. Una columna de peso que se deja en 0 usa la columna Price. La fila * Default se usa para los países sin fila propia. Una fila con todos los precios en 0 da envío gratuito, 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 de 0 o más, no se guarda la tabla completa y el mensaje indica los valores incorrectos.
Fallback cost: el precio que se usa cuando la tabla no tiene una fila para el país de destino ni una fila * Default. Déjalo vacío para ocultar el método en esos países.
Free shipping from: el subtotal del carrito (después de los descuentos, sin impuestos) a partir del cual el envío con GLS ParcelShop es gratuito. Déjalo vacío si el envío nunca es gratuito.
Availability
Minimum weight (kg): oculta el método cuando el carrito pesa menos. El peso se convierte a partir de las clases de peso de los productos. Vacío o 0 significa sin límite.
Maximum weight (kg): oculta el método cuando el carrito pesa más. Por defecto: 20. Los ParcelShop de GLS suelen aceptar paquetes de hasta 20 kg, así que revísalo en 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 método solo cuando el subtotal del carrito (después de los descuentos, sin impuestos) alcanza este importe. Déjalo vacío si no hay mínimo.
Geo zone: ofrece el método solo para direcciones de esta zona geográfica. All zones significa sin límite. No se usa cuando Ignore shipping zones está activado. Las zonas geográficas se gestionan en System > Localisation > Geo Zones.
Ignore shipping zones: cuando está activado, el método se ofrece para los países seleccionados abajo (todos los países del mapa de GLS si la lista está vacía), sea cual sea la zona geográfica. Cuando está desactivado, solo se ofrece en la zona geográfica indicada arriba. 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 cubre 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 storage/logs/vfd_glps_debug.log.php (en OpenCart 4, system/storage/logs/vfd_glps_debug.log.php). El archivo no se puede leer desde la web. Los errores siempre se registran. No se registran datos personales de los clientes. Desactiva el registro cuando termines. Cuando el archivo llega a 5 MB, se mueve a vfd_glps_debug.old.log.php y se inicia un registro nuevo.
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 la extensión se borran los ajustes y el registro. Cuando está desactivado, todo se conserva para una nueva instalación. El ParcelShop guardado en los pedidos siempre se conserva.
Import / Export
Export: haz clic en Download JSON para guardar los ajustes como un archivo JSON.
Import: pega un JSON exportado previamente y haz clic en Import para restaurar los ajustes, por ejemplo en otra tienda. Los valores no válidos se notifican y no se importan.
Cómo funciona en la finalización de compra
Cuando OpenCart muestra los métodos de envío, pide a la extensión el precio de GLS ParcelShop. Si se ha definido una Geo zone (y Ignore shipping zones está desactivado) y la dirección está fuera de ella, el método no se ofrece. Solo cuentan los productos con Requires Shipping en Yes: los demás productos no suman peso ni se incluyen en el subtotal del carrito. El subtotal es el precio de estos productos después del descuento del cupón, sin impuestos. A continuación, la extensión comprueba las condiciones: país de entrega cubierto por el mapa de GLS (y seleccionado en Countries (ignore zones mode) cuando ese modo está activado), peso del carrito y subtotal mínimo del carrito. Si el subtotal del carrito alcanza Free shipping from, el envío es gratuito. En caso contrario, 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 método se oculta. El precio se redondea a los decimales de tu moneda predeterminada y se muestra con el impuesto de la Tax status seleccionada.
Cuando el cliente selecciona GLS ParcelShop, aparece un recuadro GLS ParcelShop con un botón Select GLS ParcelShop debajo del método. Abre el mapa oficial de GLS ParcelShop para el país de entrega. Un ParcelShop de otro país se rechaza de inmediato. Una vez elegido el ParcelShop, se muestran su nombre y su dirección, y el botón cambia a Change ParcelShop. La elección se guarda en la sesión del cliente, así que se mantiene al recargar el paso de envío. Si la dirección de entrega cambia a otro país, el cliente debe elegir de nuevo un ParcelShop.
Cuando el cliente hace clic en Continue en el paso del método de entrega, la extensión 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 ese paso. Si el ParcelShop no se puede guardar, el cliente ve The ParcelShop could not be saved. Please try again. Si el script del mapa de GLS no se puede cargar, el cliente ve The GLS ParcelShop map could not be loaded. Please reload the page or choose another shipping method.
En OpenCart 4, el cliente hace clic en Choose en el bloque del método de envío de la página de finalización de compra y elige GLS ParcelShop en la ventana Shipping method options. El recuadro GLS ParcelShop con el botón Select GLS ParcelShop aparece en esa ventana debajo del método, y el mapa de GLS se abre sobre la ventana. El botón Continue de la ventana no avanza sin un ParcelShop válido, con los mismos mensajes. OpenCart 4 mantiene un solo pedido para la finalización de compra y lo actualiza cada vez que el cliente vuelve a confirmar, y el ParcelShop del pedido se actualiza con él.
El mapa de GLS se ejecuta en el navegador del cliente. En la página de finalización de compra, la extensión carga el script del mapa de GLS desde map.gls-croatia.com, y el mapa carga desde GLS los datos de los ParcelShop y las teselas del mapa. GLS recibe los datos habituales de la solicitud del visitante (dirección IP, navegador). Tu servidor no envía nada a GLS. Un error de la extensión nunca interrumpe la finalización de compra de otros métodos de envío; se escribe en el registro.
La extensión no obtiene tarifas de GLS en tiempo real, no crea envíos de GLS, no imprime etiquetas ni hace el seguimiento de paquetes. No tiene en tu servidor una lista de ParcelShop, por lo que no puede verificar el ID del ParcelShop frente a GLS. Entrega el ID del ParcelShop del pedido a GLS de la forma habitual (MyGLS, tu software de GLS u otra extensión).
Puntos de recogida
Al realizarse el pedido, el ParcelShop elegido en la finalización de compra se guarda con el pedido: su ID, su nombre con la dirección y su país. Una vez completado el pedido, la elección se borra, de modo que el siguiente carrito empieza sin ParcelShop.
Shipping method name: el ParcelShop se añade al nombre del método de envío del pedido, por ejemplo GLS ParcelShop: name, address (el nombre del método y luego el ParcelShop) (OpenCart 3 guarda como máximo 128 caracteres de él; OpenCart 4, como máximo 255). Así, el ParcelShop aparece en el correo de confirmación del pedido enviado al cliente, en la página del pedido dentro de su Order History y en Sales > Orders. OpenCart no muestra el método de envío en la página de pedido completado.
Admin order page: en Sales > Orders, un panel de 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 panel muestra No ParcelShop was selected for this order. El panel solo muestra el ParcelShop; allí no se puede cambiar.
Correo electrónico al comerciante: el correo de aviso de nuevo pedido a la tienda incluye el ParcelShop con su ParcelShop ID en el bloque de comentarios.
Clave de licencia
La extensión funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox GLS ParcelShop es el primer bloque de Extensions > Extensions > Shipping > VibeFox GLS ParcelShop > Edit, encima de los ajustes. Pega la clave en License key y haz clic en Activate. Después, el bloque muestra la clave oculta, 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 quitar la clave de esta tienda. Debajo están la línea Product: opencart-shipping-gls-parcelshop y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los usuarios administradores con el permiso de modificación para la extensión pueden cambiar la clave. Los textos del bloque siguen el idioma del administrador (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 que cambie 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 acceder al servidor de licencias, la extensión sigue funcionando con el último estado conocido.
Una clave funciona en un solo dominio: la dirección de la tienda de la configuración de OpenCart. 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 método de envío GLS ParcelShop no se muestra a los clientes en la finalización de compra y no se calcula ninguna tarifa. Un usuario administrador que haya iniciado sesión en el área de administración en el mismo navegador sigue viendo el método en la tienda, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar la extensión antes de comprar una clave. En OpenCart 4 esta vista previa no está disponible: la tienda no ve el inicio de sesión del administrador, así que sin una clave activa el método se oculta para todos. Una vez que hayas abierto la página Edit, aparece un recordatorio en el Dashboard del administrador. Ciérralo con × para ocultarlo durante 7 días. Los pedidos existentes no se ven afectados.
Cuando una licencia caduca, la extensión sigue funcionando, pero las actualizaciones y el soporte necesitan una renovación. El estado se vuelve a comprobar automáticamente cuando abres el Dashboard del administrador o la página Edit: 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 ningún cron job. Al desinstalar la extensión siempre se eliminan 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. Revisa Geo zone, o Ignore shipping zones y 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 Minimum cart subtotal, y que los productos tengan Requires Shipping en Yes. Activa Debug log y mira 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.
El recuadro del ParcelShop no aparece debajo del método: la extensión se probó con el tema predeterminado de OpenCart y su finalización de compra. Un tema o una extensión de finalización de compra que reemplace el paso del método de envío puede no mostrar el recuadro.
El envío es gratuito 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 gratuito.
La tabla o un campo no se guardó: un valor no es un número válido de 0 o más. El mensaje de la parte superior de la página indica el valor. Usa dígitos con coma o punto como separador decimal.
Un pedido muestra No ParcelShop was selected for this order: el pedido se realizó sin un ParcelShop del país de entrega. El motivo se escribe en el registro. Pide al cliente el ParcelShop y entrégalo a GLS manualmente.
La página indica "Warning: You do not have permission to modify VibeFox GLS ParcelShop!": tu grupo de usuarios de administración solo puede ver los ajustes. Concede al grupo el permiso de modificación para extension/shipping/vfd_gls_parcelshop (OpenCart 3) o extension/vfd_gls_parcelshop/shipping/vfd_gls_parcelshop (OpenCart 4) en System > Users > User Groups.
Para desarrolladores: la dirección del script del mapa de GLS puede cambiarse con el ajuste vfd_glps_widget_url; no tiene un campo en la página de ajustes.
Desinstalación
Ve a Extensions > Extensions, elige el tipo Shipping y haz clic en Uninstall (el botón rojo −) junto a VibeFox GLS ParcelShop. La clave de licencia y el estado de la licencia de esta extensión siempre se eliminan. OpenCart siempre restablece Enable/Disable, Sort order, Tax status y Geo zone. La extensión siempre elimina sus eventos. Si Remove data on uninstall está activado, los demás ajustes y el registro de depuración también se borran. Si está desactivado, se conservan y se usan de nuevo al volver a instalar la extensión. Un ParcelShop elegido en un carrito abierto se mantiene en la sesión del cliente hasta que caduque. El ParcelShop guardado en los pedidos siempre se conserva, y los pedidos existentes mantienen su método de envío y su coste.
En OpenCart 4, para eliminar también los archivos de la extensión, ve a Extensions > Installer después de desinstalarla y haz clic en Uninstall (el botón naranja −) junto a VibeFox GLS ParcelShop en la lista de extensiones instaladas, y después en Delete (el botón rojo de papelera) para eliminar el paquete subido.
GLS es una marca comercial de su titular. Esta extensión no está afiliada a GLS ni cuenta con su respaldo.