VibeFox Loggi for PrestaShop — Ayuda
Requisitos
PrestaShop: 8.0 a 9.x.
PHP: 8.0 o posterior. El módulo se niega a instalarse en versiones anteriores de PHP.
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. Pide información 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 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 carga, haz clic en Configure, o busca VibeFox Loggi 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 (véase Clave de licencia).
4. 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 predeterminada de tu tienda no es BRL, el tipo de cambio BRL. Añade precios fijos como red de seguridad (consulta Configuración) y haz clic en Save.
5. Añade Brasil a las zonas del transportista de Loggi en Shipping > Carriers, o activa Ignore shipping zones y elige países.
Al instalarse, el módulo crea el transportista Loggi con el texto del plazo de entrega Courier delivery in Brazil. 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 Loggi > 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 los precios de Loggi en caché.
Las advertencias en la parte superior de la página indican una configuración incompleta: sin credenciales de API (solo se usan precios fijos), sin credenciales de API ni precios fijos (el transportista nunca se muestra), sin dirección de recogida, sin tipo de cambio BRL, o una unidad de peso o de dimensiones de la tienda que el módulo no reconoce (en ese caso se cuenta como kg o cm; configura las unidades en International > Localization). Si un valor no es válido, por ejemplo un número negativo, la página muestra un error y no se guarda nada.
General
Enable Loggi: activa o desactiva el transportista. Es el mismo interruptor que el estado del transportista en Shipping > Carriers.
Method title: el nombre del transportista que el cliente ve en el carrito y en la finalización de compra. Predeterminado: Loggi. Obligatorio, 64 caracteres como máximo.
Loggi API (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 le pertenece. Debe ser una dirección de correo válida.
API key: tu clave de API de Loggi. Solo se envía a Loggi y nunca se registra. Después de guardar, el campo queda vacío y muestra Saved — leave empty to keep it; clear the API e-mail to remove it. Escribe un valor nuevo solo si quieres cambiarla. Si cambias API e-mail, introduce también la clave de API del nuevo correo; de lo contrario, la página muestra un error y no se guarda nada. Para eliminar la clave guardada, borra API e-mail y guarda.
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.
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éjala vacía para usar la dirección de la tienda de Shop Parameters > Contact > Stores si está en Brasil y tiene dirección y ciudad. Sin dirección de recogida, Loggi no puede estimar y solo se usan precios fijos.
BRL exchange rate: los precios de Loggi están en reales brasileños. Si la moneda predeterminada de tu tienda es BRL, este campo no es necesario y la página lo indica. 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. Solo se acepta un número positivo. Se aceptan tanto el punto como la coma como separador decimal.
Precios fijos (en la moneda predeterminada de tu tienda, sin impuestos)
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 devuelva 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 papelera para eliminar una. Elige * All other countries para todos los países sin 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. Si una columna de peso está vacía (o es 0), se usa el precio base. Un precio base de 0 significa envío gratuito. Se aceptan tanto "9.99" como "9,99". Al guardar se eliminan las filas vacías y una segunda fila para el 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 (ni fila *). Déjalo vacío para ocultar el transportista 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: oculta el transportista cuando el carrito pesa menos, en kg. 0 significa sin límite.
Maximum weight: oculta el transportista cuando el carrito pesa más, en kg. Predeterminado: 30. 0 significa sin límite. Minimum weight no puede ser mayor que Maximum weight.
Minimum order amount: muestra el transportista solo cuando el subtotal del carrito (después de descuentos, sin impuestos) alcanza este importe. Déjalo vacío para mostrarlo siempre.
Free shipping from: el subtotal del carrito (después de descuentos, sin impuestos) a partir del cual el envío de Loggi es gratuito. Déjalo vacío si no hay envío gratuito.
Tax: la regla de impuestos del transportista, o No tax. Elige No tax si tus precios y el precio de Loggi ya incluyen impuestos.
Para los límites de peso y las columnas de peso, un producto sin peso cuenta como 0 kg.
Disponibilidad sin zonas de envío
Ignore shipping zones: ofrece Loggi para los países indicados abajo, sea cual sea la zona que coincida. Si guardas con esta opción activada, el transportista se añade a todas las zonas, y también a las zonas creadas después. Al desactivarla se eliminan esas zonas añadidas y el transportista recupera sus propias zonas.
Countries: los países de destino para ese modo. Déjalo vacío para permitir todos los países activos de tu tienda. Este campo solo se usa si Ignore shipping zones está activado.
Avanzado
Debug log: escribe los cálculos de precios y las solicitudes a Loggi en logs/vfd_lggi_debug.log.php, en la carpeta del módulo. El archivo no se puede abrir desde la web. 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.
Log: muestra el tamaño y las entradas más recientes del registro de depuración. Haz clic en Clear log para vaciarlo.
Remove data on uninstall: si está activado, al desinstalar el módulo se eliminan los ajustes de Loggi, el transportista, los precios en caché y los registros. Si está desactivado, todo se conserva para una reinstalación.
Cómo funciona en la finalización de compra
En el paso de envío, PrestaShop pide al módulo el precio de Loggi. Solo cuentan los productos físicos: los productos virtuales no suman peso ni se incluyen en el importe del pedido. El módulo comprueba primero las condiciones: países permitidos (con Ignore shipping zones), peso del carrito e importe mínimo del pedido. Si se aplica el envío gratuito, el precio es 0 y no se envía ninguna solicitud a Loggi.
Para una dirección en Brasil con un CEP completo de 8 dígitos, el módulo crea paquetes de Loggi: cada artículo se gira para que su lado más pequeño sea la altura, y los artículos se apilan en un mismo 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 módulo envía a Loggi el Shop ID, la dirección de recogida, la dirección de entrega y los paquetes, y convierte el total de Loggi de BRL a la moneda predeterminada de tu tienda. Después, el precio se muestra en la moneda del carrito del cliente.
Cada precio de Loggi se guarda en caché durante 1 hora por carrito, dirección, cuenta y entorno, para que el mismo carrito no genere una nueva solicitud. Una estimación fallida se guarda en caché durante 10 minutos. Si no se puede acceder a 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 los 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 BRL, no hay dirección de recogida, 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 transportista se oculta. El cliente nunca ve un error de la API. El motivo se escribe en el registro de depuración.
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 la nueva versión automáticamente.
El módulo 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 módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Loggi es el primer bloque de Modules > Module Manager > VibeFox Loggi > Configure, por encima de los ajustes. Introduce la clave en License key y haz clic en Activate. Después, el bloque muestra la clave oculta, 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-loggi 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 después de liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si no se puede acceder al 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. 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 transportista de Loggi no se muestra a los clientes en la finalización de compra y no se calcula ninguna tarifa. La parte pública 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 requieren 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. Al desinstalar o restablecer el módulo se eliminan siempre la clave de licencia y el estado de la licencia.
Solución de problemas
Loggi no aparece en la finalización de compra: comprueba que la licencia esté activa y que Enable Loggi 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 las advertencias en la parte superior de la página del módulo, los límites de peso y Minimum order amount. Si el cliente aún no ha introducido un CEP completo o Loggi no devuelve ningún precio, el transportista necesita un precio fijo: una fila para el país, una fila * o Price for countries not in the table. Los productos también pueden limitarse a determinados transportistas en la página del producto.
Solo se muestran precios fijos: mira el campo Log de la página del módulo. Los errores siempre se registran. Activa Debug log para ver cada paso y recarga la finalización de compra. Motivos habituales: falta el correo de la API, la clave o el Shop ID, no hay dirección de recogida, no se ha introducido BRL exchange rate para una moneda de tienda distinta de BRL, el cliente aún no ha introducido un CEP completo de 8 dígitos, un producto es más grande que 55 cm o pesa más de 20 kg, o la dirección está fuera de la cobertura de Loggi.
HTTP 401 o 403 en el registro: Loggi rechazó el correo o la clave de la API. Compruébalos con Loggi y comprueba que Staging coincide con las credenciales: las claves de staging y de producción son distintas.
Mi tienda vende en euros o en dólares: Loggi responde en BRL. Introduce BRL exchange rate (cuánto vale 1 BRL en la moneda predeterminada de tu tienda). Los precios fijos siempre están en la moneda predeterminada 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.
Per item 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: haz clic en Save en la página del módulo. Esto borra los precios de Loggi en caché.
La página indica que no se encontró el transportista de Loggi: 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 Loggi y elige Uninstall. La clave de licencia y el estado de la licencia se eliminan siempre. Los precios de Loggi en caché siempre se eliminan. Si Remove data on uninstall está activado, el transportista se elimina (los pedidos conservan su historial) y se borran los ajustes y el registro. Si está desactivado, el transportista solo se desactiva y se conservan todos los ajustes. Al volver a instalar el módulo, el transportista guardado recupera el estado que tenía antes de la desinstalación.
Loggi es una marca comercial de su respectivo titular. Este módulo no está afiliado a Loggi ni cuenta con su respaldo.