VibeFox Frenet for PrestaShop — Ayuda
Requisitos
PrestaShop: 8.0 a 9.x.
PHP: 8.0 o posterior. El módulo no se instala en versiones anteriores de PHP.
Cuenta de Frenet (solo para cotizaciones en tiempo real): crea una cuenta gratuita en el panel de Frenet (painel.frenet.com.br), activa los transportistas que uses y copia tu token de API. Si solo usas precios fijos, no necesitas una cuenta de Frenet.
Productos: rellena el peso y las dimensiones para obtener precios exactos. Los productos sin ellos se cotizan como 0,3 kg y 16 × 11 × 2 cm (la caja mínima de Correios).
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave sirve para un solo 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 Frenet más tarde en la lista de módulos y haz clic en Configure.
3. Pega 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 (véase Clave de licencia).
4. Pega el token de API e introduce el CEP de origen. Si tu moneda predeterminada no es el BRL, introduce el tipo de cambio del BRL. Opcionalmente, añade precios fijos y un coste alternativo. Haz clic en Save.
Al instalar, el módulo crea el transportista Frenet con el texto del plazo de entrega Delivery by the carriers of your Frenet account. El transportista se asigna a todas las zonas y a todos los grupos de clientes. 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 configures 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 Frenet > Configure. Se aplican a todas las zonas del transportista. Cada sección tiene su propio botón Save, que guarda toda la página. Cada guardado también borra las cotizaciones de Frenet en caché. Los campos de precio aceptan tanto el punto como la coma como separador decimal; un valor que no es un número se rechaza con el mensaje "…" must be a number. También se rechazan los importes y los pesos negativos, un BRL exchange rate de 0 o menos, y un Minimum weight mayor que el Maximum weight. Si hay un error, no se guarda nada.
En la parte superior de la página, el módulo muestra avisos: no hay token de API (solo se usan precios fijos, o el transportista nunca se muestra si tampoco hay precios fijos), no hay un CEP de origen de 8 dígitos, o la moneda predeterminada no es el BRL y falta el tipo de cambio. También avisa cuando la unidad de peso o de dimensiones de tu tienda no es una que el módulo reconoce; esa unidad se trata como kg o cm. Configura una unidad estándar (kg, g, lb u oz; cm, mm, m o in) en International > Localization (Local units).
General
Enable Frenet: activa o desactiva el transportista. Es el mismo interruptor que el estado del transportista en Shipping > Carriers.
Method title: el nombre del transportista que se muestra en el carrito y en la finalización de compra. Default: Frenet. Obligatorio, 64 caracteres como máximo.
Cotizaciones en tiempo real de Frenet
Frenet compara los transportistas activados en tu cuenta de Frenet y devuelve sus precios para el carrito. Las cotizaciones en tiempo real se piden solo para direcciones en Brasil con un CEP completo de 8 dígitos. La sección tiene un enlace al panel de Frenet.
API token: tu token de API de Frenet, obtenido en el panel de Frenet. Déjalo vacío para usar solo precios fijos. Después de guardar, el campo queda vacío y muestra A token is saved — leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarlo. Para borrar el token guardado, marca Remove the saved token y guarda.
CEP de origen: el código postal (CEP) desde el que se envían los paquetes, por ejemplo 00000-000. Déjalo vacío para usar el código postal de la tienda de Shop Parameters > Contact > Stores, si la dirección de la tienda está en Brasil. Un CEP sin 8 dígitos se guarda tal como se escribió, y la página muestra Frenet: the origin CEP must have 8 digits.
Service to offer: Cheapest service (predeterminado) o Fastest service. Frenet devuelve varios servicios y el transportista muestra un solo precio.
BRL exchange rate: Frenet cotiza en reales brasileños. Si la moneda predeterminada de tu tienda no es el BRL, introduce cuánto vale 1 BRL en tu moneda predeterminada, por ejemplo 0.16. Con este valor se convierten la cotización y el valor declarado del pedido. Sin él no se usan las cotizaciones en tiempo real. Cuando la moneda predeterminada es el BRL, el campo muestra Not needed (shop currency is BRL).
Precios fijos
Se usan cuando no hay token de API, para los países que Frenet no atiende y siempre que Frenet no devuelva un precio (API caída, CEP no atendido).
Price per country: una tabla con las columnas Country, Price, XS, S, M, L y XL, con precios en tu moneda predeterminada, sin impuestos. Haz clic en Add country para añadir una fila y en el icono de la papelera para quitar una. Las columnas de tamaño dependen del peso del carrito: XS hasta 1 kg, S hasta 2 kg, M hasta 3 kg, L hasta 5 kg, XL por encima de 5 kg. Se usa Price cuando la columna de tamaño está vacía. Un Price de 0 significa envío gratuito para ese país. Usa * Default para todos los demás países. Las filas sin ningún precio se eliminan al guardar.
Fallback cost: se usa cuando ni Frenet ni la tabla dan un precio. Déjalo vacío para ocultar el transportista.
Fixed price applies: Per order cobra el precio una sola vez. Per item (price × quantity) lo multiplica por el número de artículos. Esto se aplica solo a los precios fijos y al coste alternativo. Las cotizaciones de Frenet ya cubren todo el carrito.
Condiciones
Minimum weight: oculta el transportista si el peso del carrito es inferior a este valor, en kg. 0 significa sin límite.
Maximum weight: oculta el transportista si el peso del carrito supera este valor, en kg. Default: 30 (también se usa cuando el campo está vacío). 0 significa sin límite. No puede ser inferior a Minimum weight.
Minimum order amount: muestra el transportista solo cuando el subtotal del carrito (después de descuentos, antes de impuestos) sea al menos este importe. Déjalo vacío para mostrarlo siempre.
Free shipping from: subtotal del carrito (después de descuentos, antes de impuestos) a partir del cual el envío es gratuito. Déjalo vacío para no ofrecer nunca envío gratuito.
Tax: la regla de impuestos del transportista, o No tax. Los precios de Frenet son precios finales del transportista. Elige No tax si PrestaShop no debe añadirles impuestos.
Los pesos y las dimensiones de los productos se convierten de las unidades de tu tienda a kg y cm.
Disponibilidad sin zonas de envío
Normalmente el transportista se ofrece en las zonas que tiene asignadas en Shipping > Carriers.
Ignore shipping zones: ofrece Frenet para los países indicados a continuación, sea cual sea la zona que coincida. Al guardar, el transportista se añade a todas las zonas, y también a las zonas que crees más adelante. Cuando lo desactivas de nuevo, el transportista recupera las zonas que tenía antes.
Countries: los países de destino para ese modo, elegidos entre los países activos de tu tienda. Déjalo vacío para usar todos los países a los que envías. Se usa solo cuando Ignore shipping zones está activado.
Avanzado
Debug log: registra cada solicitud y respuesta de cotización en logs/vfd_frn_debug.log.php, dentro de la carpeta del módulo. El archivo no se puede abrir desde la web. Los errores de la API siempre se registran. El token nunca se registra y el CEP del cliente se acorta. Desactívalo cuando termines.
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 borran todos los ajustes de Frenet, el transportista y el registro. Si está desactivado, todo se conserva para una reinstalación. Las cotizaciones en caché siempre se eliminan. Los servicios de Frenet guardados con los pedidos forman parte del historial de pedidos y se conservan.
Funcionamiento en la finalización de compra
En el paso de envío, PrestaShop pide al módulo el precio de Frenet. Solo cuentan los productos físicos: los productos virtuales no suman peso ni se incluyen en el importe del pedido. Antes de que el cliente introduzca una dirección, el módulo usa el país que la tienda estima para el visitante. El módulo comprueba primero la lista de países (cuando Ignore shipping zones está activado), el peso del carrito y el importe mínimo del pedido. Si se aplica el envío gratuito, el precio es 0 y no se envía ninguna solicitud a Frenet.
Para una dirección en Brasil con un CEP completo de 8 dígitos, el módulo envía a Frenet los CEP de origen y de destino, cada artículo del carrito (peso en kg, dimensiones en cm, cantidad, referencia del producto y categorías), el valor del pedido en BRL y el primer código de cupón del carrito. No se hace ninguna solicitud mientras el CEP esté incompleto. Frenet devuelve los servicios de tus transportistas activados. Se omiten los servicios con error o sin precio. El módulo elige el servicio más barato o el más rápido y convierte el precio a tu moneda predeterminada. Después, el precio se muestra en la moneda del carrito del cliente.
Cada respuesta se guarda en caché durante 1 hora para el mismo carrito y la misma dirección. Una solicitud fallida, o un CEP que ningún transportista activado atiende, se recuerda durante 10 minutos. El tiempo de espera de la API es de 10 segundos. En estos casos el cliente no ve ningún error: se usa el precio fijo o el coste alternativo, o el transportista se oculta si no hay ninguno. El motivo se escribe en el registro. Para direcciones fuera de Brasil solo se usan precios fijos.
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 solo calcula tarifas. No crea envíos, no imprime etiquetas ni hace seguimiento de paquetes. Muestra un servicio de Frenet por carrito, no varios, y no tiene puntos de recogida ni taquillas. Frenet cotiza solo dentro de Brasil; usa los precios fijos para otros países.
Pedidos
Cuando se realiza un pedido con el transportista Frenet, el módulo guarda cómo se calculó su precio de envío. La página del pedido en el back office muestra entonces un bloque Frenet con estas líneas:
Carrier: el transportista de Frenet y el servicio, por ejemplo un servicio de Correios o de Jadlog. Se muestra para las cotizaciones en tiempo real.
Delivery time: el plazo de entrega en días hábiles devuelto por Frenet. Se muestra para las cotizaciones en tiempo real.
Price source: Live Frenet quote, Fixed price (price per country), Fallback cost o Free shipping.
Estos datos se conservan al desinstalar el módulo, también con Remove data on uninstall.
Clave de licencia
El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Frenet es el primer bloque de Modules > Module Manager > VibeFox Frenet > 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 quitar la clave de esta tienda. Debajo aparecen la línea Product: presta-shipping-frenet 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 el inglés y el 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 tras 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 sirve para 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 Frenet 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 tras introducir la clave, y después una vez por semana. No hace falta ninguna tarea cron. Al desinstalar o restablecer el módulo, siempre se eliminan la clave de licencia y el estado de la licencia.
Solución de problemas
Frenet no aparece en la finalización de compra: comprueba que la licencia esté activa y que Enable Frenet 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. Revisa los avisos de la parte superior de la página del módulo, los límites de peso y Minimum order amount. Motivos habituales: el cliente todavía no ha introducido un CEP completo de 8 dígitos y no hay precios fijos, o Frenet no devolvió ningún servicio para la ruta y no hay precio fijo. Además, los productos pueden limitarse a determinados transportistas en la página del producto.
Las cotizaciones en tiempo real no aparecen: activa Debug log, recarga la finalización de compra y mira el campo Log en la página del módulo. Muestra el motivo: no hay CEP de origen, no hay tipo de cambio del BRL, el CEP del cliente está incompleto, se supera un límite de peso o de importe, o aparecen los mensajes de los servicios omitidos.
El registro indica que el token de API fue rechazado (HTTP 401 o 403): copia de nuevo el token desde el panel de Frenet y pégalo en API token.
El registro indica que Frenet no devolvió servicios: activa al menos un transportista en el panel de Frenet.
Mi tienda vende en euros o dólares: Frenet responde en BRL. Introduce el BRL exchange rate (cuánto vale 1 BRL en tu moneda predeterminada).
Se cobran impuestos además del precio de Frenet: los precios de Frenet son precios finales del transportista. Pon Tax en No tax.
Las tarifas parecen desactualizadas tras un cambio: haz clic en Save en la página del módulo. Así se borran las cotizaciones de Frenet en caché.
La página indica que no se encontró el transportista Frenet: el transportista se borró en Shipping > Carriers. Restablece el módulo en Modules > Module Manager para volver a crearlo. Hasta entonces, al guardar aparece The settings were saved, but the carrier could not be updated.
Desinstalación
Ve a Modules > Module Manager, abre el menú junto a VibeFox Frenet y elige Uninstall. La clave de licencia y el estado de la licencia siempre se eliminan. Las cotizaciones en caché siempre se eliminan. Si Remove data on uninstall está activado, el transportista se borra (los pedidos conservan su historial) y se eliminan los ajustes y el registro. Si está desactivado, el transportista solo se desactiva y se conservan todos los ajustes. Al instalar de nuevo el módulo, o al usar Reset, el transportista guardado recupera el estado que tenía antes: un transportista que habías desactivado sigue desactivado. Los pedidos existentes conservan el transportista Frenet y el bloque Frenet de la página del pedido.
Frenet es una marca comercial de su respectivo titular. Este módulo no está afiliado a Frenet ni cuenta con su respaldo.