VibeFox GIG Logistics for OpenCart — Ayuda

Requisitos

OpenCart: 3.0.x (probado en 3.0.5.0) o 4.0.2 y posteriores (probado en 4.1.0.3).

PHP: 8.0 o posterior.

Credenciales de la API de GIG Logistics (solo para precios en vivo): los precios en vivo usan la API de terceros de GIG Logistics. GIG Logistics facilita a los clientes comerciales 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 pruebas. Si solo usas la tabla de precios y el coste de reserva, no necesitas credenciales de la API.

Nigeria en tu tienda: los precios en vivo se solicitan solo para direcciones de entrega en Nigeria. OpenCart ya tiene el país Nigeria con sus 37 estados; debe estar activado en System > Localisation > Countries.

Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo dominio.

Instalación

La descarga es un único archivo zip con los paquetes para ambas versiones de OpenCart. Descomprímelo en tu ordenador. Contiene README.txt, el paquete de OpenCart 3 vfd_gig_logistics-oc3-(version).ocmod.zip y el paquete de OpenCart 4 vfd_gig_logistics.ocmod.zip. Instala solo el paquete de tu versión de OpenCart. La clave de licencia es la misma en ambas versiones.

OpenCart 3

1. En el administrador ve a Extensions > Installer, haz clic en Upload y elige el archivo vfd_gig_logistics-oc3-(version).ocmod.zip. La extensión no añade modificaciones OCMOD, así que no necesitas actualizar Extensions > Modifications. En lugar del instalador, también puedes copiar el contenido de la carpeta upload de este paquete en la carpeta raíz de tu tienda.

2. Ve a Extensions > Extensions y elige el tipo de extensión Shipping. Busca VibeFox GIG Logistics y haz clic en Install (el botón verde +).

3. Haz clic en Edit (el botón del lápiz) para abrir la página de ajustes.

4. Introduce tu clave de licencia de VibeFox en License key, en el bloque de licencia de la parte superior de la página Edit, y haz clic en Activate (véase Clave de licencia).

5. Rellena la tabla de precios y/o el coste de reserva. Para los precios en vivo, introduce también el nombre de usuario y la contraseña de la API, el teléfono de recogida, la calle, la ciudad y el estado, y el tipo de conversión de moneda si tu moneda predeterminada no es NGN (véase Configuración). Activa Enable/Disable y haz clic en Save.

OpenCart 4

1. En el administrador ve a Extensions > Installer, haz clic en Upload y elige el archivo vfd_gig_logistics.ocmod.zip. No cambies el nombre del archivo: OpenCart 4 toma el código de la extensión a partir del nombre del archivo, y un paquete renombrado no funciona.

2. El paquete aparece en la lista de extensiones instaladas en la misma página. Haz clic en Install (el botón verde +) junto a él.

3. Ve a Extensions > Extensions y elige el tipo de extensión Shipping. Busca VibeFox GIG Logistics, haz clic en Install (el botón verde +) y, después, en Edit (el botón del lápiz).

4. Introduce la clave de licencia y los ajustes como en los pasos 4 y 5 de OpenCart 3. La página de ajustes y sus campos son los mismos en ambas versiones.

Tras la instalación, el método está desactivado hasta que actives Enable/Disable y guardes. Si vuelves a instalar la extensión después de desinstalarla, se usan de nuevo los ajustes que conservaste.

Configuración

Todos los ajustes están en la página de la extensión: Extensions > Extensions > Shipping > VibeFox GIG Logistics > Edit. Las secciones aparecen a la izquierda. Un botón Save al final guarda toda la página sin recargarla. Cada guardado también borra los precios de GIG Logistics en caché, los tokens de API y las coordenadas de las direcciones. Solo los usuarios administradores con el permiso de modificación de esta extensión pueden guardar los ajustes.

