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

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 entrega a sus 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 prueba. Si solo usas la tabla de precios y el coste alternativo, no necesitas credenciales de API.

Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un 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_gig_logistics a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox GIG Logistics, 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. Rellena la tabla de precios, el coste alternativo o ambos. Para los precios en tiempo real, introduce también el nombre de usuario y la contraseña de la API, el teléfono del remitente, la ciudad y el estado de recogida, y la tasa de conversión de moneda si la moneda de tu tienda no es NGN (consulta Configuración).

6. Añade VibeFox GIG Logistics a una zona de envío de Nigeria 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 GIG Logistics. 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 en esta zona. Déjalo vacío para usar el Method title general.

Encima de los campos, la página muestra advertencias cuando los precios en tiempo real no se pueden usar: solo se ha introducido uno de los dos datos de la API (nombre de usuario o contraseña), falta el Sender phone o la ciudad y el estado de recogida, o la moneda de la tienda no es NGN y no se ha definido una Currency conversion rate. Cada vez que guardas los ajustes, se borran los precios y los tokens de la API guardados en caché.

General

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

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. El título de una zona lo sustituye.

Tax status: Taxable añade el impuesto de envío de tu tienda al coste; None no lo añade. Elige None si el precio de GIG ya incluye todo lo que quieres cobrar.

API de GIG Logistics (precios en tiempo real) (opcional)

Con credenciales de API, el precio se solicita a GIG Logistics para cada dirección de Nigeria. Sin credenciales, o cuando la API no devuelve un 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. Solo se usa para iniciar sesión en la API y nunca se registra.

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

Currency conversion rate: GIG Logistics devuelve los precios en NGN. Si la moneda de tu tienda no es NGN, introduce cuánto vale un NGN en la moneda de tu tienda (1 NGN = ? de tu moneda, por ejemplo 0.0006). Sin este dato, no se usan los precios en tiempo real de GIG. Si la moneda de tu tienda es NGN, este campo no es necesario. Se aceptan tanto el punto como la coma como separador decimal.

Dirección de recogida (remitente)

Dónde recoge GIG Logistics los paquetes, en Nigeria. Si tu tienda está en Nigeria, los campos de calle, ciudad y estado que dejes vacíos usan la dirección de la tienda de WooCommerce > Settings > General.

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

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. Por defecto se usa el estado de la tienda. Obligatorio para los precios en tiempo real.

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

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

Address lookup: busca las coordenadas de las direcciones en el mapa 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 un precio. Predeterminado: activado.

Tabla de precios y coste alternativo

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

Country prices: una tabla con un precio base por país. Haz clic en Add country para añadir una fila y en la X para eliminar una. Elige * Any other country para todos los países que no tengan 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 superior a 0 sustituye al precio base en 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. Los países sin fila (cuando no hay fila *) no tienen precio de tabla.

Fallback cost: se usa cuando ni GIG Logistics ni la tabla dan un precio. Si está vacío, 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 tiempo real de GIG son siempre para todo el pedido.

Condiciones

Free shipping from: el subtotal del carrito a partir del cual el envío es gratuito. Si está vacío, nunca es gratuito.

Minimum subtotal: muestra el método solo cuando el subtotal del carrito alcance este importe. Si está vacío, siempre se muestra.

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. Predeterminado: 30. 0 significa sin límite.

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

Disponibilidad sin zonas de envío

Ignore shipping zones: ofrece el método para los países indicados abajo, aunque no esté añadido a una zona. Si está desactivado, el método aparece solo en las zonas de envío a las que se haya añadido.

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

Avanzado

Debug log: registra los cálculos de precios en WooCommerce > Status > Logs, origen vfd-gig-logistics. Los errores de la API siempre se registran, aunque el registro esté desactivado. No se escriben contraseñas, tokens ni direcciones de clientes.

Remove data on uninstall: si está activado, al eliminar el plugin se borran sus ajustes, los métodos de zona y las cachés. Desactivar el plugin nunca borra nada.

Cómo funciona en la finalización de compra

Cuando el cliente introduce una dirección de entrega, WooCommerce pide al plugin un precio. Primero, el plugin comprueba las condiciones: país de entrega, peso del carrito, subtotal mínimo y clases de envío excluidas. Si el subtotal alcanza Free shipping from, el método se muestra con precio 0, pero solo si el país tiene precio: una fila en Country prices, un Fallback cost o un precio en tiempo real de GIG Logistics. GIG Logistics solo se consulta cuando la tabla y el coste alternativo no dan precio.

Después, el precio se toma de la primera fuente que lo dé. Primero, el precio en tiempo real de GIG Logistics, si hay credenciales de API introducidas, la dirección está en Nigeria, el cliente ha introducido una ciudad o un estado, el teléfono, la ciudad y el estado de recogida están definidos, y hay una tasa de conversión para las tiendas que no usan NGN. El plugin inicia sesión en la API de GIG Logistics y envía las direcciones y 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 el servicio de entrega bike. Segundo, la tabla Country prices. Tercero, el Fallback cost. Si ninguno da un precio, el método se oculta para ese carrito.

Cada respuesta de GIG se guarda en caché durante 1 hora, para que el mismo carrito no genere 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 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.

El método funciona en la finalización de compra clásica y en los bloques de Carrito y Finalizar compra. Es compatible con el almacenamiento de pedidos de alto rendimiento de WooCommerce (HPOS).

El plugin 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 que los clientes elijan 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 solo se solicitan para direcciones de Nigeria. Para otros países, usa la tabla de precios.

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 GIG Logistics. 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 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, GIG Logistics no se muestra a los clientes en la finalización de compra. Los gestores de la tienda que han iniciado sesión 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 aviso 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 requieren una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.

Solución de problemas

GIG Logistics 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 los límites de peso, Minimum subtotal y Excluded shipping classes. Comprueba que la tabla (el país o *) o el Fallback cost den un precio para el país.

El precio viene de la tabla, no de GIG Logistics: los precios en tiempo real 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 tiendas que no usan NGN, la Currency conversion rate. Mira las advertencias en la parte superior de la página de ajustes. Activa el Debug log, recarga la finalización de compra y abre WooCommerce > Status > Logs, origen vfd-gig-logistics, para ver el motivo. Una solicitud fallida se reintenta después de 10 minutos.

Login failed in the log: 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 un precio: GIG calcula los precios según la distancia. Mantén Address lookup activado, o introduce Pickup latitude y Pickup longitude. Confirma los precios con tu cuenta de GIG Logistics antes de activarlo en real.

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

Los precios parecen desactualizados tras un cambio: guarda la página de ajustes. Así se borran los precios y los tokens guardados en caché.

Geocodificador propio: los desarrolladores pueden proporcionar su propia búsqueda de direcciones con el filtro vfd_gigl_pre_geocode.

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 datos. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin siempre se eliminan. Los ajustes, los métodos de zona, los precios en caché, los tokens y las búsquedas de direcciones solo se eliminan si Remove data on uninstall estaba activado. Si no, se conservan para una futura reinstalación. Los pedidos existentes conservan sus líneas de envío.

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