VibeFox Loggi 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 Loggi (solo para precios en tiempo real): el precio en tiempo real usa la API GraphQL de Loggi con una clave de API que Loggi emite para cuentas de empresa. Pregunta a tu gestor de cuenta de Loggi o al soporte de integraciones de Loggi (integracoes@loggi.com); consulta también la documentación de la API de Loggi en docs.api.loggi.com. Necesitas tres valores: el correo electrónico de tu cuenta de Loggi, la clave de API y el ID numérico de tu tienda. Si tu cuenta de Loggi solo tiene credenciales para la API de la nueva plataforma REST de Loggi (ID de cliente y secreto), el precio en tiempo real no está disponible y se usan los precios fijos. Si solo usas precios fijos, no necesitas una cuenta de Loggi.

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_loggi a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox Loggi, o haz clic en Settings debajo del nombre del plugin en la página 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. Introduce el correo electrónico de la API de Loggi, la clave de API, el Shop ID y la dirección de recogida y, si la moneda de tu tienda no es BRL, el tipo de cambio de BRL. Añade precios fijos como red de seguridad (véase Configuración).

6. Añade VibeFox Loggi 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 Loggi. Se aplican a todas las zonas de envío. Cuando añades el método a una zona, la ventana de la zona solo tiene un campo:

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

Las advertencias en la parte superior de la página indican una configuración incompleta: sin credenciales de API, sin dirección de recogida o sin tipo de cambio de BRL. Cada vez que guardas los ajustes, se borran los precios de Loggi en caché.

General

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

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. Predeterminado: Loggi.

API de Loggi (precio en tiempo real) (deja las credenciales vacías para usar solo precios fijos)

API e-mail: el correo electrónico de tu cuenta de Loggi. La clave de API pertenece a esa cuenta.

API key: tu clave de API de Loggi. Solo se envía a Loggi y nunca se registra.

Shop ID: el ID numérico (pk) de tu tienda en el panel de Loggi. Solo se acepta un número positivo. Otro valor se rechaza con un error y se conserva el guardado.

Staging: usa el entorno de staging de Loggi con credenciales de prueba. Staging y producción tienen cuentas y claves distintas. Predeterminado: desactivado.

Pickup address: dónde recoge Loggi los paquetes, en una sola línea: calle y número, barrio, ciudad, estado y CEP, por ejemplo Rua Example, 123 - Bairro, São Paulo - SP, 01310-100. Déjalo vacío para usar la dirección de la tienda de WooCommerce > Settings > General si está en Brasil. Sin dirección de recogida, Loggi no puede estimar y solo se usan los precios fijos.

BRL exchange rate: los precios de Loggi están en reales brasileños. Si la moneda de tu tienda es BRL, este campo no es necesario. Si no, introduce cuánto vale 1 BRL en la moneda de tu tienda, por ejemplo 0.16. Sin él no se usan los precios en tiempo real. Se aceptan tanto el punto como la coma como separador decimal.

Precios fijos (en la moneda de tu tienda)

Los precios fijos se usan cuando la API de Loggi no está configurada, para destinos fuera de Brasil o sin un CEP completo, y siempre que Loggi no devuelve ningún precio (API caída, clave rechazada, dirección fuera de cobertura).

Price table: una fila por país de destino. Haz clic en + Add country para añadir una fila y en el icono de cruz para eliminar una. Elige * All other countries para todos los países que no tengan fila propia. Cada fila tiene un Base price y columnas de peso: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg y XL >5 kg. Una columna de peso vacía (o 0) usa el precio base. Precio base 0 significa envío gratuito. Se aceptan tanto "9.99" como "9,99". Al guardar se eliminan las filas vacías y cualquier segunda fila del mismo país.

Price for countries not in the table: se usa cuando no hay precio en tiempo real de Loggi y la tabla no tiene fila para el país de destino (y tampoco una fila *). Déjalo vacío para ocultar el método en ese caso.

Fixed price applies: la forma en que se calculan los precios fijos. Un precio en tiempo real de Loggi ya cubre todo el carrito y nunca se multiplica.

Condiciones

Minimum weight (kg): oculta el método cuando el carrito pesa menos. 0 significa sin límite.

Maximum weight (kg): oculta el método cuando el carrito pesa más. Predeterminado: 30. 0 significa sin límite.

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

Free shipping from: el subtotal del carrito (después de descuentos, antes de impuestos) a partir del cual el envío de Loggi es gratuito. Déjalo vacío si no hay envío gratuito.

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

Tax status: Taxable añade el impuesto de WooCommerce al coste del envío, None no lo añade. Elige None si tus precios y el precio de Loggi ya incluyen impuestos.

Disponibilidad sin zonas de envío

Ignore shipping zones: ofrece Loggi para los países indicados abajo, aunque el método no esté añadido a ninguna 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. Este campo solo se usa cuando Ignore shipping zones está activado.

Avanzado

