VibeFox Bob Go 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.
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 ventas de WooCommerce en tu cuenta de Bob Go (Sales channels) y "Rates at checkout" activado para ese canal. Los servicios, precios y 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 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 carga, haz clic en Configure, o busca VibeFox Bob Go más tarde en la lista de módulos y haz clic en Configure.
3. Introduce 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 (ver Clave de licencia).
4. 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.
5. En la página Configure, revisa 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). Si las direcciones sudafricanas de tu tienda no tienen provincia, haz clic en Add South African provinces. Haz clic en Save.
Al instalar, el módulo crea el transportista Bob Go con el texto de plazo de entrega Courier delivery (South Africa). El transportista está activo, asignado a todas las zonas y a todos los grupos de clientes, y usa por defecto las tarifas en tiempo real de Bob Go. Puedes cambiar las zonas, los grupos de clientes, el plazo de entrega, el logotipo y los límites de tamaño en Shipping > Carriers. No configures precios allí: el precio siempre lo proporciona el módulo.
Configuración
Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox Bob Go > Configure. Se aplican a todas las zonas del transportista. Cada sección tiene su propio botón Save, que guarda toda la página. Cada guardado también borra las tarifas de Bob Go en caché. Los números admiten punto o coma como separador decimal. Si un valor es incorrecto, la página muestra un error y no se guarda nada: un valor que no es un número ("…" must be a number.), un importe o peso negativo ("…" must be a number of 0 or more.), un ZAR conversion rate de 0 o menos, un Minimum weight mayor que el Maximum weight, o un Method title de más de 64 caracteres.
Encima del formulario, 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 las direcciones sudafricanas no tienen provincia (ver Provincias de Sudáfrica más abajo), o cuando la unidad de peso o de dimensiones de la tienda no se reconoce y se trata como kg o cm. Configura las unidades en International > Localization (Local units).
General
Enable Bob Go: activa o desactiva el transportista. Es el mismo interruptor que el estado del transportista en Shipping > Carriers.
Method title: el nombre del transportista que ve el cliente. Los servicios de Bob Go, por ejemplo "The Courier Guy - Economy", aparecen bajo él en la finalización de compra con los nombres de Bob Go. Por defecto: Bob Go. Obligatorio, máximo 64 caracteres.
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 explica lo que necesitas en Bob Go y 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 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 como texto de ejemplo en el campo. Escribe otro dominio solo si tu canal en Bob Go está instalado con otra dirección, 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 rand sudafricano (ZAR). Si la moneda predeterminada de tu tienda no es ZAR, escribe cuánto vale 1 ZAR en 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 rango de fechas de entrega estimado por Bob Go junto a cada servicio en la finalización de compra. La estimación siempre se guarda con el pedido y se ve 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. Si la dirección de la tienda en Shop Parameters > Contact > Stores está en el mismo país, los campos vacíos se rellenan con ella.
Origin country: el país desde el que envías. Por defecto: Sudáfrica. Bob Go envía solo dentro de Sudáfrica.
Origin province: una provincia de Sudáfrica, 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.
Provincias de Sudáfrica: PrestaShop no tiene provincias para Sudáfrica, así que las direcciones de los clientes allí no tienen provincia, mientras que Bob Go la necesita. Haz clic en Add South African provinces para añadir las 9 provincias (códigos EC, FS, GP, KZN, LP, MP, NC, NW, WC) como estados de Sudáfrica y mostrar el campo de estado en las direcciones sudafricanas. Las provincias que ya existen, por código o por nombre, no se vuelven a añadir. No cambia nada hasta que hagas clic en el botón. Cuando las provincias estén configuradas, el campo muestra South African addresses have a province con su número.
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 enumera en un aviso.
Flat price: el precio para los países que no tienen línea arriba. Déjalo vacío para ocultar el transportista 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 el envío completo.
Condiciones
Minimum weight: oculta el transportista por debajo de este peso del carrito, en kg. 0 significa sin límite (por defecto).
Maximum weight: oculta el transportista por encima de este peso del carrito, en kg. 0 significa sin límite (por defecto). Si se configuran ambos límites, el mínimo no puede ser mayor que el máximo.
Minimum order amount: muestra el transportista solo cuando el subtotal del carrito (productos que requieren envío, después de descuentos, antes de impuestos) es al menos este importe. Déjalo vacío para mostrarlo siempre.
Free shipping: activa el envío gratis cuando se alcanza el importe del pedido indicado abajo.
Free shipping from: el subtotal del carrito (después de descuentos, antes de impuestos) a partir del cual el envío es gratis. Solo se usa cuando Free shipping está activado. En ese caso no se piden tarifas a Bob Go.
Tax: la regla de impuesto del transportista, o No tax (por defecto). Las tarifas de Bob Go suelen incluir ya el IVA. En ese caso, deja No tax para no cobrar el impuesto dos veces.
Disponibilidad sin zonas de envío
Ignore shipping zones: cuando está activado, el transportista se vincula a todas las zonas, incluidas las creadas más adelante, y se ofrece para los países indicados abajo. Cuando está desactivado, se ofrece solo en las zonas del transportista en Shipping > Carriers, y se le devuelven las zonas que tenía antes.
Countries: los países de destino para ese modo. Déjalo vacío para permitir 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 logs/vfd_bobg_debug.log.php, dentro de la carpeta del módulo. El archivo no se puede abrir desde la web. Las direcciones de los clientes no se registran. Los errores de Bob Go se registran aunque esta opción esté desactivada. Desactívala cuando termines.
Log: muestra el tamaño y las últimas entradas del registro. Haz clic en Clear log para vaciarlo.
Remove data on uninstall: cuando está activado, al desinstalar el módulo se eliminan los ajustes de Bob Go, el transportista, las tarifas en caché y los registros. El servicio de Bob Go guardado con los pedidos se conserva. Cuando está desactivado, se conserva todo para una reinstalación.
Cómo funciona en la finalización de compra
En el paso de envío, PrestaShop pide al módulo el precio de Bob Go. Solo cuentan los productos físicos: los productos virtuales no añaden peso ni se incluyen en el importe del pedido. El módulo comprueba primero el país de destino (con Ignore shipping zones), el peso del carrito y el Minimum order amount. Si se aplica el envío gratis, el transportista se muestra como gratuito y no se envía ninguna solicitud a Bob Go.
En los modos con tarifas en tiempo real, el módulo 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, con los precios de los productos en ZAR. Las tarifas en tiempo real se piden solo después de que el cliente haya introducido 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 y luego se muestra en la moneda del carrito del cliente.
Bajo el transportista de Bob Go, el cliente ve Choose a delivery service: y una opción por cada servicio de Bob Go, con su nombre, su precio y, si Delivery dates está activado, las fechas estimadas de entrega. El primer servicio se selecciona por defecto. Cuando el cliente elige otro servicio, la elección se guarda de inmediato y se actualizan el precio del transportista y el total del carrito. El transportista cuesta lo que cuesta el servicio elegido. Si un servicio ya no se ofrece para la dirección, el cliente ve This service is not available for your address any more. Please choose another one. Si el guardado falla, el mensaje es The service could not be saved. Please try again. La lista de servicios funciona con los temas Classic y Hummingbird.
Las tarifas se guardan en caché durante 1 hora por cada solicitud completa, 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, de modo que una caída de Bob Go no ralentiza cada actualización de la finalización de compra. Una solicitud fallida nunca interrumpe la finalización de compra: el transportista se oculta o, en el modo alternativo, se usa el precio fijo. El motivo se escribe en el registro.
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 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. Usa el panel de Bob Go para la gestión del envío. No tiene selección de punto de recogida ni de taquilla. Bob Go envía solo dentro de Sudáfrica.
Pedidos
Cuando se realiza el pedido, el servicio de Bob Go elegido, su código y la estimación de entrega se guardan con el pedido. Los cambios posteriores en el carrito o en los precios de Bob Go no los modifican.
En el back office, la página del pedido 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 gratis no tienen servicio de Bob Go.
Clave de licencia
El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Bob Go es el primer bloque de Modules > Module Manager > VibeFox Bob Go > Configure, por encima de los ajustes. Introduce la clave en License key y haz clic en Activate. Después, el bloque muestra la clave oculta, 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-bob-go 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 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 con 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 no se puede contactar con el servidor de licencias, el módulo sigue funcionando con el último estado conocido.
Una clave funciona en 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. Libérala en tu cuenta de vibefox.net.
Sin una clave activa, el transportista de Bob Go no se muestra a los clientes en la finalización de compra y no se calcula ninguna tarifa. La parte pública de PrestaShop no sabe que has iniciado sesión en el back office, así que el transportista también queda oculto 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 requieren 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 después de introducir la clave, y después una vez por semana. No hace falta ningún cron job. Desinstalar o restablecer el módulo elimina siempre 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. En Shipping > Carriers, comprueba que el transportista cubra la zona del país del cliente y su grupo, o activa Ignore shipping zones y revisa Countries. Revisa los límites de peso y el Minimum order amount. En el modo de precios fijos, comprueba que el país, * o el Flat price tengan un precio. En la página del producto también se pueden limitar los productos a determinados transportistas.
No se muestran tarifas de Bob Go: abre la página del módulo. La sección Cuenta de Bob Go 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 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, recarga la finalización de compra y revisa 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 rand: Bob Go cotiza en ZAR. Escribe cuánto vale 1 ZAR en la moneda de tu tienda. Sin ese valor, el módulo no pide tarifas a Bob Go. Los precios fijos siguen funcionando.
La página avisa de que las direcciones sudafricanas no tienen provincia: haz clic en Add South African provinces en la sección Envío desde (dirección de origen). Las direcciones existentes de los clientes solo reciben una provincia cuando se editan.
El impuesto se cobra dos veces en el envío: las tarifas de Bob Go suelen incluir el IVA. Configura Tax como No tax.
Las tarifas parecen desactualizadas tras un cambio: haz clic en Save en la página del módulo. Esto borra las tarifas de Bob Go en caché. Los cambios en tu cuenta de Bob Go se tienen en cuenta cuando expira la caché de 1 hora o al guardar los ajustes.
La página indica que no se encontró el transportista de Bob Go: 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 Bob Go y elige Uninstall. La clave de licencia, el estado de la licencia y las tarifas 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, el registro y las elecciones de servicio de los carritos abiertos. Si está desactivado, el transportista solo se desactiva y se conservan todos los ajustes. Al volver a instalar el módulo o con Reset, el transportista guardado recupera el estado que tenía antes: un transportista activo se vuelve a activar y uno desactivado sigue desactivado. El servicio de Bob Go guardado con los pedidos siempre se conserva.
Bob Go es una marca comercial de su respectivo titular. Este módulo no está afiliado a Bob Go ni cuenta con su respaldo.