En la parte superior de la página, y de nuevo tras cada guardado, la extensión muestra advertencias cuando no se pueden usar los precios en vivo: solo se ha introducido el nombre de usuario o la contraseña de la API, faltan el Sender phone o la ciudad y el estado de recogida, o tu moneda predeterminada no es NGN y no hay ningún Currency conversion rate definido. También avisa si tu tienda no tiene una clase de peso con la unidad kg (System > Localisation > Weight Classes); los pesos de los productos se convierten entonces según el nombre de su unidad (kg, g, lb, oz), y las demás unidades se leen como kg. Al guardar se informa de un número incorrecto (un importe negativo, un Currency conversion rate de 0, una latitud fuera del rango de -90 a 90, una longitud fuera del rango de -180 a 180), de un Min weight (kg) superior a Max weight (kg), de un Method title vacío o no válido, de un orden de clasificación que no es un número entero, o de una clase de impuesto o una zona geográfica desconocidas, y no se guarda nada.

General

El método se ofrece para la zona geográfica seleccionada en Conditions, o para los países de Ignore shipping zones. Los ajustes de esta página se aplican a todas las zonas.

Enable/Disable: muestra u oculta GIG Logistics en la finalización de compra (el estado de esta extensión). Predeterminado: desactivado.

Method title: el nombre del método de envío que se muestra en el carrito y en la finalización de compra. Predeterminado: GIG Logistics. Obligatorio, de 1 a 64 caracteres, sin los caracteres < > ; = # { }.

Tax class: la clase de impuesto del coste de envío, o No tax. Una clase 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.

Sort order: la posición del método entre los métodos de envío. Un número entero.

API de GIG Logistics (precios en vivo) (opcional)

Con credenciales de API, el precio se solicita a GIG Logistics para cada dirección nigeriana y se guarda en caché durante una hora. Sin credenciales, o cuando la API no devuelve ningún precio, se usan la tabla de precios y el coste de reserva. La sección tiene un enlace a la página para desarrolladores de GIG Logistics.

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. Solo se usa para iniciar sesión en la API y nunca se registra. Tras guardar, el campo queda vacío y muestra Saved — leave empty to keep it. To remove it, clear the API username and save. Escribe un valor nuevo solo para cambiarla.

Test mode: usa la API de pruebas (dev) de GIG Logistics. Las credenciales de prueba solo funcionan con la API de pruebas. Desactívalo para obtener precios reales. Predeterminado: 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 1 NGN en tu moneda predeterminada (1 NGN = ? de tu moneda, por ejemplo 0.0006). El tipo debe ser superior a 0. Sin él, los precios en vivo de GIG no se usan. Si tu moneda predeterminada es NGN, el campo lo indica y no hace falta.

Dirección de recogida (remitente)

Dónde recoge GIG Logistics los paquetes, en Nigeria. OpenCart no tiene una dirección de tienda estructurada, así que introduce aquí la calle y la ciudad. Cuando el país de tu tienda es Nigeria, un State vacío usa la región de la tienda de System > Settings > Store > Local.

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 vivo.

Street address: la calle de recogida, por ejemplo 1 Adeola Odeku Street.

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

State: el estado nigeriano de la dirección de recogida, elegido entre los 37 estados. La opción predeterminada, Store region (System > Settings > Store > Local), usa la región de tu tienda cuando la tienda está en Nigeria. Obligatorio para los precios en vivo.

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

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

Address lookup: busca las coordenadas en el 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 opción solo se envía el texto de la dirección, y GIG Logistics puede no devolver ningún precio. Predeterminado: activado.

Tabla de precios y reserva

Se usa para otros países, cuando los precios en vivo no están configurados o cuando GIG Logistics no da 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. Elige * Any other country para todos los países sin fila propia. Las columnas XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg y XL >5 kg son precios opcionales por tramo de peso: un precio de tramo superior a 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 o no válidas se guardan como 0, así que rellena el precio base de cada fila que añadas. Los valores corregidos se listan tras guardar, en un aviso que empieza por Country prices:. 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. Vacío significa que el método 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 vivo de GIG siempre son para el pedido completo.

Condiciones

Free shipping from: el subtotal del carrito (productos que necesitan envío, después del cupón, sin impuestos) a partir del cual el envío es gratuito. Vacío significa que nunca es gratuito.

Minimum subtotal: muestra el método solo cuando el subtotal del carrito alcanza este importe. Vacío significa siempre.

Min weight (kg): el peso mínimo del carrito en kg. Los pesos de los productos se convierten con su clase de peso. 0 significa sin límite.

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

