VibeFox Instabee 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.
Credenciales de la API de Budbee (solo para la selección de taquillas): una clave de API y un secreto de API. Instabee los emite a comerciantes con un acuerdo de entrega. Pregunta a tu contacto de Instabee o usa el portal de comerciantes de Instabee. La documentación de la API está en developer.budbee.com. Sin credenciales, el método sigue funcionando con precios fijos, pero los clientes no pueden elegir una taquilla.
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_instabee a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox Instabee, o haz clic en Settings debajo del nombre del plugin en la página de extensiones.
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 sección Precios y, para el selector de taquillas, tu API key y tu API secret de Budbee (consulta Configuración).
6. Añade VibeFox Instabee a las zonas de envío de tus países de entrega (por ejemplo, Suecia) 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 Instabee. 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: el nombre de esta tarifa en la finalización de compra de esta zona. Déjalo vacío para usar el Method name global.
Las advertencias encima de los ajustes te indican cuando solo has introducido una de las credenciales de la API, cuando no hay ninguna, cuando no hay precios por país ni coste alternativo, y cuando la última petición a la API de Budbee falló (con fecha, hora y motivo). Cada vez que guardas los ajustes, se borran las listas de taquillas en caché y el último error de la API.
General
Enable/Disable: activa o desactiva el método en todas partes, incluidas las zonas de envío. Por defecto: activado.
Method name: el nombre del método de envío que se muestra en el carrito y en la finalización de compra. Una zona puede sustituirlo con su propio Title. Por defecto: Instabee parcel box.
Tax status: Taxable añade el impuesto de WooCommerce al coste de envío; None no lo añade.
Selector de taquillas (API de Budbee)
Con credenciales de la API, el cliente elige en la finalización de compra una taquilla cercana a su código postal, y la taquilla se guarda en el pedido. Se necesitan ambos campos. El selector permanece desactivado hasta que se completen los dos.
API key: tu clave de API de Budbee (el nombre de usuario de HTTP Basic).
API secret: tu secreto de API de Budbee (la contraseña de HTTP Basic).
Test environment: usa la API de pruebas de Budbee (api.staging.budbee.com). Actívalo solo con credenciales de pruebas de Instabee. Las tiendas en producción lo dejan desactivado (api.budbee.com). Por defecto: desactivado.
Precios (el título de la sección muestra la moneda de tu tienda)
Todos los precios están en la moneda de la tienda. Se aceptan tanto la coma como el punto decimal (49,90 = 49.90). Un valor que no es un número no se guarda, y un mensaje de error indica el campo.
Calculation type: cómo se aplica el precio.
Country prices: una tabla con las columnas Country, Price, XS (hasta 1 kg), S (hasta 2 kg), M (hasta 3 kg), L (hasta 5 kg) y XL (más de 5 kg). Haz clic en + Add country para añadir una fila y en el icono de la cruz para quitar una. Elige * Any other country para una fila que se aplica a todos los países sin fila propia. Un tramo vacío o 0 usa la columna Price. Un Price de 0 significa envío gratuito. Si la fila del país no tiene precio para el peso del carrito, se usa la fila * y después el Fallback cost. Los pesos se convierten de la unidad de peso de tu tienda a kg.
Fallback cost: se usa cuando ni la fila del país de destino ni la fila * dan un precio. Déjalo vacío para ocultar el método en esos países.
Condiciones
Min weight (kg): oculta el método cuando el carrito pesa menos. Por defecto: 0 (sin límite).
Max weight (kg): oculta el método cuando el carrito pesa más. Las taquillas admiten hasta unos 20 kg. Por defecto: 20. 0 significa sin límite.
Minimum order amount: muestra el método solo cuando el subtotal del carrito (después de descuentos, antes de impuestos) alcanza este importe. Déjalo vacío para mostrarlo siempre.
Free shipping from: el subtotal del carrito (después de descuentos, antes de impuestos) a partir del cual el método es gratuito. Déjalo vacío para que nunca sea gratuito.
Excluded shipping classes: oculta el método cuando el carrito contiene un producto de alguna de estas clases de envío de WooCommerce.
Disponibilidad sin zonas de envío
Normalmente añades VibeFox Instabee a una zona de envío. Como alternativa, puedes activarlo aquí para una lista de países.
Ignore shipping zones: ofrece el método en los países indicados abajo, también donde ninguna zona de envío lo incluya.
Countries: los países de destino para ese modo. Déjalo vacío para usar todos los países a los que envías. Este campo solo se usa cuando Ignore shipping zones está activado.
Avanzado
Debug log: escribe mensajes de depuración en WooCommerce > Status > Logs (origen vfd-instabee). Los errores de la API siempre se registran, aunque esta opción esté desactivada. Las claves de API y los datos de los clientes nunca se registran.
Remove data on uninstall: si está activado, al borrar el plugin se eliminan los ajustes y las tarifas por zona de este método. Desactivar el plugin nunca borra los ajustes. Las taquillas guardadas en los pedidos se conservan.
Cómo funciona en la finalización de compra
Cuando el cliente introduce una dirección de entrega, WooCommerce pide al plugin una tarifa. El plugin comprueba las condiciones: peso del carrito, importe mínimo del pedido y clases de envío excluidas. Si el subtotal del carrito alcanza Free shipping from, la tarifa es gratuita. Si no, el precio se toma de la fila Country prices del país de destino, de la fila * o del Fallback cost. Si no hay precio, el método se oculta.
Cuando el cliente selecciona la tarifa de Instabee y las credenciales de la API están configuradas, aparece un selector de Parcel box debajo de la tarifa para Suecia, Finlandia, Dinamarca, los Países Bajos y Bélgica. Muestra las taquillas cercanas al código postal de la dirección de envío, ordenadas por distancia, con el nombre, la dirección y la distancia. El cliente puede escribir otro código postal y hacer clic en Search. Hasta que se introduzca un código postal, el selector pide uno. Si no se encuentran taquillas, se pide al cliente que pruebe otro código postal o que elija otro método de envío.
La taquilla es obligatoria. Al realizar el pedido, el plugin comprueba en el servidor que la taquilla elegida está en la lista de Budbee para ese código postal. Si no, el cliente ve Please choose an Instabee parcel box. El nombre de la taquilla se toma de la lista de Budbee, no del navegador.
El plugin envía a Budbee solo el país de destino y el código postal, nunca nombres, direcciones, correos electrónicos ni datos de pedidos. Las listas de taquillas se guardan en caché durante 12 horas por código postal; un código postal sin taquillas, durante 1 hora; y una petición fallida, durante 5 minutos, para que una API lenta o averiada no ralentice cada actualización de la finalización de compra. El tiempo de espera de la API es de 10 segundos.
Si no se puede acceder a la API de Budbee, se informa al cliente de que el pedido se puede realizar sin elegir una taquilla. El pedido queda entonces marcado, y tú eliges la taquilla al reservar el envío. Una taquilla elegida antes que no se pueda comprobar en ese momento se conserva y se marca como no verificada.
El selector funciona en la finalización de compra clásica y en los bloques de Carrito y de Finalizar compra. El plugin es compatible con el almacenamiento de pedidos de alto rendimiento (HPOS) de WooCommerce.
El plugin no calcula tarifas en tiempo real, no reserva envíos, no imprime etiquetas, no da números ni correos de seguimiento, no ofrece franjas horarias de entrega a domicilio de Budbee Home ni muestra un mapa. Reserva el paquete para la taquilla elegida en tus herramientas de comerciante de Instabee / Budbee.
Puntos de recogida
La taquilla elegida se guarda en el pedido y se muestra en estos lugares:
Pantalla de pedidos del administrador: debajo de la dirección de envío, como Instabee parcel box con el nombre de la taquilla, la dirección y el Box ID. Si la taquilla no se pudo comprobar en la finalización de compra, aparece marcada como not verified (Budbee API was unavailable at checkout). Si no se eligió ninguna taquilla porque la API no estaba disponible, la pantalla lo indica y te recuerda que elijas la taquilla al reservar el envío.
Página de agradecimiento y página de pedido de Mi cuenta: el nombre y la dirección de la taquilla.
Correos del pedido: en HTML y en texto sin formato. Los correos a la tienda también muestran el ID de la taquilla. Si no se eligió ninguna taquilla porque la API no estaba disponible, solo los correos a la tienda lo mencionan.
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 Instabee. 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 quitarla 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. Quitar la clave de un sitio no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.
Sin una clave activa, Instabee 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 de extensiones 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 renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
Instabee 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 está permitido). Comprueba que el país tiene un precio, o que existe una fila * o un Fallback cost. Revisa los límites de peso, Minimum order amount y Excluded shipping classes. Una advertencia encima de los ajustes te indica cuando no hay ningún precio configurado.
Los clientes no ven la lista de taquillas: la lista aparece solo cuando API key y API secret están configurados, para Suecia, Finlandia, Dinamarca, los Países Bajos y Bélgica, y una vez que se introduce un código postal. El último error de la API se muestra encima de los ajustes. Los detalles están en WooCommerce > Status > Logs (origen vfd-instabee). Activa Debug log para más detalle.
HTTP 401 o 403 en el registro: Budbee rechazó la clave o el secreto de la API. Revísalos y comprueba que Test environment coincide con tus credenciales (credenciales de pruebas solo con el entorno de pruebas activado).
Sin taquillas para un código postal: Budbee no da servicio en ese código postal. El cliente puede buscar otro código postal o elegir otro método de envío.
Listas de taquillas antiguas tras un cambio: guarda la página de ajustes. Esto borra las listas de taquillas en caché.
Otros países para la búsqueda de taquillas: los desarrolladores pueden cambiar la lista de países con el filtro vfd_ibee_box_countries.
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 acceder al servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Desactivar el plugin solo borra las listas de taquillas en caché. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave y el estado de licencia de este plugin, las listas de taquillas en caché y el último error de la API siempre se eliminan. Los ajustes, los métodos por zona y los datos de versión se eliminan solo si Remove data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Las taquillas guardadas en los pedidos se conservan siempre, y los pedidos existentes mantienen sus líneas de envío.
Instabee y Budbee son marcas registradas de sus respectivos propietarios. Este plugin no está afiliado a Instabee ni a Budbee ni cuenta con su respaldo.