Debug log: registra cada cálculo de tarifa y cada solicitud a Loggi en WooCommerce > Status > Logs (origen vfd-loggi). Los errores de la API siempre se registran, aunque esta opción esté desactivada. La clave de API y las direcciones de los clientes nunca se registran.

Remove data on uninstall: si está activado, al borrar el plugin se eliminan todos los ajustes de Loggi y los métodos de zona. Desactivar el plugin nunca borra los ajustes.

Cómo funciona en la finalización de compra

Cuando el cliente introduce una dirección de entrega, WooCommerce pide al plugin una tarifa. Primero el plugin comprueba las condiciones: país de entrega, peso del carrito, importe mínimo del pedido y clases de envío excluidas. Si se aplica el envío gratuito, el cliente ve el método sin coste y no se envía ninguna solicitud a Loggi.

Para una dirección en Brasil con un CEP completo de 8 dígitos, el plugin construye los paquetes de Loggi: cada artículo se gira para que su lado más corto sea la altura, y los artículos se apilan en un solo paquete mientras no supere 55 × 55 × 55 cm y 20 kg. Los productos sin peso ni dimensiones cuentan como 1 cm por lado, y cada paquete pesa al menos 100 g. Loggi acepta 2 paquetes por estimación, así que los carritos más grandes se envían en varias solicitudes y los totales se suman. El plugin envía a Loggi tu Shop ID, la dirección de recogida, la dirección de entrega y los paquetes, convierte el total de Loggi de BRL a la moneda de tu tienda y lo muestra.

Cada precio de Loggi se guarda en caché durante 1 hora por carrito, dirección, cuenta y entorno, para que el mismo carrito no provoque una nueva solicitud. Una estimación fallida se guarda en caché durante 10 minutos. Si no se puede contactar con Loggi, las solicitudes se pausan durante 2 minutos, para que la finalización de compra no espere a Loggi en cada actualización. El tiempo de espera de la API es de 10 segundos.

Se usan precios fijos en su lugar cuando la API no está configurada, la dirección está fuera de Brasil o aún no tiene un CEP completo, falta el tipo de cambio de BRL, un producto es más grande que un paquete de Loggi, el carrito necesita más de 10 paquetes, o Loggi devuelve un error, un paquete rechazado, una dirección fuera de cobertura o un total de cero. Si tampoco hay precio fijo, el método se oculta. El cliente nunca ve un error de la API. El motivo se escribe en el registro.

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

El plugin solo calcula precios. No crea pedidos ni envíos de Loggi, no imprime etiquetas, no hace seguimiento de paquetes, no muestra el plazo de entrega en la finalización de compra ni ofrece puntos de recogida o taquillas. Crea los envíos en el panel de Loggi. Loggi entrega 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 Loggi. 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 volver a comprobar el estado, Change key para introducir otra clave y Remove key para eliminarla 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. Eliminar la clave de un sitio no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.

Sin una clave activa, Loggi 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. Aparece un recordatorio en la página Plugins y en las páginas de WooCommerce. Los pedidos existentes no se ven afectados.

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

Solución de problemas

Loggi 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 permitido). Revisa las advertencias en la parte superior de la página de ajustes, los límites de peso, Minimum order amount y Excluded shipping classes. Si el cliente aún no ha introducido un CEP completo o Loggi no devuelve ningún precio, el método necesita un precio fijo: una fila para el país, una fila * o Price for countries not in the table.

Solo se muestran precios fijos: abre WooCommerce > Status > Logs, origen vfd-loggi. Los errores siempre se registran. Activa Debug log para ver cada paso. Motivos habituales: falta el correo electrónico, la clave o el Shop ID de la API, no hay dirección de recogida, no hay BRL exchange rate para una moneda de tienda distinta de BRL, todavía no hay un CEP completo de 8 dígitos, un producto es más grande que 55 cm o más pesado que 20 kg, o una dirección está fuera de la cobertura de Loggi.

HTTP 401 o 403 en el registro: Loggi rechazó el correo electrónico o la clave de API. Compruébalos con Loggi y verifica que Staging coincide con las credenciales: las claves de staging y de producción son distintas.

Mi tienda vende en euros o dólares: Loggi responde en BRL. Introduce el BRL exchange rate (cuánto vale 1 BRL en la moneda de tu tienda). Los precios fijos siempre están en la moneda de tu tienda.

Los precios no son exactos: rellena el peso y las dimensiones de tus productos. Sin ellos, los productos cuentan como 1 cm por lado y cada paquete como mínimo 100 g.

Por artículo no multiplica el precio de Loggi: es lo previsto. Un precio en tiempo real de Loggi cubre todo el carrito. Per item se aplica solo a los precios fijos.

Los precios parecen desactualizados tras un cambio: guarda la página de ajustes. Así se borran los precios de Loggi 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 contactar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.

Desinstalación

Desactivar el plugin conserva todos los ajustes. Solo se borran los precios de Loggi 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 y los precios en caché 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.

Loggi es una marca comercial de su respectivo titular. Este plugin no está afiliado a Loggi ni cuenta con su aprobación.