VibeFox Bob Go 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.

Cuenta de Bob Go (solo para tarifas en tiempo real): Bob Go no usa claves de API. Necesitas una cuenta de Bob Go (bobgo.co.za), tu tienda instalada como canal de venta de WooCommerce en tu cuenta de Bob Go (Sales channels) y "Rates at checkout" activado para ese canal. Los servicios, los precios y las reglas se configuran en Bob Go. 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

El paquete de 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_bob_go-oc3-(version).ocmod.zip y el paquete de OpenCart 4 vfd_bob_go.ocmod.zip. Instala solo el paquete de tu versión de OpenCart. La clave de licencia es la misma para ambas versiones.

OpenCart 3

1. En el administrador ve a Extensions > Installer, haz clic en Upload y elige el archivo vfd_bob_go-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 del paquete en la carpeta raíz de tu tienda.

2. Ve a Extensions > Extensions, elige el tipo de extensión Shipping. Busca VibeFox Bob Go 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 configuración.

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 (ver Clave de licencia).

5. En tu cuenta de Bob Go, instala tu tienda como canal de venta. Activa "Rates at checkout" para ese canal y configura tus servicios y precios.

6. En la página Edit 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). Activa Enable Bob Go y haz clic en Save.

OpenCart 4

1. En el administrador ve a Extensions > Installer, haz clic en Upload y elige el archivo vfd_bob_go.ocmod.zip. No cambies el nombre del archivo: OpenCart 4 toma el código de la extensión 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 Shipping. Busca VibeFox Bob Go, haz clic en Install (el botón verde +) y después en Edit (el botón del lápiz).

4. Configura Bob Go, introduce la clave de licencia y los ajustes como en los pasos 4 a 6 de OpenCart 3. La página de configuración y sus campos son los mismos en ambas versiones.

Después de la instalación, el método está desactivado hasta que actives Enable Bob Go y guardes. De forma predeterminada usa las tarifas en tiempo real de Bob Go. Si vuelves a instalar la extensión tras desinstalarla, se usan de nuevo los ajustes de Bob Go que conservaste.

Configuración

Todos los ajustes están en la página de la extensión: Extensions > Extensions > Shipping > VibeFox Bob Go > Edit. Las secciones aparecen a la izquierda. Un único botón Save guarda toda la página sin recargarla. Cada guardado también borra las tarifas de Bob Go en caché. Los números admiten un punto o una coma como separador decimal. Si un valor es incorrecto, no se guarda nada y la página muestra el motivo: un Method title vacío o de más de 64 caracteres, un valor que no es un número ("…" must be a number.), un importe o un peso negativo ("…" must be a number of 0 or more.), un ZAR conversion rate de 0 o menos, un Minimum weight (kg) mayor que el Maximum weight (kg), o una clase de impuesto o zona geográfica desconocida. Solo los usuarios del administrador con permiso de modificación para esta extensión pueden guardar la configuración.

Sobre los ajustes, la página avisa cuando las tarifas en tiempo real no pueden funcionar: Live rates are not requested: your store currency is … — set the "ZAR conversion rate"., cuando Sudáfrica no tiene zonas (provincias) en tu tienda, o cuando la tienda no tiene una clase de peso con la unidad "kg" o una clase de longitud con la unidad "cm". En este último caso, los pesos y las dimensiones se convierten según el nombre de la unidad de su clase (kg, g, lb, oz; cm, mm, m, in), y el resto de unidades se leen como kg o cm.

General

Los ajustes se aplican a todas las zonas geográficas. En la finalización de compra, cada servicio de Bob Go es una opción de entrega independiente bajo el título del método.

Enable Bob Go: muestra u oculta Bob Go en la finalización de compra. Predeterminado: desactivado.

Method title: el nombre del método de envío que ve el cliente. Los servicios de Bob Go, por ejemplo "The Courier Guy - Economy", aparecen debajo con los nombres de Bob Go. Predeterminado: Bob Go. Obligatorio, de 64 caracteres como máximo.

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.

Sort order: la posición de Bob Go entre los métodos de envío en la finalización de compra. Un número entero.

Cuenta de Bob Go

