VibeFox Mondial Relay for OpenCart — Ayuda
Requisitos
OpenCart: 3.0.x (probado en 3.0.5.0) o 4.0.2 y posteriores (probado en 4.1.0.3), con el tema predeterminado.
PHP: 8.0 o posterior.
Cuenta de Mondial Relay: el código de marca (Enseigne) y la clave privada se obtienen con una cuenta de empresa de Mondial Relay: consulta la sección de 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 pruebas, Mondial Relay proporciona el código de marca BDTEST13 con la clave privada PrivateK.
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 de ambas versiones de OpenCart. Descomprímelo en tu ordenador. Contiene README.txt, el paquete de OpenCart 3 vfd_mondialrelay-oc3-(version).ocmod.zip y el paquete de OpenCart 4 vfd_mondialrelay.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 panel de administración, ve a Extensions > Installer, haz clic en Upload y elige el archivo vfd_mondialrelay-oc3-(version).ocmod.zip. La extensión no añade modificaciones OCMOD, así que no necesitas actualizar Extensions > Modifications. En lugar del Installer, 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 Mondial Relay 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 configuración.
4. Introduce tu clave de licencia de VibeFox en License key en el bloque de licencia de la parte superior de la página Edit y haz clic en Activate (ver Clave de licencia).
5. Introduce tu código de marca (Enseigne) y, para el modo de lista, la clave privada. Rellena Country prices (por ejemplo, una fila para Francia) o un Fallback cost, activa Enable/Disable y haz clic en Save.
OpenCart 4
1. En el panel de administración, ve a Extensions > Installer, haz clic en Upload y elige el archivo vfd_mondialrelay.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 Mondial Relay, 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 iguales en ambas versiones.
Después de instalar, el método está desactivado hasta que actives Enable/Disable y guardes. Si vuelves a instalar la extensión tras 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 Mondial Relay > Edit. Las secciones aparecen a la izquierda. Un único botón Save guarda toda la página sin recargarla. Cada guardado también borra las listas de puntos de recogida en caché. Solo los usuarios administradores con permiso de modificación para esta extensión pueden guardar los ajustes.
Las advertencias en la parte superior de la página muestran problemas que ocultan el método: falta el código de marca, falta la clave privada en el modo de lista, no hay precio para Francia, Bélgica o España, y una unidad de peso de la tienda que la extensión no reconoce (los pesos de los productos se toman entonces como kg). Si Name está vacío, tiene más de 64 caracteres o contiene alguno de los caracteres < > ; = # { }, si Min weight (kg) es mayor que Max weight (kg), o si el código de marca no es válido, la página muestra un error y no se guarda nada. Un campo numérico con un valor que no es un número (o es negativo) se notifica tras Save y conserva su valor anterior; los demás ajustes se guardan.
General
Entrega en Point Relais de Mondial Relay para Francia, Bélgica, Luxemburgo, España, Portugal y los Países Bajos. El método se ofrece en su zona geográfica (ver Availability) o, con Ignore shipping zones, en los países indicados.
Enable/Disable: muestra u oculta Mondial Relay en la finalización de compra. Predeterminado: desactivado.
Name: el nombre del método de envío que ven los clientes en el carrito y en la finalización de compra. Predeterminado: Mondial Relay Point Relais. Obligatorio, hasta 64 caracteres.
Tax status: None (predeterminado) significa que los precios de la tabla son finales. La opción Taxable con el nombre de una clase de impuesto significa que OpenCart añade encima de los precios el impuesto de envío de esa clase.
Sort order: la posición de Mondial Relay entre los métodos de envío en la finalización de compra. Un número entero.
Cuenta de Mondial Relay
Brand code (Enseigne): obligatorio, hasta 8 letras y cifras, por ejemplo BDTEST13 para pruebas. Lo usan el mapa de puntos de recogida y el Web Service. Sin él, los clientes no pueden elegir un Point Relais, así que el método no se muestra en la finalización de compra.
Private Key: solo es necesaria para el selector List of nearest points. Tras guardar, el campo queda vacío y muestra Saved - leave empty to keep it. Escribe un valor nuevo solo para cambiarla. Para eliminar la clave guardada, marca Remove the saved Private Key y haz clic en Save. Cuando el código de marca y la clave privada 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.
Selector de punto de recogida
El cliente debe elegir un Point Relais antes de continuar al paso de pago. El punto se guarda en el pedido.
Selector: cómo elige el cliente un Point Relais.
Tarifas (en la moneda predeterminada de tu tienda, sin impuestos)
Mondial Relay no tiene una API pública de tarifas: el precio sale de esta tabla.
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 botón de eliminar para borrar una. Elige * Default como país para todos los demás países. Cada fila tiene un Price y 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. Una columna de peso vacía o con 0 usa la columna Price. Si Price también está vacío, la entrega para ese peso es gratuita, así que rellena Price cuando uses solo algunas columnas de peso. Decimales con punto o coma (4.90 o 4,90). Las filas sin ningún precio y las filas con un país desconocido 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 método 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 la entrega es gratuita. Déjalo vacío para no tener envío gratuito.
Disponibilidad
Min weight (kg): oculta el método cuando el carrito pesa menos. 0 significa sin límite (predeterminado).
Max weight (kg): oculta el método cuando el carrito pesa más. Mondial Relay acepta paquetes de hasta 30 kg en Points Relais. Predeterminado: 30. 0 significa sin límite. Un campo vacío significa 30 kg.
Minimum subtotal: muestra el método solo cuando el subtotal del carrito (productos que necesitan envío, después de descuentos, sin impuestos) es al menos esta cantidad. Déjalo vacío para mostrarlo siempre.
Geo zone: ofrece el método solo para direcciones en esta zona geográfica. All zones (predeterminado) significa en todas partes. Las zonas geográficas se gestionan en System > Localisation > Geo Zones. No se comprueba cuando Ignore shipping zones está activado.
Ignore shipping zones: cuando está activado, no se comprueba la Geo zone: el método se ofrece solo en los países indicados abajo, o en todos los países compatibles si la lista está vacía.
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 tiene los países con Points Relais.
Avanzado
Debug log: escribe los cálculos de tarifas, las llamadas al Web Service y las elecciones de punto en storage/logs/vfd_mrel_debug.log.php (en OpenCart 4, system/storage/logs/vfd_mrel_debug.log.php). El archivo no se puede leer 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. Cuando el archivo llega a 5 MB, se traslada a vfd_mrel_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: si está activado, al desinstalar la extensión se borran los ajustes y el registro. Si está desactivado (predeterminado), se conservan para una nueva instalación. Las listas de puntos en caché siempre se eliminan. Los puntos de recogida guardados en los pedidos se conservan.
Importar / Exportar
Export: haz clic en Download JSON para guardar los ajustes como archivo JSON, sin la clave privada.
Import: pega un JSON exportado previamente y haz clic en Import para restaurar los ajustes, por ejemplo en otra tienda. Se aplican las mismas comprobaciones que en Save. La clave privada guardada se conserva.
Cómo funciona en la finalización de compra
El método solo se ofrece para países con Points Relais: Francia, Bélgica, Luxemburgo, España, Portugal y los Países Bajos. Se oculta cuando los clientes no podrían elegir un punto: sin código de marca, o en modo de lista sin la clave privada. Si hay una Geo zone definida y la dirección está fuera de ella, el método no se ofrece. Con Ignore shipping zones activado, no se comprueba la zona geográfica y solo se atienden los países de esa lista (todos los países compatibles si está vacía).
Cuando OpenCart muestra los métodos de envío, pide a la extensión el precio. Solo cuentan los productos con Requires Shipping en Yes: los demás productos no añaden peso y no se incluyen en el subtotal. Los pesos de los productos se convierten de su clase de peso de OpenCart a kg. El subtotal es el precio de los productos que requieren envío, después del descuento del cupón y antes de impuestos. La extensión comprueba el peso del carrito y el subtotal mínimo. El precio sale de la fila del país (o la fila *): la columna de peso y, si no, Price. Sin fila se usa el coste alternativo. Si no hay precio, el método 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, se redondea a sus decimales y se muestra en la moneda del cliente con el impuesto del Tax status seleccionado. No se envía ninguna solicitud a Mondial Relay para calcular el precio.
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 Mondial Relay en la ventana Shipping method options. Los precios son los mismos que en OpenCart 3.
La extensión 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 la opción de Mondial Relay en el paso del método de envío, aparece debajo un cuadro Mondial Relay pickup point.
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. La lista la carga tu servidor, así que para ella no se ejecuta ningún script de terceros en el navegador. Las listas se guardan en caché durante 12 horas, una respuesta vacía durante 1 hora, y una solicitud 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 de inmediato en la sesión del cliente. El punto es obligatorio. Cuando el cliente hace clic en Continue, la tienda vuelve a comprobar el punto. 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 con un mensaje que indica que el punto no está en el país de entrega. En modo lista, el punto también se comprueba frente a la lista de la dirección. Una vez realizado el pedido, la elección se borra, así que el siguiente carrito vuelve a elegir.
En OpenCart 4 el cuadro Mondial Relay pickup point aparece en la ventana Shipping method options, debajo de la opción de Mondial Relay, y el mapa se abre dentro de esa ventana. La tecla Escape cierra solo el mapa. El botón Continue de la ventana no continúa sin un punto válido, con los mismos mensajes.
Cuando se realiza el pedido, el punto queda asociado al pedido. El método de envío del pedido muestra el nombre del método seguido del nombre, la dirección y el número del punto, por ejemplo Mondial Relay Point Relais: TABAC DU LOUVRE, 12 RUE DE RIVOLI, 75001 PARIS (FR-066974), para que el cliente lo vea en el correo del pedido y en el historial de pedidos de su cuenta. El correo del nuevo pedido para la tienda muestra el punto con su número en el bloque de comentarios. En Sales > Orders, la página del pedido muestra un panel Mondial Relay pickup point con el nombre del punto, la dirección y el número de Point Relais, o No Point Relais was saved for this order. En OpenCart 4 el panel se muestra encima de History. OpenCart 4 mantiene un único pedido para la finalización de compra y lo actualiza cada vez que el cliente vuelve a confirmar, y el punto del pedido se actualiza con él. Si el cliente cambia ese pedido a otro método de envío, su punto se elimina.
Clave de licencia
La extensión funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Mondial Relay es el primer bloque de Extensions > Extensions > Shipping > VibeFox Mondial Relay > Edit, por 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: opencart-shipping-mondialrelay y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los usuarios administradores con 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 no se acepta la clave, 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. Tras cambiar la dirección de la tienda, o tras liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si el servidor de licencias no responde, 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. Libérala en tu cuenta de vibefox.net.
Sin una clave activa, el método de envío de Mondial Relay 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 administrador 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 a todos. Tras abrir una vez 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 tras introducir la clave, y después una vez por semana. No hace falta ninguna tarea cron. Desinstalar la extensión elimina siempre la clave de licencia y el estado de la licencia.
Solución de problemas
Mondial Relay 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 su lista de países. Revisa las advertencias de la parte superior de la página de la extensión: el método se oculta sin código de marca, en modo lista sin la clave privada, para un país sin precio, fuera de los límites de peso y de subtotal, y para países sin Points Relais. Comprueba que los productos tengan Requires Shipping en Yes.
La prueba del Web Service falló tras guardar: el mensaje muestra el error de Mondial Relay, por ejemplo un código de marca no válido o una clave de seguridad no válida. Comprueba el código de marca y la clave privada con Mondial Relay.
La lista de puntos está vacía o no está disponible: el cliente necesita antes un código postal de entrega. Si el Web Service falla, se ofrece el mapa. Activa Debug log, recarga la finalización de compra y mira el campo Log de la página de la extensión 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, o una Content Security Policy de tu tienda, no los bloquee. Si el mapa no puede cargarse, el cliente ve "No se pudo cargar el mapa de Mondial Relay. Inténtalo de nuevo más tarde o elige otro método de envío."
La página del pedido dice 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 dice "Warning: You do not have permission to modify VibeFox Mondial Relay!": es posible que el grupo de usuarios administradores solo pueda ver los ajustes. Da al grupo el permiso de modificación para extension/shipping/vfd_mondialrelay (OpenCart 3) o extension/vfd_mondialrelay/shipping/vfd_mondialrelay (OpenCart 4) en System > Users > User Groups.
Desinstalación
Ve a Extensions > Extensions, elige el tipo Shipping y haz clic en Uninstall (el botón rojo −) junto a VibeFox Mondial Relay. 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. Las listas de puntos en caché siempre se eliminan. 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 vuelven a usar cuando vuelvas a instalar la extensión. Los puntos de recogida guardados en los pedidos siempre se conservan, 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 tras la desinstalación y haz clic en Uninstall (el botón naranja −) junto a VibeFox Mondial Relay en la lista de extensiones instaladas y, después, en Delete (el botón rojo con forma de papelera) para eliminar el paquete subido.
Mondial Relay es una marca comercial de su respectivo propietario. Esta extensión no está afiliada ni respaldada por Mondial Relay.