VibeFox Bob Go 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 Bob Go (solo para tarifas en tiempo real): Bob Go no tiene claves de API. Necesitas una cuenta de Bob Go (bobgo.co.za), tu tienda de WooCommerce instalada como canal de venta en tu cuenta de Bob Go (Sales channels) y "Rates at checkout" activado para ese canal, con tus servicios y precios configurados allí. Si solo usas precios fijos, no necesitas una cuenta de Bob Go.
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_bob_go a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. En tu cuenta de Bob Go, instala tu tienda de WooCommerce como canal de venta. Activa "Rates at checkout" para ese canal y configura tus servicios y precios.
4. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox Bob Go, o haz clic en Settings debajo del nombre del plugin en la página Plugins.
5. 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.
6. Comprueba el dominio de la tienda, la dirección de origen (desde donde envías) y, si la moneda de tu tienda no es ZAR, el tipo de cambio a ZAR (ver Configuración).
7. Añade VibeFox Bob Go a una zona de envío para Sudáfrica en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore shipping zones.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox Bob Go. Se aplican a todas las zonas de envío. Cada vez que guardas los ajustes, se borran las tarifas de Bob Go guardadas en caché. Cuando añades el método a una zona, la ventana de la zona tiene un solo campo:
Title (zone): el nombre que se muestra para los precios fijos y el envío gratis en esta zona. Déjalo vacío para usar el Method title global. Las tarifas en tiempo real de Bob Go siempre se muestran con los nombres de servicio configurados en Bob Go.
General
Enable/Disable: activa o desactiva el método en todas las zonas a la vez.
Method title: se muestra al cliente para los precios fijos y el envío gratis. Una zona puede reemplazarlo. Las tarifas en tiempo real de Bob Go se muestran con los nombres de servicio de Bob Go, por ejemplo "The Courier Guy - Economy". Predeterminado: Bob Go.
Shipping cost: cómo se calcula el precio.
El motivo de la falta de tarifas en tiempo real se escribe en el registro. Nunca se muestra al cliente.
Cuenta de Bob Go
Esta sección muestra la última respuesta de Bob Go para el dominio de tu tienda: connected, the WooCommerce channel is not installed on Bob Go (HTTP 404), "Rates at checkout" is not enabled for this channel (HTTP 401) u otro error. Si la moneda de tu tienda no es ZAR y no hay ningún tipo de cambio configurado, también avisa de que no se solicitan tarifas en tiempo real.
Store domain: Bob Go identifica tu tienda por su dominio. Déjalo vacío para usar el dominio de tu sitio. Introduce otro dominio solo si tu canal en Bob Go está instalado con una dirección distinta, por ejemplo example.co.za/shop para una tienda en una subcarpeta.
ZAR conversion rate: Bob Go cotiza en rand sudafricano (ZAR). Si la moneda de tu tienda no es ZAR, introduce cuánto vale 1 ZAR en la moneda de tu tienda, por ejemplo 0.05 para EUR. Con este valor se convierten las tarifas, y los precios de los productos se envían a Bob Go en ZAR. Déjalo vacío para no usar tarifas en tiempo real de Bob Go en tu moneda (los precios fijos siguen funcionando). Si la moneda de tu tienda es ZAR, déjalo vacío. Se aceptan tanto el punto como la coma como separador decimal.
Delivery dates: muestra en el nombre de la tarifa el rango de fechas estimado de entrega que devuelve Bob Go. La estimación siempre se guarda con el pedido y es visible en la pantalla del pedido.
Envío desde (dirección de origen)
La dirección de origen se envía a Bob Go con cada solicitud de tarifas. Si la dirección de tu tienda en WooCommerce > Settings > General está en el mismo país, los campos vacíos se toman de ella.
Origin country: el país desde el que envías. Predeterminado: Sudáfrica. Bob Go envía solo dentro de Sudáfrica.
Origin province: una provincia sudafricana, o Store province (if in South Africa).
Origin city / suburb: la ciudad o el barrio desde el que envías, por ejemplo Johannesburgo.
Origin postal code: el código postal desde el que envías, por ejemplo 2001.
Origin street address: la dirección de la calle desde la que envías.
Precios fijos (se usan en el modo fijo y como alternativa cuando Bob Go no devuelve tarifas)
Price per country: una línea por país: un código de país de 2 letras, un signo igual y el precio en la moneda de tu tienda, por ejemplo ZA=99.99. Usa * para todos los demás países, por ejemplo *=199.99. Las líneas con otro formato se eliminan al guardar.
Flat price: el precio en la moneda de tu tienda para los países sin una línea de arriba. Déjalo vacío para ocultar el método en esos países.
Fixed price applies: Per order cobra el precio una sola vez. Per item (price × quantity) lo multiplica por el número de artículos del carrito. Las tarifas en tiempo real de Bob Go siempre son para todo el envío.
Condiciones
Minimum weight (kg): oculta el método si el peso del carrito es inferior a este valor. 0 significa sin límite.
Maximum weight (kg): oculta el método si el peso del carrito supera este valor. 0 significa sin límite (predeterminado).
Minimum order amount: muestra el método solo cuando el subtotal del carrito (después de descuentos y antes de impuestos) sea al menos este importe. Déjalo vacío para mostrarlo siempre.
Excluded shipping classes: oculta el método si el carrito contiene un producto de alguna de estas clases de envío de WooCommerce.
Free shipping: activa el envío gratis cuando se alcance el importe del pedido indicado abajo.
Free shipping from: el subtotal del carrito (después de descuentos y antes de impuestos) a partir del cual el envío es gratis. Solo se usa si Free shipping está activado. En ese caso no se solicitan tarifas a Bob Go.
Tax status: Taxable añade el impuesto de WooCommerce al coste de envío; None no lo añade. Las tarifas de Bob Go suelen incluir ya el IVA. En ese caso elige None para no cobrar el impuesto dos veces.
Disponibilidad sin zonas de envío
Ignore shipping zones: ofrece Bob Go para los países indicados abajo aunque no esté añadido a una 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. Solo se usa cuando Ignore shipping zones está activado.
Avanzado
Debug log: registra los cálculos de tarifas y las solicitudes a Bob Go en WooCommerce > Status > Logs, origen "vfd_bob_go". Las direcciones de los clientes no se registran. Los errores de la API se registran aunque esto esté desactivado.
Remove data on uninstall: si está activado, al eliminar el plugin se borran todos los ajustes de Bob Go, los métodos de zona y las tarifas en caché. Desactivar el plugin nunca borra nada.
Cómo funciona en la finalización de compra
Cuando el cliente introduce una dirección de entrega, el plugin comprueba el peso del carrito, Minimum order amount y Excluded shipping classes. Si se aplica el envío gratis, el cliente ve el método como Bob Go (free) y no se envía ninguna solicitud a Bob Go.
En los modos en tiempo real, el plugin envía a Bob Go el dominio de tu tienda, las direcciones de origen y de entrega y los artículos del carrito, con los precios de los productos en ZAR. Las tarifas en tiempo real solo se solicitan después de que el cliente haya introducido una ciudad o un código postal. Cada servicio que devuelve Bob Go se muestra como una opción de envío independiente con su nombre de Bob Go y, si Delivery dates está activado, con las fechas estimadas de entrega. Las tarifas en ZAR se convierten con el ZAR conversion rate cuando la moneda de tu tienda no es ZAR.
Las tarifas se guardan en caché durante 1 hora por carrito y dirección, así que el mismo carrito no provoca una nueva solicitud. Una solicitud fallida se guarda en caché durante 5 minutos, y el tiempo de espera es de 12 segundos, para que una caída de Bob Go no ralentice cada actualización de la finalización de compra. Una solicitud fallida nunca interrumpe la finalización de compra: el método se oculta o, en el modo con alternativa, se usa el precio fijo. El motivo se registra en el registro de WooCommerce.
El código del servicio de Bob Go elegido y la estimación de entrega se guardan con la línea de envío del pedido y se muestran en la pantalla del pedido como Bob Go service y Estimated delivery.
El método funciona en la finalización de compra clásica y en los bloques de Carrito y de Finalizar compra. Es compatible con WooCommerce High-Performance Order Storage (HPOS).
El plugin solo muestra tarifas. No crea envíos, guías de transporte ni etiquetas, no hace seguimiento de paquetes, no sincroniza pedidos con Bob Go ni envía notificaciones por correo electrónico. Para gestionar los envíos, usa el panel de Bob Go (o la sincronización de pedidos propia de Bob Go). No ofrece selección de punto de recogida ni de taquilla (Bob Box, Pargo) ni un campo adicional de barrio en la finalización de compra. Bob Go envía solo dentro de Sudáfrica.
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 Bob Go. 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, Bob Go no se muestra a los clientes en la finalización de compra. Los gestores de la tienda que han iniciado sesión siguen viéndolo, 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 requieren una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
Bob Go 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 order amount y Excluded shipping classes. En el modo fijo, comprueba que el país, * o Flat price tenga un precio.
No se muestran tarifas de Bob Go: abre los ajustes del plugin. La sección Bob Go account muestra la última respuesta de Bob Go. "Channel is not installed" (HTTP 404) significa que el dominio de la tienda no es un canal de venta en Bob Go: revisa Store domain. "Rates at checkout is not enabled" (HTTP 401) significa que la función está desactivada para el canal. Asegúrate también de que el cliente haya introducido una ciudad o un código postal y, en tiendas que no usan ZAR, de que ZAR conversion rate esté configurado. Activa Debug log y abre WooCommerce > Status > Logs (origen "vfd_bob_go") para ver los detalles. Con Bob Go live rates, fixed prices if Bob Go returns no rates, los clientes siguen recibiendo el precio fijo mientras corriges el problema.
Mi tienda no usa rand: Bob Go cotiza en ZAR. Introduce cuánto vale 1 ZAR en la moneda de tu tienda (por ejemplo 0.05 para EUR). Sin ese dato, el plugin no solicita tarifas a Bob Go. Los precios fijos siguen funcionando.
Se cobra el impuesto dos veces en el envío: las tarifas de Bob Go suelen incluir el IVA. Configura Tax status en None.
Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Así se borran las tarifas de Bob Go guardadas en caché. Los cambios en tu cuenta de Bob Go se aplican al terminar la caché de 1 hora o cuando guardas los ajustes.
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 y las tarifas en caché solo se eliminan 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.
Bob Go es una marca comercial de su respectivo titular. Este plugin no está afiliado a Bob Go ni cuenta con su respaldo.