Esta sección explica lo que necesitas en Bob Go, con enlaces a tu cuenta de Bob Go, a Sales channels y a Rates at checkout. Tambié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 o 403), o request failed con el código de error o no connection.

Store domain: Bob Go identifica tu tienda por su dominio. Déjalo vacío para usar el dominio de tu tienda, que aparece en la descripción del campo. Introduce otro dominio solo si tu canal en Bob Go está instalado con una dirección diferente, por ejemplo example.co.za/shop para una tienda en una subcarpeta. El esquema y la barra final se eliminan.

ZAR conversion rate: Bob Go cotiza en rands sudafricanos (ZAR). Si la moneda predeterminada de tu tienda no es ZAR, introduce cuántos ZAR equivale 1 unidad de tu moneda, por ejemplo 0.05. Las tarifas se convierten con este valor y los precios de los productos se envían a Bob Go en ZAR. Déjalo vacío para no usar las tarifas en tiempo real de Bob Go en tu moneda (los precios fijos siguen funcionando). El valor debe ser mayor que 0. Si la moneda de tu tienda es ZAR, déjalo vacío.

Delivery dates: muestra el intervalo de fechas de entrega estimado que devuelve Bob Go junto a cada servicio en la finalización de compra. La estimación siempre se guarda con el pedido y es visible en la página 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. La dirección de la tienda en OpenCart es texto libre, así que solo se usan el país y la región de tu tienda (System > Settings > Store > Local): si el país de la tienda es el país de origen, una provincia vacía se toma de la región de la tienda. Introduce aquí la ciudad, el código postal y la calle.

Origin country: el país desde el que envías. Predeterminado: South Africa. Bob Go envía solo dentro de Sudáfrica.

Origin province: una provincia sudafricana, o Store region (if in South Africa).

Origin city / suburb: la ciudad o el barrio desde el que envías, por ejemplo Johannesburg.

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, por ejemplo 123 Main Street.

