VibeFox GIG Logistics 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.

Credenciales de la API de GIG Logistics (solo para precios en tiempo real): los precios en tiempo real usan la API de terceros de GIG Logistics. GIG Logistics facilita a los clientes profesionales un nombre de usuario de API (normalmente una dirección de correo electrónico) y una contraseña. Solicítalos en la página para desarrolladores de GIG Logistics (giglogistics.com/developer). Las credenciales de prueba solo funcionan con la API de prueba. Si solo usas la tabla de precios y el coste alternativo, no necesitas credenciales de API.

Nigeria en tu tienda: los precios en tiempo real se solicitan solo para direcciones de entrega en Nigeria, así que el país Nigeria debe existir y estar activo en International > Locations > Countries.

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 subida, haz clic en Configure, o busca más tarde VibeFox GIG Logistics 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. Rellena la tabla de precios y/o el coste alternativo. Para los precios en tiempo real, introduce también el nombre de usuario y la contraseña de la API, el teléfono, la ciudad y el estado de recogida, y la tasa de conversión de moneda si tu moneda predeterminada no es NGN (ver Configuración). Haz clic en Save.

5. Si el campo Nigerian states muestra el botón Add Nigerian states, haz clic en él (ver Configuración).

Al instalar, el módulo crea el transportista GIG Logistics con el texto del tiempo de entrega Courier delivery. El transportista se vincula a la zona de Nigeria (en una tienda predeterminada, África) y a todos los grupos de clientes. Puedes cambiar las zonas, los grupos de clientes, el tiempo de entrega, el logotipo y los límites de tamaño en Shipping > Carriers. No definas 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 GIG Logistics > Configure. Cada sección tiene su propio botón Save, que guarda toda la página. Cada guardado también borra los precios de GIG Logistics, los tokens de la API y las coordenadas de las direcciones que estén en caché.

Encima de las secciones, la página muestra advertencias cuando no se pueden usar los precios en tiempo real: solo se ha introducido el nombre de usuario o la contraseña de la API, falta el Sender phone o la ciudad o el estado de recogida, o tu moneda predeterminada no es NGN y no se ha definido una Currency conversion rate. También avisa cuando no se encuentra el transportista GIG Logistics, y cuando la unidad de peso de tu tienda (International > Localization > Local units) no es una que el módulo conozca; en ese caso, los pesos de los productos se leen como kg. Al guardar, se notifica un número incorrecto (una cantidad negativa, una Currency conversion rate de 0, una latitud fuera del rango de -90 a 90, una longitud fuera del rango de -180 a 180), un Min weight (kg) mayor que Max weight (kg), un Method title vacío o no válido, o una regla de impuesto desconocida, y no se guarda nada.

General

Los ajustes de esta página se aplican a todas las zonas del transportista.

Enable/Disable: 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. Por defecto: GIG Logistics. Obligatorio.

Tax: la regla de impuesto del transportista, o No tax. Una regla de impuesto añade tu impuesto de envío sobre el coste. Elige No tax si el precio de GIG ya incluye todo lo que quieres cobrar.

GIG Logistics API (live prices) (opcional)

Con credenciales de API, el precio se solicita a GIG Logistics para cada dirección nigeriana. Sin credenciales, o cuando la API no devuelve ningún precio, se usan la tabla de precios y el coste alternativo.

API username: tu nombre de usuario de la API de terceros de GIG Logistics, normalmente tu dirección de correo electrónico.

API password: tu contraseña de la API de terceros de GIG Logistics. Se usa solo para iniciar sesión en la API y nunca se registra. Después de guardar, el campo queda vacío y muestra Saved — leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarla. Para eliminar la contraseña, borra API username y guarda.

Test mode: usa la API de prueba (dev) de GIG Logistics. Las credenciales de prueba solo funcionan con la API de prueba. Desactívalo para obtener precios reales. Por defecto: desactivado.

Currency conversion rate: GIG Logistics devuelve los precios en NGN. Si la moneda predeterminada de tu tienda no es NGN, introduce cuánto vale un NGN en tu moneda predeterminada (1 NGN = ? de tu moneda, por ejemplo 0.0006). La tasa debe ser mayor que 0. Sin ella, no se usan los precios de GIG en tiempo real. Si tu moneda predeterminada es NGN, el campo lo indica y no hace falta. Se aceptan tanto el punto como la coma como separador decimal.

Pickup (sender) address

Dónde recoge GIG Logistics los paquetes, en Nigeria. Si tu tienda está en Nigeria, los campos vacíos de calle, ciudad y estado usan la dirección de la tienda de Shop Parameters > Contact > Stores.

Sender name: el nombre del remitente que se envía a GIG Logistics. Si está vacío, se usa el nombre de la tienda.

Sender phone: tu número de teléfono, por ejemplo 08030000000. GIG Logistics lo exige para los precios en tiempo real.

