VibeFox Mondial Relay for PrestaShop — Ayuda
Requisitos
PrestaShop: 8.0 a 9.x. El proceso de compra funciona con los temas Classic y Hummingbird.
PHP: 8.0 o posterior. El módulo no se instala en versiones anteriores de PHP.
Cuenta de Mondial Relay: el código de marca (Enseigne) y la Private Key se obtienen con una cuenta de empresa de Mondial Relay: consulta la sección para profesionales de mondialrelay.fr, tu área de cliente "Connect" o tu contacto comercial. El selector de mapa solo necesita el código de marca. La lista de los puntos más cercanos necesita ambos. Para las pruebas, Mondial Relay proporciona el código de marca BDTEST13 con la Private Key PrivateK.
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 Mondial Relay 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. Introduce tu código de marca (Enseigne) y, para el modo de lista, la Private Key. Rellena Country prices y haz clic en Save.
Al instalarse, el módulo crea el transportista Mondial Relay Point Relais con el texto del plazo de entrega Delivery to a Mondial Relay Point Relais of your choice. El transportista se asigna a todos los grupos de clientes y a las zonas de Francia, Bélgica, Luxemburgo, España, Portugal y los Países Bajos. Puedes cambiar las zonas, 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 procede del módulo.
Configuración
Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox Mondial Relay > Configure. Cada sección tiene su propio botón Save, que guarda toda la página. Cada guardado también borra las listas de puntos de recogida en caché.
Las advertencias en la parte superior de la página muestran los problemas que ocultan el transportista: falta el código de marca, falta la Private Key en modo lista, no hay precio para Francia, Bélgica o España, o el transportista se ha eliminado. Los valores que no se pueden guardar se indican después de Save: un campo numérico con un valor que no es un número (o es negativo) conserva su valor anterior. Un nombre de más de 64 caracteres o un Min weight (kg) mayor que Max weight (kg) se rechaza, y no se guarda nada. Si la unidad de peso de la tienda no es una que el módulo conoce, una advertencia indica que los pesos de los productos se toman como kg.
General
Enable/Disable: activa o desactiva Mondial Relay. Es el mismo interruptor que el estado del transportista en Shipping > Carriers.
Name: el nombre del transportista que ve el cliente en la compra. Por defecto: Mondial Relay Point Relais. Obligatorio, hasta 64 caracteres.
Tax status: None significa que los precios de la tabla son finales. La opción Taxable con el nombre de una regla de impuesto significa que PrestaShop añade el impuesto de envío de esa regla sobre los precios.
Mondial Relay account
Brand code (Enseigne): obligatorio, hasta 8 letras y dígitos, por ejemplo BDTEST13 para las pruebas. Lo usan el mapa de puntos de recogida y el Web Service. Sin él, los clientes no pueden elegir un Point Relais y el transportista no se muestra en la compra.
Private Key: solo es necesaria para el selector List of nearest points. Después de guardar, el campo queda vacío y muestra Saved - leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarla. Para borrar la clave guardada, marca Remove the saved Private Key y haz clic en Save. Cuando el código de marca y la Private Key están configurados, la conexión con el Web Service de Mondial Relay se prueba cada vez que guardas los ajustes, y un mensaje indica si son válidos.
Pickup point selector
Selector: cómo elige el cliente un Point Relais.
Tarifas (en la moneda predeterminada de tu tienda, sin impuestos)
Country prices: precio por país de destino y peso del paquete. Haz clic en + Add country para añadir una fila y en el icono de la papelera para quitar una. Elige * Default como país para todos los demás países. Cada fila tiene una columna Price y columnas de peso: XS hasta 1 kg, S 1-2 kg, M 2-3 kg, L 3-5 kg y XL por más de 5 kg. Una columna de peso vacía o con 0 usa la columna Price. Si Price también está vacía, el envío para ese peso es gratuito, así que rellena Price cuando uses solo algunas columnas de peso. Decimales con punto o con coma (4.90 o 4,90). Las filas sin ningún precio se eliminan al guardar, y los valores que no son números se notifican y quedan vacíos.
Fallback cost: se usa para los países sin fila en la tabla. Déjalo vacío para ocultar el transportista en ellos.
Calculation type: cómo se calcula el precio.
Free shipping from: el subtotal del carrito (después de descuentos, sin impuestos) a partir del cual el envío es gratuito. Déjalo vacío si no quieres envío gratuito.
Disponibilidad
Min weight (kg): oculta el transportista cuando el carrito pesa menos. 0 significa sin límite.
Max weight (kg): oculta el transportista cuando el carrito pesa más. Mondial Relay acepta paquetes de hasta 30 kg en los Points Relais. Por defecto: 30. 0 significa sin límite. Un campo vacío equivale a 30 kg. No puede ser menor que Min weight (kg).
Minimum subtotal: muestra el transportista solo cuando el subtotal del carrito (productos que requieren envío, después de descuentos, sin impuestos) es al menos este importe. Déjalo vacío para mostrarlo siempre.
Ignore shipping zones: ofrece el transportista para los países indicados abajo, o para todos los países admitidos si la lista está vacía, incluso donde las zonas del transportista no los incluyen. Mientras está activado, el transportista se vincula a todas las zonas activas, incluidas las que crees más adelante. Al desactivarlo, el transportista recupera las zonas que tenía antes.
Countries (ignore zones): los países de destino para ese modo. Este campo solo se usa cuando Ignore shipping zones está activado. La lista solo incluye los países con Points Relais.
Avanzado
Debug log: escribe los cálculos de tarifas y las llamadas al Web Service en logs/vfd_mrel_debug.log.php, dentro de la carpeta del módulo. El archivo no se puede abrir desde la web. Los errores siempre se registran, incluso con esta opción desactivada. Las claves y los datos de los clientes nunca se registran.
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 y el transportista. Si está desactivado, al desinstalar solo se desactiva el transportista. Los puntos de recogida guardados en los pedidos se conservan.
Cómo funciona en la compra
El transportista se ofrece solo en los países con Points Relais: Francia, Bélgica, Luxemburgo, España, Portugal y los Países Bajos. Se oculta cuando el cliente no podría elegir un punto: sin código de marca, o en modo lista sin la Private Key.
En el paso de envío, PrestaShop pide al módulo el precio. Solo cuentan los productos físicos: los productos virtuales no añaden peso ni se incluyen en el subtotal. El módulo comprueba el peso del carrito y el subtotal mínimo. El precio sale de la fila del país (o de la fila *): la columna de peso y, si no hay valor, Price. Sin fila, se usa el coste alternativo. Si no hay precio, el transportista se oculta. Si el subtotal alcanza Free shipping from, el precio pasa a ser 0. El precio se calcula en la moneda predeterminada de tu tienda y después se muestra en la moneda del carrito del cliente.
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 automáticamente la nueva versión.
El módulo no solicita tarifas en tiempo real: Mondial Relay no tiene una API pública de tarifas. No crea envíos, no imprime etiquetas ni hace seguimiento de paquetes. Crea los envíos en tu espacio "Connect" de Mondial Relay usando el número de Point Relais que aparece en el pedido. La entrega a domicilio (Domicile) no se ofrece.
Puntos de recogida
Cuando el cliente selecciona el transportista Mondial Relay en el paso de entrega, aparece un cuadro Mondial Relay pickup point debajo de él.
Modo mapa: el botón Choose a Point Relais abre en una ventana el mapa oficial de Mondial Relay para el país de entrega, el código postal y el peso del paquete. Cuando el cliente elige un punto, se muestra como Selected: y el botón cambia a Change Point Relais. El widget del mapa se carga desde widget.mondialrelay.com y su biblioteca de mapas desde unpkg.com solo cuando el cliente abre el mapa. Menciónalo en tu política de privacidad.
Modo lista: un desplegable - Choose a Point Relais - muestra los 10 puntos más cercanos al código postal de entrega, con su distancia. El punto elegido se muestra con su horario de apertura. La lista la carga tu servidor, así que ningún script de terceros se ejecuta en el navegador. Las listas se guardan en caché durante 12 horas, una respuesta vacía durante 1 hora, y una petición fallida se recuerda durante 5 minutos. El tiempo de espera del Web Service es de 10 segundos. Sin código postal, el cliente ve Enter your postcode to see the nearest pickup points. Si no se encuentra ningún punto o la lista no está disponible, el cliente ve un mensaje como "La lista de puntos de recogida no está disponible en este momento. Usa el mapa." y se le ofrece el mapa.
El punto elegido se guarda en el carrito de inmediato. El punto es obligatorio. Sin punto, el cliente ve Please choose a Mondial Relay pickup point. y no puede continuar al pago. Un punto de un país distinto al de la dirección de entrega se rechaza. En modo lista, el punto también se comprueba con la lista para la dirección.
Cuando se realiza el pedido, el punto queda asociado a él. La página del pedido en el back office muestra el bloque Mondial Relay pickup point con el nombre del punto, la dirección y el Point Relais number (por ejemplo FR-066974). El cliente ve el punto en la página de confirmación del pedido y en los detalles del pedido de su cuenta. En el correo de confirmación del pedido y en el correo de nuevo pedido del módulo Alertas por correo, el punto se añade después del nombre del transportista.
Clave de licencia
El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Mondial Relay es el primer bloque de Modules > Module Manager > VibeFox Mondial Relay > 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-mondialrelay y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los empleados con el permiso Configure para el 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 es aceptada, 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. Eliminar 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 Mondial Relay no se muestra a los clientes en la 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 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 elimina siempre la clave de licencia y el estado de la licencia.
Solución de problemas
Mondial Relay no aparece en la 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 su grupo, o activa Ignore shipping zones. Revisa las advertencias en la parte superior de la página del módulo: el transportista se oculta sin código de marca, en modo lista sin la Private Key, para un país sin precio, fuera de los límites de peso y de subtotal, y para países sin Points Relais. Los productos también pueden estar limitados a ciertos transportistas en la página del producto.
La prueba del Web Service falló después de guardar: el mensaje muestra el error de Mondial Relay, por ejemplo un código de marca o una clave de seguridad no válidos. Comprueba el código de marca y la Private Key con Mondial Relay.
La lista de puntos está vacía o no está disponible: el cliente necesita primero un código postal de entrega. Si el Web Service falla, se ofrece el mapa en su lugar. Activa Debug log, vuelve a cargar la compra y consulta el campo Log de la página del módulo para ver el motivo.
El mapa no se abre: el mapa se carga desde widget.mondialrelay.com y unpkg.com. Comprueba que un bloqueador de privacidad o de scripts no los bloquee. Si el mapa no se puede cargar, el cliente ve "No se ha podido cargar el mapa de Mondial Relay. Vuelve a intentarlo más tarde o elige otro método de envío."
La página del pedido indica No Point Relais was saved for this order: el pedido se realizó sin un punto del país de entrega. El motivo se escribe en el registro. Pide al cliente el Point Relais antes de crear el envío.
La página indica que no se encontró el transportista de Mondial Relay: 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 Mondial Relay y elige Uninstall. La clave de licencia y el estado de la licencia siempre se eliminan. Las listas de puntos de recogida en caché 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 puntos 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 se restaura el estado que tenía el transportista. Los puntos de recogida guardados en los pedidos siempre se conservan.
Mondial Relay es una marca registrada de su respectivo titular. Este módulo no está afiliado ni cuenta con el respaldo de Mondial Relay.