Geo zone: ofrece el método solo para direcciones de esta zona geográfica. All zones significa sin límite. No se usa con Ignore shipping zones. Las zonas geográficas se gestionan en System > Localisation > Geo Zones.

Disponibilidad sin zonas de envío

Ignore shipping zones: ofrece el método para los países indicados a continuación, sea cual sea la zona geográfica. La Geo zone de Conditions no se comprueba entonces.

Countries: los países de destino para ese modo, elegidos entre los países activos de tu tienda. Vacío significa todos los países a los que envías. Solo se usa con Ignore shipping zones.

Avanzado

Debug log: escribe los cálculos de precios en storage/logs/vfd_gigl_debug.log.php (en OpenCart 4, system/storage/logs/vfd_gigl_debug.log.php). El archivo no se puede leer desde la web. Los errores de la API y de búsqueda de direcciones siempre se registran, incluso con el registro desactivado. No se escriben contraseñas, tokens ni direcciones de clientes. Cuando el archivo llega a 5 MB, se traslada a vfd_gigl_debug.old.log.php y se inicia un registro nuevo.

Log: muestra el tamaño y las últimas entradas del registro de depuración. Haz clic en Clear log para vaciarlo.

Remove data on uninstall: si está activado, al desinstalar la extensión se borran los ajustes y los registros. Si está desactivado, todo se conserva para una reinstalación. Los precios en caché siempre se eliminan. Los pedidos siempre se conservan.

Importar / Exportar

Exportar: haz clic en Download JSON para guardar los ajustes en un archivo JSON. La contraseña de la API no se exporta.

Importar: pega un JSON exportado previamente y haz clic en Import para restaurar los ajustes, por ejemplo en otra tienda. Los valores se comprueban igual que en un guardado normal. La contraseña de la API guardada se conserva.

Cómo funciona en la finalización de compra

Cuando OpenCart muestra los métodos de envío, pide a la extensión el precio de GIG Logistics. Si hay una Geo zone definida (y Ignore shipping zones está desactivado) y la dirección queda fuera de ella, el método no se ofrece. Solo cuentan los productos con Requires Shipping en Yes: los demás no suman peso ni se incluyen en el subtotal. El subtotal es el precio de estos productos después del descuento del cupón, sin impuestos. Los certificados de regalo, los puntos de recompensa y el crédito de la tienda no se tienen en cuenta. La extensión 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 lo ofrezca. Primero, el precio en vivo 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 hay un tipo de conversión para las tiendas cuya moneda predeterminada no es NGN. La extensión inicia sesión en la API de GIG Logistics y envía las direcciones y las coordenadas de recogida y de entrega 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 de Country prices. Tercero, el Fallback cost. Si ninguna de estas fuentes da un precio, el método se oculta para ese carrito. El precio se calcula en tu moneda predeterminada, se redondea a sus decimales y se muestra al cliente en su moneda con el impuesto de la Tax class seleccionada.

Cada respuesta de GIG se guarda en caché durante 1 hora, para que el mismo carrito no dispare 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. Las coordenadas de las direcciones se conservan 30 días, y una dirección no encontrada, 1 día. El tiempo de espera de la API es de 10 segundos, y el de búsqueda de direcciones, de 5 segundos.

Si GIG Logistics devuelve un error o un precio de 0, el cliente no ve ningún error. Se usa el precio de la tabla o el de reserva, y el error se escribe en el registro de depuración.

La extensión solo calcula precios. No crea envíos, cartas de porte ni etiquetas de GIG Logistics, no reserva recogidas, no hace seguimiento de paquetes y no permite que los clientes elijan un centro de servicio. No añade nada a los pedidos: el pedido muestra el título del método y el coste de envío como cualquier otro método de envío de OpenCart. Los precios en vivo se solicitan solo para direcciones nigerianas. Para otros países, usa la tabla de precios.

En OpenCart 4, el cliente hace clic en Choose en el bloque del método de envío de la página de finalización de compra y elige GIG Logistics en la ventana Shipping method options, donde la opción muestra el título del método y el precio, por ejemplo GIG Logistics - $4.50. El método funciona igual que en OpenCart 3.

Clave de licencia