Street address: la calle de la dirección de recogida.

City / area: la ciudad o zona de recogida, por ejemplo Victoria Island. Obligatorio para los precios en tiempo real.

State: el estado nigeriano de la dirección de recogida, elegido entre los 37 estados. La opción predeterminada, Shop state (Shop parameters > Contact > Stores), usa el estado de la dirección de la tienda. Obligatorio para los precios en tiempo real.

Pickup latitude: latitud de mapa opcional del punto de recogida, por ejemplo 6.4281. GIG Logistics calcula los precios por distancia. Si está vacío, las coordenadas se buscan a partir de la dirección.

Pickup longitude: longitud de mapa opcional del punto de recogida, por ejemplo 3.4219.

Address lookup: busca coordenadas de mapa de las direcciones con OpenStreetMap (Nominatim). GIG Logistics calcula el precio a partir de las coordenadas de recogida y de entrega. La calle, la ciudad y el estado del cliente se envían a nominatim.openstreetmap.org, y los resultados se guardan en caché durante 30 días. Sin esta función, solo se envía el texto de la dirección y GIG Logistics puede no devolver un precio. Por defecto: activado.

Nigerian states: el estado de la dirección de entrega se envía a GIG Logistics y a la búsqueda de direcciones. PrestaShop no tiene estados nigerianos por defecto; sin ellos, solo se usan la calle y la ciudad. El botón Add Nigerian states añade los 37 estados (códigos LA, FC, etc.), activa Contains states para Nigeria y añade el campo de estado al formulario de dirección nigeriana. Los estados que ya existen (por código o por nombre) no se añaden dos veces. Cuando todo está listo, el campo muestra cuántos estados tienen las direcciones nigerianas. No se cambia nada hasta que hagas clic en el botón.

Price table and fallback

Se usa para otros países, cuando los precios en tiempo real no están configurados o cuando GIG Logistics no devuelve ningún precio. Los precios están en la moneda predeterminada de tu tienda, sin impuestos.

Country prices: una tabla con un precio base por país. Haz clic en Add country para añadir una fila y en el icono de papelera para eliminar una. Elige * Any other country para todos los países sin fila propia. Las columnas XS (hasta 1 kg), S (hasta 2 kg), M (hasta 3 kg), L (hasta 5 kg) y XL (más de 5 kg) son precios opcionales por tramo de peso: un precio de tramo mayor que 0 sustituye al precio base para los carritos de ese tramo. Un precio de 0 significa envío gratuito. Las celdas de precio vacías se guardan como 0, así que rellena el precio base de cada fila que añadas. Si un país aparece dos veces, se conserva la fila posterior. Los valores corregidos se indican en una advertencia tras guardar. Los países sin fila (cuando no hay fila *) no obtienen precio de la tabla.

Fallback cost: se usa cuando ni GIG Logistics ni la tabla dan un precio. Si está vacío, el transportista se oculta en ese caso.

Table / fallback price is: Per order cobra el precio una sola vez. Per item (multiplied by the number of items) lo multiplica por el número de artículos del carrito. Los precios en tiempo real de GIG siempre se refieren al pedido completo.

Conditions

Free shipping from: el subtotal del carrito (productos que requieren envío, después de descuentos, sin impuestos) a partir del cual el envío es gratuito. Si está vacío, nunca es gratuito.

Minimum subtotal: muestra el transportista solo cuando el subtotal del carrito alcanza este importe. Si está vacío, se muestra siempre.

Min weight (kg): el peso mínimo del carrito en kg. Los pesos de los productos se convierten desde la unidad de peso de tu tienda. 0 significa sin límite.

Max weight (kg): el peso máximo del carrito en kg. Por defecto: 30. 0 significa sin límite.

Availability without shipping zones

Ignore shipping zones: ofrece el transportista para los países indicados abajo, aunque sus zonas no los incluyan. Al activarlo, el transportista se vincula a todas las zonas activas, y las zonas creadas después también se vinculan. Al desactivarlo, el transportista recupera sus zonas anteriores.

Countries: los países de destino para ese modo. Si está vacío, son todos los países a los que envías. Se usa solo con Ignore shipping zones.

Advanced

Debug log: escribe los cálculos de precios en logs/vfd_gigl_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, incluso con el registro desactivado. No se escriben contraseñas, tokens ni direcciones de clientes.

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 sus ajustes, el transportista, las cachés y los registros. Si está desactivado, se conserva todo para una reinstalación. Los pedidos siempre se conservan.

Cómo funciona en la finalización de compra

En el paso de envío, PrestaShop pide al módulo el precio de GIG Logistics. Solo cuentan los productos que requieren envío: los productos virtuales no suman peso y no se incluyen en el subtotal. El módulo comprueba primero las condiciones: el país de entrega (con Ignore shipping zones), el peso del carrito y el subtotal mínimo. Si el subtotal alcanza Free shipping from, el precio es 0 y no se envía ninguna solicitud a GIG Logistics.

