VibeFox Frenet for WooCommerce — Ayuda

Requisitos

WordPress: 5.8 o posterior.

WooCommerce: 5.0 o posterior, instalado y activo. El plugin no se activa sin él.

PHP: 8.0 o posterior.

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 funciona en un solo dominio.

Instalación

1. En WordPress ve a Plugins > Add New > Upload Plugin, elige el archivo ZIP del plugin y haz clic en Install Now. También puedes subir la carpeta vfd_frenet a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Shipping > VibeFox Frenet, o haz clic en Settings debajo del nombre del plugin en la página de Plugins.

4. Introduce tu clave de licencia de VibeFox en el bloque de licencia de la parte superior de la página y haz clic en Activate.

5. Pega el token de API e introduce el CEP de origen. Si la moneda de tu tienda no es BRL, introduce el tipo de cambio del BRL. Opcionalmente, añade precios fijos y un coste de reserva.

6. Añade VibeFox Frenet a una zona de envío para Brasil en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore shipping zones y elige los países.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox Frenet. Se aplican a todas las zonas de envío. Cuando añades el método a una zona, la ventana de la zona tiene un solo campo:

Title (zone): el nombre que ven los clientes para esta zona. Déjalo vacío para usar el Method title global.

En la parte superior de la página, el plugin muestra avisos: falta el token de API (solo se usan precios fijos, o el método nunca se muestra si tampoco hay precios fijos), falta un CEP de origen de 8 dígitos, o la moneda de la tienda no es BRL y no hay tipo de cambio. Cada vez que guardas los ajustes se borran las cotizaciones en caché. Los campos de precio aceptan tanto el punto como la coma como separador decimal.

General

Enable/Disable: desactiva o activa el método en todas las zonas a la vez. Por defecto: on.

Method title: el nombre del método de envío que se muestra en el carrito y en la finalización de compra. Una zona puede sustituirlo. Por defecto: Frenet.

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 solo se solicitan para direcciones en Brasil con un CEP completo de 8 dígitos.

API token: tu token de API de Frenet, del panel de Frenet. Déjalo vacío para usar solo precios fijos.

Origin CEP: 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, si la dirección de la tienda está en Brasil. Un CEP sin 8 dígitos se notifica al guardar.

Service to offer: Cheapest service (por defecto) o Fastest service. Frenet devuelve varios servicios, y el método muestra un solo precio.

BRL exchange rate: Frenet cotiza en reales brasileños. Si la moneda de tu tienda no es BRL, indica cuánto vale 1 BRL en la moneda de tu tienda, por ejemplo 0.16. Con él se convierten la cotización y el valor declarado del pedido. Sin él no se usan las cotizaciones en tiempo real. No hace falta si la moneda de la tienda es BRL.

Precios fijos

Se usan cuando no hay token de API, para 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 la moneda de tu tienda. Haz clic en + Add country para añadir una fila y en la cruz (×) 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 método.

Fixed price applies: Per order cobra el precio una 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 de reserva. Las cotizaciones de Frenet ya cubren todo el carrito.

Condiciones

Minimum weight (kg): oculta el método por debajo de este peso del carrito. 0 significa sin límite.

Maximum weight (kg): oculta el método por encima de este peso del carrito. Por defecto: 30. 0 significa sin límite.

Minimum order amount: muestra el método solo cuando el subtotal del carrito (después de descuentos y antes de impuestos) es al menos este importe. Déjalo vacío para mostrarlo siempre.

Excluded shipping classes: oculta el método si el carrito contiene un producto de cualquiera de estas clases de envío de WooCommerce.

Free shipping from: el subtotal del carrito (después de descuentos y antes de impuestos) a partir del cual el envío es gratuito. Déjalo vacío para no ofrecer nunca envío gratuito.

Tax status: Taxable añade el impuesto de WooCommerce al coste de envío; None no lo añade. Los precios de Frenet son precios finales del transportista; elige None si WooCommerce no debe añadir impuestos a ellos.

Los pesos de los productos se convierten de la unidad de tu tienda a kg.

Disponibilidad sin zonas de envío

Ignore shipping zones: ofrece Frenet para los países siguientes aunque no esté añadido a una zona de envío.

Countries: los países de destino para ese modo. 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 WooCommerce > Status > Logs, origen vfd-frenet. Los errores de la API siempre se registran. El token nunca se registra y el CEP del cliente se acorta. Desactívalo cuando termines.