La extensión funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox GIG Logistics es el primer bloque de Extensions > Extensions > Shipping > VibeFox GIG Logistics > Edit, por encima de los ajustes. Introduce 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 están la línea Product: opencart-shipping-gig-logistics y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los usuarios administradores con el permiso Modify de la extensión pueden cambiar la clave. Los textos del bloque siguen el idioma del administrador (se incluyen inglés y 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, la extensión sigue funcionando con el último estado conocido.

Una clave funciona en un solo dominio: la dirección de la tienda de la configuración de OpenCart. Quitar la clave de la tienda no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.

Sin una clave activa, GIG Logistics no se muestra a los clientes en la finalización de compra y no se calcula ninguna tarifa. Un usuario administrador que tenga la sesión iniciada en el administrador en el mismo navegador sigue viendo el método en la tienda, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar la extensión antes de comprar una clave. En OpenCart 4 esta vista previa no está disponible: la tienda no ve el inicio de sesión del administrador, así que sin una clave activa el método queda oculto para todos. Después de abrir la página Edit una vez, aparece un recordatorio en el Dashboard del administrador. Ciérralo con × para ocultarlo durante 7 días. Los pedidos existentes no se ven afectados.

Cuando una licencia caduca, la extensión sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente al abrir el Dashboard o la página Edit del administrador: 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 ningún cron job. Desinstalar la extensión elimina siempre 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. Revisa la Geo zone, o Ignore shipping zones y Countries, 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. Comprueba que los productos tengan Requires Shipping en Yes.

El precio procede de la tabla, no de GIG Logistics: los precios en vivo requieren 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 en Nigeria con ciudad o estado y, para las tiendas cuya moneda predeterminada no es NGN, el Currency conversion rate. Mira las advertencias en la parte superior de la página Edit. Activa el Debug log, recarga la finalización de compra y mira el campo Log de la página de la extensión para ver el motivo. Una solicitud fallida se reintenta tras 10 minutos.

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

GIG Logistics no devuelve ningún precio: GIG calcula el precio según la distancia. Mantén activado Address lookup, o introduce Pickup latitude y Pickup longitude. Confirma los precios con tu cuenta de GIG Logistics antes de activarlo en tu tienda.

El aviso de ciudad y estado de recogida sigue apareciendo: elige un estado en State y rellena City / area. La región de la tienda solo se usa cuando el país de la tienda en System > Settings > Store > Local es Nigeria.

Se cobra impuesto sobre el precio de GIG: pon Tax class 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 de la extensión. Esto borra los precios, tokens y coordenadas en caché.

La página dice "Warning: You do not have permission to modify VibeFox GIG Logistics!": es posible que el grupo de usuarios de tu administrador solo pueda ver los ajustes. Da al grupo el permiso de modificación para extension/shipping/vfd_gig_logistics (OpenCart 3) o extension/vfd_gig_logistics/shipping/vfd_gig_logistics (OpenCart 4) en System > Users > User Groups.

Para desarrolladores: la dirección de la API de GIG Logistics y la de búsqueda de direcciones pueden sustituirse con los ajustes vfd_gigl_api_base_url y vfd_gigl_geocode_url (para pruebas); no tienen campos en la página de ajustes.

Desinstalación

Ve a Extensions > Extensions, elige el tipo Shipping y haz clic en Uninstall (el botón rojo −) junto a VibeFox GIG Logistics. La clave de licencia y el estado de la licencia de esta extensión se eliminan siempre. OpenCart siempre restablece Enable/Disable, Sort order, Tax class y Geo zone. Los precios en caché, los tokens y las coordenadas se eliminan siempre. Si Remove data on uninstall está activado, los demás ajustes y el registro de depuración también se borran. Si está desactivado, se conservan y se vuelven a usar al instalar la extensión de nuevo. Los pedidos existentes conservan su método de envío y su coste.

En OpenCart 4, para eliminar también los archivos de la extensión, ve a Extensions > Installer después de la desinstalación y haz clic en Uninstall (el botón naranja −) junto a VibeFox GIG Logistics en la lista de extensiones instaladas, y luego en Delete (el botón rojo con forma de papelera) para eliminar el paquete subido.

GIG Logistics es una marca comercial de su respectivo titular. Esta extensión no está afiliada ni cuenta con el respaldo de GIG Logistics.