Precios fijos (se usan cuando Shipping cost es Fixed prices (below), 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 predeterminada de tu tienda, sin impuestos, por ejemplo ZA=99.99. Usa * para todos los demás países, por ejemplo *=199.99 en la línea siguiente. Las líneas con otro formato se eliminan al guardar, y la página las muestra en un aviso.

Flat price: el precio para los países sin una línea anterior. Déjalo vacío para ocultar el método en esos países.

Fixed price applies: Per order (predeterminado) 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 el envío completo.

Condiciones

Minimum weight (kg): oculta el método por debajo de este peso del carrito. 0 significa sin límite (predeterminado).

Maximum weight (kg): oculta el método por encima de este peso del carrito. 0 significa sin límite (predeterminado).

Minimum order amount: muestra el método solo cuando el subtotal de los productos que necesitan envío (después del cupón, antes de impuestos) es al menos este importe. Déjalo vacío para mostrarlo siempre.

Free shipping: activa el envío gratuito cuando se alcanza el importe del pedido indicado abajo.

Free shipping from: el subtotal de los productos que necesitan envío (después del cupón, antes de impuestos) a partir del cual el envío es gratuito. Solo se usa cuando Free shipping está activado. En ese caso no se pide ninguna tarifa a Bob Go.

Tax class: la clase de impuesto del coste de envío, o No tax (predeterminado). Las tarifas de Bob Go normalmente ya incluyen el IVA. En ese caso deja No tax para no cobrar el impuesto del envío dos veces.

Geo zone: ofrece Bob Go solo para direcciones de esta zona geográfica. All zones (predeterminado) significa sin límite. No se usa cuando Ignore shipping zones está activado. Las zonas geográficas se gestionan en System > Localisation > Geo Zones.

Disponibilidad sin zonas de envío

Ignore shipping zones: cuando está activado, no se comprueba la zona geográfica y el método se ofrece para los países de abajo.

Countries: los países de destino para ese modo. Déjalo vacío para permitir todos los países. Solo se usa cuando Ignore shipping zones está activado.

Avanzado

Debug log: escribe los cálculos de tarifas y las solicitudes a Bob Go en storage/logs/vfd_bobg_debug.log.php. El archivo no se puede leer desde la web. Las direcciones de los clientes no se registran. Los errores de Bob Go se registran aunque esta opción esté desactivada. Desactiva el registro cuando termines. Cuando el archivo llega a 5 MB, se mueve a vfd_bobg_debug.old.log.php y se inicia un registro nuevo.

Log: muestra el tamaño y las entradas más recientes del registro. Haz clic en Clear log para vaciarlo.

Remove data on uninstall: cuando está activado, al desinstalar la extensión se borran los ajustes de Bob Go, las tarifas en caché y los registros. El servicio de Bob Go guardado con los pedidos se conserva. Cuando está desactivado (predeterminado), se conserva todo para una nueva instalación.

Importar / Exportar

Export: haz clic en Download JSON para guardar la configuración como archivo JSON.

Import: pega un JSON exportado anteriormente y haz clic en Import para restaurar la configuración, por ejemplo en otra tienda. Los valores se comprueban igual que en un guardado normal.

Cómo funciona en la finalización de compra

Cuando OpenCart muestra los métodos de envío, pide a la extensión las tarifas de Bob Go. Si hay una Geo zone definida (y Ignore shipping zones está desactivado) y la dirección queda fuera de ella, Bob Go no se ofrece. Solo cuentan los productos con Requires Shipping en Yes: los demás productos no suman peso ni se incluyen en el importe del pedido. Después, la extensión comprueba el país de destino (con Ignore shipping zones), el peso del carrito y el Minimum order amount. El importe del pedido es el precio de los productos que necesitan envío, después del descuento del cupón y antes de impuestos. Los certificados de regalo, los puntos de recompensa y el crédito de la tienda no se tienen en cuenta. Si se aplica el envío gratuito, el cliente ve Bob Go (free) (el título de tu método) y no se envía ninguna solicitud a Bob Go.

En los modos con tarifas en tiempo real, la extensión envía a Bob Go el dominio de tu tienda, las direcciones de origen y de entrega (con la provincia) y los artículos del carrito: precios de los productos en ZAR, pesos y dimensiones, y el modelo del producto como SKU. En las direcciones sudafricanas, la zona de OpenCart se envía como código de provincia (EC, FS, GP, KZN, LP, MP, NC, NW, WC). Las tarifas en tiempo real se piden solo después de que el cliente introduzca una ciudad o un código postal. Las tarifas en ZAR se convierten con el ZAR conversion rate cuando la moneda de tu tienda no es ZAR. 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.

Bajo el título del método, el cliente ve una opción por cada servicio de Bob Go, con su nombre, su precio y, si Delivery dates está activado, las fechas de entrega estimadas entre paréntesis. El cliente elige un servicio como cualquier otra opción de envío de OpenCart. Con un precio fijo hay una sola opción con el título del método.

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 un servicio de Bob Go en la ventana Shipping method options, por ejemplo SkyNet - Overnight (by 17/10/2026) con su precio. El método funciona igual que en OpenCart 3.

Las tarifas se guardan en caché durante 1 hora por solicitud completa, así que el mismo carrito no genera una solicitud nueva. 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 alternativo, se usa el precio fijo. El motivo se escribe en el registro.

La extensión 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. Para la gestión del envío usa el panel de Bob Go. No tiene selección de punto de recogida ni de taquilla. Bob Go solo envía dentro de Sudáfrica.

Pedidos

El nombre del servicio elegido es el método de envío del pedido, así que aparece en los correos electrónicos del pedido, en Sales > Orders y en la cuenta del cliente. Cuando se realiza el pedido, el servicio de Bob Go, su código y la estimación de entrega también se guardan con el pedido. Los cambios posteriores en el carrito o en los precios de Bob Go no los modifican. En OpenCart 4 la finalización de compra mantiene un solo pedido: si el cliente vuelve atrás y confirma el pedido de nuevo con otro servicio de Bob Go, se actualiza el servicio guardado, y si elige otro método de envío o un precio fijo, se elimina.

En el administrador, la página del pedido en Sales > Orders muestra un bloque Bob Go con Bob Go service (nombre y código) y Estimated delivery. El cliente ve Bob Go service y Estimated delivery en la página de detalles del pedido de su cuenta. Los pedidos con precio fijo o con envío gratuito no tienen servicio de Bob Go.

Clave de licencia

La extensión funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Bob Go es el primer bloque de Extensions > Extensions > Shipping > VibeFox Bob Go > 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 eliminar la clave de esta tienda. Debajo aparecen la línea Product: opencart-shipping-bob-go y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los usuarios del administrador con permiso de modificación para 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 después de liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si el servidor de licencias no está disponible, 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. Eliminar la clave de la tienda no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.

Sin una clave activa, Bob Go no se muestra a los clientes en la finalización de compra y no se calcula ninguna tarifa. Un usuario del administrador que haya iniciado sesión 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 se oculta a todos. Después de abrir una vez la página Edit, 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 necesitan una renovación. El estado se vuelve a comprobar automáticamente cuando abres el Dashboard o la página Edit del administrador: una vez al día durante los primeros 14 días después de introducir la clave, y después una vez por semana. No se necesita ninguna tarea cron. Al desinstalar la extensión siempre se eliminan la clave de licencia y el estado de la licencia.

Solución de problemas

Bob Go no aparece en la finalización de compra: comprueba que la licencia está activa y que Enable Bob Go está activado. Revisa la Geo zone, o activa Ignore shipping zones y revisa Countries. Revisa los límites de peso y el Minimum order amount. En el modo de precio fijo, comprueba que el país, * o el Flat price tienen un precio. Comprueba que los productos tienen Requires Shipping en Yes.

No se muestran tarifas de Bob Go: abre la página de la extensión. La sección Bob Go account muestra la última respuesta de Bob Go. "The WooCommerce channel is not installed on Bob Go" (HTTP 404) significa que el dominio de la tienda no es un canal de venta en Bob Go: revisa el 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 ha introducido una ciudad o un código postal y, en tiendas que no usan ZAR, de que el ZAR conversion rate está definido. Activa el Debug log, recarga la finalización de compra y mira el campo Log. 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 rands: Bob Go cotiza en ZAR. Introduce cuántos ZAR equivale 1 unidad de la moneda de tu tienda. Sin este valor, la extensión no pide tarifas a Bob Go. Los precios fijos siguen funcionando.

La página avisa de que Sudáfrica no tiene zonas: añade las provincias de Sudáfrica en System > Localisation > Zones; si no, Bob Go no recibe la provincia de las direcciones sudafricanas.

El impuesto se cobra dos veces en el envío: las tarifas de Bob Go normalmente incluyen el IVA. Pon Tax class en No tax.

Las tarifas parecen desactualizadas tras un cambio: haz clic en Save en la página de la extensión. Así se borran las tarifas de Bob Go en caché. Los cambios en tu cuenta de Bob Go se aplican tras la caché de 1 hora o al guardar la configuración.

La página dice "Warning: You do not have permission to modify VibeFox Bob Go!": tu grupo de usuarios del administrador solo puede ver la configuración. Da al grupo el permiso de modificación para extension/shipping/vfd_bob_go (OpenCart 3) o extension/vfd_bob_go/shipping/vfd_bob_go (OpenCart 4) en System > Users > User Groups.

Para desarrolladores: la dirección de la API de Bob Go se puede cambiar con el ajuste vfd_bobg_api_url (para pruebas); no tiene campo en la página de configuración.

Desinstalación

Ve a Extensions > Extensions, elige el tipo Shipping y haz clic en Uninstall (el botón rojo −) junto a VibeFox Bob Go. La clave de licencia y el estado de licencia de esta extensión siempre se eliminan. OpenCart siempre restablece Enable Bob Go, Sort order, Tax class y Geo zone. Las tarifas en caché siempre se eliminan. Si Remove data on uninstall está activado, los ajustes de Bob Go y el registro también se borran. Si está desactivado, los demás ajustes se conservan y se usan de nuevo al volver a instalar la extensión. El servicio de Bob Go guardado con los pedidos siempre se conserva, y los pedidos existentes mantienen 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 Bob Go en la lista de extensiones instaladas; después haz clic en Delete (el botón rojo de papelera) para eliminar el paquete subido.

Bob Go es una marca comercial de su respectivo propietario. Esta extensión no está afiliada ni respaldada por Bob Go.