Después, el precio se toma de la primera fuente que dé uno. Primero, el precio en tiempo real de GIG Logistics, si se han introducido credenciales de API, la dirección está en Nigeria, la dirección tiene ciudad o estado, el teléfono, la ciudad y el estado de recogida están definidos, y para las tiendas cuya moneda predeterminada no es NGN se ha definido una tasa de conversión. El módulo inicia sesión en la API de GIG Logistics y envía las direcciones de recogida y de entrega, las coordenadas y los artículos del carrito con nombres, cantidades, pesos y valores. Los productos sin peso se envían como 1 kg. El precio se solicita para entrega en bicicleta. Segundo, la tabla Country prices. Tercero, el Fallback cost. Si ninguno da un precio, el transportista se oculta en ese carrito. El precio se calcula en tu moneda predeterminada y después se muestra en la moneda del carrito del cliente.

Cada respuesta de GIG se guarda en caché durante 1 hora, así que el mismo carrito no provoca una nueva solicitud. Una solicitud fallida o un inicio de sesión fallido se guarda en caché durante 10 minutos, para que la finalización de compra no espere a GIG Logistics en cada actualización. El token de inicio de sesión se conserva 30 minutos y se renueva automáticamente cuando GIG lo rechaza. El tiempo de espera de la API es de 10 segundos, y el de la búsqueda de direcciones, de 5 segundos.

Si GIG Logistics devuelve un error o un precio de cero, el cliente no ve ningún error. Se usa el precio de la tabla o el coste alternativo, y el error 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 envíos, guías de envío ni etiquetas de GIG Logistics, no reserva recogidas, no hace seguimiento de paquetes y no permite a los clientes elegir un centro de servicio. Los pedidos se envían a través de tu cuenta de GIG Logistics como de costumbre. Los precios en tiempo real se solicitan solo para direcciones nigerianas. Para otros países, usa la tabla de precios.

Clave de licencia

El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox GIG Logistics es el primer bloque de Modules > Module Manager > VibeFox GIG Logistics > 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-gig-logistics 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 GIG Logistics 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

GIG Logistics no aparece en la finalización de compra: comprueba que la licencia esté activa y que Enable/Disable esté activado. En Shipping > Carriers, comprueba que el transportista cubra la zona del país del cliente y el grupo del cliente, o activa Ignore shipping zones y revisa Countries. Revisa los límites de peso y el Minimum subtotal. Comprueba que la tabla (el país o *) o el Fallback cost den un precio para el país. En la ficha de producto también se pueden limitar los productos a ciertos transportistas.

El precio viene de la tabla, no de GIG Logistics: los precios en tiempo real necesitan el nombre de usuario y la contraseña de la API, el Sender phone, la ciudad y el estado de recogida, una dirección de entrega nigeriana con ciudad o estado y, para las tiendas cuya moneda predeterminada no es NGN, la Currency conversion rate. Revisa las advertencias de la parte superior de la página de configuración. Activa el Debug log, recarga la finalización de compra y mira el campo Log en la página del módulo para ver el motivo. Una solicitud fallida se reintenta a los 10 minutos.

Login failed en el registro: GIG Logistics rechazó el nombre de usuario o la contraseña de la API. Revísalos y revisa Test mode: las credenciales de prueba solo funcionan con la API de prueba. Guarda los ajustes para reintentar de inmediato.

GIG Logistics no devuelve ningún precio: GIG calcula los precios por distancia. Mantén Address lookup activado, o introduce Pickup latitude y Pickup longitude. Haz clic en Add Nigerian states para que también se envíe el estado de entrega. Confirma los precios con tu cuenta de GIG Logistics antes de pasar a producción.

La advertencia de ciudad y estado de recogida sigue apareciendo: elige un estado en State y rellena City / area. La dirección de la tienda solo se usa cuando el país de la tienda es Nigeria, y el estado de la tienda solo se conoce después de añadir los estados nigerianos y elegirlo en Shop Parameters > Contact > Stores.

Se cobra impuesto sobre el precio de GIG: pon Tax en No tax si el precio de GIG ya incluye todo lo que quieres cobrar.

Los precios parecen desactualizados tras un cambio: haz clic en Save en la página del módulo. Esto borra los precios, tokens y coordenadas guardados en caché.

La página indica que no se encontró el transportista GIG Logistics: 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 GIG Logistics y elige Uninstall. La clave de licencia y el estado de la licencia siempre se eliminan. Los precios, tokens y coordenadas de direcciones guardados 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 su estado anterior. Los estados nigerianos añadidos con Add Nigerian states permanecen en tu tienda en ambos casos.

GIG Logistics es una marca comercial de su respectivo titular. Este módulo no está afiliado a GIG Logistics ni cuenta con su respaldo.