VibeFox Balikobot for WooCommerce — Ayuda
Requisitos
WordPress: 5.8 o posterior.
WooCommerce: 7.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
Cuenta de Balikobot (para tarifas en tiempo real y puntos de recogida): necesitas una cuenta de Balikobot con acceso a la API. El usuario de la API y la clave de la API están en el área de clientes (client.balikobot.cz). El soporte de Balikobot (podpora@balikobot.cz) activa la API para tu cuenta y tus transportistas. Las tarifas en tiempo real requieren un transportista y un servicio para los que Balikobot admita "transportcosts". Los puntos de recogida requieren un transportista con soporte de "branchlocator" (por ejemplo Česká pošta, Zásilkovna, PPL, DPD, GLS). Si no estás seguro, pregunta al soporte de Balikobot. Los precios fijos funcionan sin cuenta.
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_balikobot a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Shipping > VibeFox Balikobot, 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. Introduce el usuario y la clave de la API, elige el transportista, el tipo de servicio, la fuente del precio y los precios por país (consulta Configuración). Para los servicios con recogida, activa Pickup point selection.
6. Añade VibeFox Balikobot a una zona de envío (por ejemplo Chequia) 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 Balikobot. Se aplican a todas las zonas de envío. Las advertencias sobre ajustes que ocultarían el método, las tarifas en tiempo real o los puntos de recogida aparecen en la parte superior de la página. Cada vez que guardas los ajustes, se borran las tarifas y los puntos de recogida en caché. Al añadir el método a una zona, la ventana de la zona tiene un solo campo:
Title (zone): el nombre del método de envío que ven los clientes en esta zona. Déjalo vacío para usar el Name global.
General
Enable/Disable: activa o desactiva el envío de Balikobot en todas las zonas a la vez.
Name: el nombre del método de envío que ven los clientes. Una zona puede sustituirlo con su propio Title. Por defecto: Balikobot.
Tax status: Taxable significa que WooCommerce añade el impuesto sobre el envío encima del precio; None significa que no lo añade. Los precios de Balikobot suelen ser sin IVA.
Cuenta de la API de Balikobot (necesaria para las tarifas en tiempo real y los puntos de recogida)
API user: tu usuario de la API de Balikobot del área de clientes.
API key: tu clave de la API de Balikobot del área de clientes.
Carrier: la empresa de transporte de Balikobot que se usa para las tarifas y los puntos de recogida: Česká pošta (por defecto), Zásilkovna (Packeta), PPL, DPD, GLS, DHL Express, UPS, TNT, FedEx, Geis, InTime, Uloženka, Toptrans, Pošta bez hranic, Slovenská pošta, SPS (Slovak Parcel Service) o Magyar Posta. Debe estar activada en tu cuenta de Balikobot.
Service type: el código de servicio de Balikobot de la empresa de transporte. Por defecto: NP. Para Česká pošta: NP = paquete a una oficina de correos, NB = paquete a Balíkovna, DR = entrega a domicilio. Los códigos de otras empresas aparecen en el área de clientes de Balikobot y en la documentación de la API.
Precio (todos los precios están en la moneda de tu tienda)
Price source: cómo se calcula el precio.
Country prices: un precio fijo por país de destino (código de 2 letras, por ejemplo CZ, SK). Usa * para todos los demás países. Decimales con punto o con coma. Se usa en el modo fijo y como alternativa si falla la API. Un país sin precio (y sin fila *) no recibe tarifa fija.
Fixed price per: Order cobra el precio una sola vez. Item (price × quantity) lo multiplica por el número de artículos del carrito. Esto solo se aplica a los precios fijos. Una tarifa en tiempo real de Balikobot siempre es para el paquete completo.
Exchange rate: el valor de 1 unidad de la moneda del precio de Balikobot (normalmente CZK) en la moneda de tu tienda, por ejemplo 0.04. Se usa solo cuando Balikobot devuelve un precio en otra moneda. Déjalo vacío para rechazar esos precios, de modo que nunca se cobre al cliente un precio incorrecto.
Condiciones
Min weight (kg): oculta el método cuando el carrito pesa menos. 0 significa sin límite. Los pesos de los productos se convierten desde la unidad de peso de tu tienda.
Max weight (kg): oculta el método cuando el carrito pesa más. Por defecto: 100. 0 significa sin límite.
Minimum order amount: muestra el método solo a partir de este subtotal del carrito (después de descuentos, sin impuestos). Déjalo vacío para mostrarlo siempre.
Excluded shipping classes: oculta el método si el carrito contiene un producto de cualquiera de estas clases de envío de WooCommerce.
Free shipping: activa el envío gratuito a partir del importe indicado abajo.
Free shipping from: subtotal del carrito (después de descuentos, sin impuestos) a partir del cual el envío es gratuito. En ese caso no se hace ninguna solicitud a la API.
Disponibilidad sin zonas de envío
Ignore shipping zones: ofrece el método en los países indicados abajo, aunque no esté añadido a la zona correspondiente.
Countries: los países de destino para ese modo. Déjalo vacío para usar todos los países a los que envías. Se usa solo con Ignore shipping zones.
Puntos de recogida
Pickup point selection: el cliente debe elegir un punto de recogida. Úsalo para los servicios de recogida, por ejemplo Česká pošta NP o NB, o Zásilkovna. Necesita el usuario y la clave de la API.
Selector width: el ancho CSS de la lista de puntos de recogida, por ejemplo 100% o 400px. Por defecto: 100%.
Avanzado
Debug log: registra las solicitudes a la API y los cálculos de tarifas en WooCommerce > Status > Logs, origen "vfd-balikobot". Los errores de la API siempre se registran. Las credenciales y las direcciones de los clientes nunca se registran.
Remove data on uninstall: si está activada, al eliminar el plugin se borran sus ajustes y los métodos de zona. Desactivar el plugin nunca borra datos. Los puntos de recogida guardados en los pedidos se conservan.
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, el Minimum order amount y las Excluded shipping classes. Si se aplica el envío gratuito, la tarifa es 0 y no se envía ninguna solicitud a Balikobot.
En el modo fijo, el precio se toma de Country prices. En los modos en tiempo real, el plugin envía a Balikobot la empresa de transporte, el tipo de servicio, el país y el código postal de destino, y el peso del carrito en kg. Una tarifa en tiempo real se solicita solo después de que el cliente haya introducido un código postal. Un precio en otra moneda se convierte con Exchange rate, o se rechaza si no hay tipo de cambio.
Los precios en tiempo real se guardan en caché durante 1 hora, de modo que el mismo carrito no genera una solicitud nueva. Una solicitud fallida se guarda en caché durante 5 minutos, y el tiempo de espera de la API es de 12 segundos, para que la finalización de compra no espere a Balikobot en cada actualización. Los errores de la API nunca se muestran al cliente: el método se oculta, o se usa el precio fijo en el modo alternativo. Los detalles se escriben en el registro.
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 el almacenamiento de pedidos de alto rendimiento de WooCommerce (HPOS).
El plugin no crea envíos en Balikobot, no imprime etiquetas ni solicita recogidas: pide el envío en el área de clientes de Balikobot. No hace seguimiento de paquetes ni actualiza los estados de los pedidos. Se usa una empresa de transporte y un tipo de servicio para todas las zonas. Los puntos de recogida se muestran como una lista desplegable, sin mapa.
Puntos de recogida
Con Pickup point selection activado, aparece una lista de puntos de recogida debajo de la opción de Balikobot en la finalización de compra, tanto en la clásica como en la de bloques. La lista se carga desde el "branchlocator" de Balikobot para el país, la ciudad y el código postal del cliente. Hasta que se introduzcan la ciudad y el código postal, el cliente ve Enter your city and postcode to see the pickup points. La lista se guarda en caché durante 12 horas.
La elección es obligatoria: el cliente ve Please select a pickup point. El servidor comprueba además que el punto elegido pertenece a la dirección de envío. Tras un cambio de dirección, se pide al cliente que vuelva a elegir un punto de recogida. Si los puntos no se pueden cargar, se le pide que lo intente más tarde o que elija otro método de envío.
El punto de recogida elegido se guarda en el pedido. En la pantalla de pedidos del administrador aparece debajo de la dirección de envío como Balikobot pickup point, con el ID de la sucursal de Balikobot y la empresa de transporte, que necesitas al crear el envío en Balikobot. Haz clic en Change para elegir otro punto cercano a la dirección del pedido. El cliente ve el punto como Pickup point en la página del pedido y en los correos electrónicos del pedido (HTML y texto sin formato). Los pedidos existentes conservan los datos de su punto de recogida.
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 Balikobot. 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. Libérala en tu cuenta de vibefox.net.
Sin una clave activa, Balikobot 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 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
Balikobot 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). Lee las advertencias de la parte superior de la página de ajustes. Revisa los límites de peso, Minimum order amount y Excluded shipping classes. En el modo fijo, comprueba que el país o * tenga un precio.
No aparecen tarifas en tiempo real: activa Debug log, vuelve a cargar la finalización de compra y abre WooCommerce > Status > Logs (origen "vfd-balikobot"). Ahí aparece el motivo: faltan las credenciales de la API, todavía no hay código postal, Balikobot devuelve un error para la empresa de transporte y el servicio, o hay un precio en otra moneda sin Exchange rate. Con Live Balikobot rate, fixed price if the API fails, los clientes siguen viendo el precio fijo mientras solucionas el problema.
Los precios están en una moneda incorrecta: los precios fijos están en la moneda de tu tienda. Balikobot devuelve los precios en tiempo real en la moneda de tu contrato con Balikobot (normalmente CZK). Si es distinta de la moneda de tu tienda, configura Exchange rate.
¿Está incluido el IVA? Los precios de Balikobot suelen ser sin IVA. Con Tax status en Taxable, WooCommerce añade el impuesto sobre el envío.
No hay puntos de recogida en la lista: comprueba que el usuario y la clave de la API estén introducidos, que la empresa de transporte admita "branchlocator" y que el cliente haya introducido una ciudad y un código postal. Revisa el registro para ver el error de Balikobot.
Las tarifas o los puntos de recogida parecen desactualizados tras un cambio: guarda la página de ajustes. Así se borran las tarifas y los puntos de recogida en caché.
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 ha cambiado la dirección del sitio, haz clic en Check now para activar la clave en el nuevo dominio. Si no se puede conectar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Desactivar el plugin conserva todos los ajustes y solo borra las cachés. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de la licencia de este plugin, así como las tarifas y los puntos de recogida en caché, siempre se eliminan. Los ajustes y los métodos de zona se eliminan solo si Remove data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los datos de los puntos de recogida guardados en los pedidos nunca se eliminan.
Balikobot es una marca comercial de su respectivo titular. Este plugin no está afiliado a Balikobot ni cuenta con su aprobación.