Remove data on uninstall: si está activado, al eliminar el plugin se borran todos los ajustes de Frenet y los métodos de zona. Desactivar el plugin nunca borra los ajustes. Las cotizaciones en caché siempre se eliminan.

Cómo funciona en la finalización de compra

Cuando el cliente introduce una dirección de entrega, WooCommerce pide una tarifa al plugin. El plugin primero comprueba el peso del carrito, el importe mínimo del pedido y las clases de envío excluidas. Si se aplica el envío gratuito, el método se muestra con precio cero y no se envía ninguna solicitud a Frenet.

Para una dirección en Brasil con un CEP completo de 8 dígitos, el plugin envía a Frenet el CEP de origen y de destino, cada artículo del carrito (peso en kg, dimensiones en cm, cantidad, SKU y categorías), el valor del pedido en BRL y el primer cupón aplicado. No se hace ninguna solicitud mientras el CEP esté incompleto. Frenet devuelve los servicios de tus transportistas activados. Los servicios con error o sin precio se omiten. El plugin elige el servicio más barato o el más rápido y convierte el precio a la moneda de tu tienda. El transportista, el servicio y el plazo de entrega se guardan con la línea de envío del pedido y se muestran en la pantalla de pedidos del administrador.

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 de reserva, o el método se oculta si no hay ninguno. Para direcciones fuera de Brasil solo se usan precios fijos.

El método funciona en la finalización de compra clásica y en los bloques de Carrito y Finalizar compra. Es compatible con WooCommerce High-Performance Order Storage (HPOS).

El plugin solo calcula tarifas. No crea envíos, no imprime etiquetas ni hace seguimiento de paquetes; Frenet los ofrece en su propio panel. 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.

Clave de licencia

El plugin funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia está en la parte superior de WooCommerce > Settings > Shipping > VibeFox Frenet. Pega la clave en License key y haz clic en Activate. El bloque muestra el estado, por ejemplo la fecha hasta la que la licencia está activa y tu dominio. Usa Check now para comprobar el estado de nuevo, Change key para introducir otra clave y Remove key para quitarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.

Una clave funciona en un solo dominio. Quitar la clave de un sitio no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.

Sin una clave activa, Frenet no se muestra a los clientes en la finalización de compra. Los gestores de la tienda con sesión iniciada sí lo ven, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar el plugin antes de comprar una clave. En la página de Plugins y en las páginas de WooCommerce aparece un recordatorio. Los pedidos existentes no se ven afectados.

Cuando una licencia caduca, el plugin sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.

Solución de problemas

Frenet no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado y que el método está añadido a la zona del país 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 de ajustes, los límites de peso, Minimum order amount y Excluded shipping classes. Motivos habituales: el cliente aún 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.

Las cotizaciones en tiempo real no aparecen: activa Debug log, recarga la finalización de compra y abre WooCommerce > Status > Logs, origen vfd-frenet. Ahí se ve el motivo: un token rechazado (HTTP 401 o 403), falta el CEP de origen, falta el tipo de cambio del BRL, no hay transportistas activados en el panel de Frenet, o los mensajes de los servicios omitidos.

Mi tienda vende en euros o dólares: Frenet responde en BRL. Introduce el BRL exchange rate (cuánto vale 1 BRL en la moneda de tu tienda).

Las tarifas parecen desactualizadas después de un cambio: guarda la página de ajustes. Esto borra las cotizaciones en caché.

El bloque de licencia muestra un error: sigue el mensaje del bloque. Por ejemplo, si la clave ya se usa en otro dominio, libera una plaza en tu cuenta de vibefox.net y haz clic en Check now. Si cambió la dirección del sitio, haz clic en Check now para activar la clave en el nuevo dominio. Si no se puede acceder al servidor de licencias, el plugin sigue funcionando con el último estado conocido.

Desinstalación

Desactivar el plugin conserva todos los ajustes y solo borra las cotizaciones en caché. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin, las cotizaciones en caché y los archivos de registro antiguos siempre se eliminan. Los ajustes y los métodos de zona se eliminan solo si Remove data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus líneas de envío con el transportista de Frenet.

Frenet es una marca comercial de su respectivo titular. Este plugin no está afiliado a Frenet ni cuenta con su respaldo.