VibeFox Instabee for PrestaShop — Ayuda

Requisitos

PrestaShop: 8.0 a 9.x.

PHP: 8.0 o posterior. El módulo se niega a instalarse en versiones anteriores de PHP.

Credenciales de la API de Budbee (solo para la selección de taquilla): 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 transportista 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 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 Instabee más adelante 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. Rellena la sección Prices y, para el selector de taquillas, tu API key y API secret de Budbee (ver Configuración). Haz clic en Save.

Al instalar, el módulo crea el transportista Instabee parcel box con el texto del tiempo de entrega Delivery to an Instabee parcel box. El transportista se asigna a todos los grupos de clientes y a las zonas de Suecia, Finlandia, Dinamarca, los Países Bajos y Bélgica. Puedes cambiar las zonas, los grupos de clientes, el tiempo de entrega y el logotipo en Shipping > Carriers. No configures precios allí: el precio siempre viene del módulo.

Configuración

Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox Instabee > Configure. Cada sección tiene su propio botón Save, que guarda toda la página.

Las advertencias sobre los ajustes te avisan cuando solo se ha introducido una de las credenciales de la API, cuando no hay credenciales, cuando no hay precios por país ni coste alternativo, cuando la última petición a la API de Budbee falló (con fecha, hora y motivo), cuando no se encuentra el transportista de Instabee y cuando la unidad de peso de la tienda no se reconoce (configura kg, g, lb u oz en International > Localization, Local units). Cada vez que guardas los ajustes, se borran las listas de taquillas en caché y el último error de la API. Si el nombre del método o el estado fiscal no son válidos, o si Min weight (kg) es mayor que Max weight (kg), no se guarda nada y aparece un error.

General

Enable/Disable: activa o desactiva el transportista. Es el mismo interruptor que el estado del transportista en Shipping > Carriers.

Method name: el nombre del transportista que ve el cliente en la finalización de compra. Predeterminado: Instabee parcel box. Obligatorio, como máximo 64 caracteres.

Tax status: None significa que los precios de abajo son definitivos. Taxable con una regla fiscal significa que PrestaShop añade el impuesto de envío de esa regla sobre los precios de abajo.

Selector de taquillas (API de Budbee)

Con credenciales de API, el cliente elige una taquilla cercana a su código postal en la finalización de compra, y la taquilla se guarda en el pedido. Ambos campos son necesarios. El selector permanece desactivado hasta que se rellenen 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). Nunca se escribe en el registro.

Después de guardar, ambos campos quedan vacíos y muestran Saved - leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarlo. Para borrar las credenciales guardadas, marca Remove the saved API key and secret y guarda. Si no hay nada guardado, la página muestra No credentials saved.

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). Predeterminado: desactivado.

Precios (el título de la sección muestra la moneda predeterminada de tu tienda)

Todos los precios están en la moneda predeterminada de la tienda, sin impuestos. Se aceptan tanto la coma decimal como el punto decimal (49,90 = 49.90). El precio se muestra al cliente en la moneda del carrito.

Calculation type: cómo se aplica el precio.

Country prices: una tabla con las columnas Country, Price, XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg y XL >5 kg. Haz clic en Add country para añadir una fila y en el icono de papelera para eliminar una. Elige * Any other country para una fila que se aplica a todos los países que no tengan 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. Un precio que no es un número se borra y una advertencia lo indica. 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 precio. Déjalo vacío para ocultar el transportista en esos países.

Condiciones

Min weight (kg): oculta el transportista por debajo de este peso del carrito. Predeterminado: 0 (sin límite).

Max weight (kg): oculta el transportista por encima de este peso del carrito. Las taquillas admiten hasta unos 20 kg. Predeterminado: 20. 0 significa sin límite. No puede ser menor que Min weight (kg).

Minimum order amount: muestra el transportista solo cuando el subtotal del carrito (productos que necesitan envío, después de descuentos, antes de impuestos) alcanza este importe. Déjalo vacío para mostrarlo siempre.

Free shipping from: subtotal del carrito (después de descuentos, antes de impuestos) a partir del cual el transportista es gratuito. Déjalo vacío para que nunca sea gratuito.

Si un valor de estos campos o de Fallback cost no es un número, no se guarda, se mantiene el valor anterior y una advertencia indica el campo.

Disponibilidad sin zonas de envío

Normalmente el transportista se ofrece en las zonas de envío a las que está vinculado en Shipping > Carriers. Como alternativa, puedes activarlo aquí para una lista de países.

Ignore shipping zones: ofrece el transportista en los países de abajo, incluso donde sus zonas no los incluyen. El transportista se vincula a todas las zonas activas, incluidas las creadas más adelante. Cuando desactivas la opción, el transportista recupera 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. Este campo solo se usa cuando Ignore shipping zones está activado.

Avanzado

Debug log: escribe mensajes de depuración en logs/vfd_ibee_debug.log.php en la carpeta del módulo. No se puede abrir el archivo desde la web. Los errores de la API siempre se registran, incluso con esta opción desactivada. Las claves de API y los datos de los clientes nunca se registran.

Log: muestra el tamaño y las últimas entradas del registro. Haz clic en Clear log para vaciarlo.

Remove data on uninstall: si está activado, al desinstalar el módulo se borran los ajustes y el transportista. Si está desactivado, al desinstalar solo se desactiva el transportista. Las taquillas guardadas en los pedidos siempre se conservan.

Cómo funciona en la finalización de compra

En el paso de envío, PrestaShop pide al módulo el precio de Instabee. Solo cuentan los productos físicos: los productos virtuales no suman peso y no entran en el importe del pedido. El módulo comprueba las condiciones: peso del carrito e importe mínimo del pedido y, con Ignore shipping zones, los países permitidos. Si el subtotal del carrito alcanza Free shipping from, el precio es 0. 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 transportista se oculta.

Cuando el cliente selecciona el transportista de Instabee y las credenciales de la API están configuradas, aparece un bloque Parcel box debajo del transportista para Suecia, Finlandia, Dinamarca, los Países Bajos y Bélgica. Muestra las taquillas cercanas al código postal de la dirección de entrega, 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 (o pulsar Intro). Hasta que se introduzca un código postal, el bloque pide uno. Si no se encuentra ninguna taquilla, se pide al cliente que pruebe otro código postal o que elija otro método de envío. Para otros países el transportista se ofrece sin taquilla.

La taquilla es obligatoria. La taquilla elegida se guarda en el carrito solo si está en la lista de Budbee para ese código postal. Cuando el cliente hace clic en Continue en el paso de entrega, el módulo vuelve a comprobar la taquilla en el servidor. 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. Si el cliente cambia el país de entrega o el código postal de la dirección, la elección anterior se descarta.

El módulo 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 caída no ralentice cada actualización de la finalización de compra. La página de finalización de compra nunca espera a Budbee: la lista se carga en segundo plano en cuanto se selecciona el transportista. El tiempo de espera de la API es de 10 segundos.

Si no se puede acceder a la API de Budbee, el cliente ve Parcel boxes cannot be loaded right now. You can place the order without choosing a box - the shop will assign one. El pedido queda entonces marcado, y eliges la taquilla al reservar el envío. Una taquilla elegida antes, que no se puede comprobar en ese momento, se conserva y se marca como no verificada.

El selector funciona con los temas Classic y Hummingbird. 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 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

Cuando se crea el pedido, la taquilla se vuelve a comprobar una vez más y se guarda en el pedido. A partir de ese momento, la tienda no puede cambiarla. La taquilla se muestra en estos lugares:

Página del pedido en el back office: un bloque 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ó taquilla porque la API no estaba disponible, el bloque dice Not chosen - the Budbee API was unavailable at checkout. Choose the box when you book the shipment.

Página de confirmación del pedido y detalles del pedido en la cuenta del cliente: Instabee parcel box: con el nombre y la dirección de la taquilla.

Correos del pedido: la taquilla se añade al nombre del transportista en el correo de confirmación del pedido enviado al cliente. El correo de nuevo pedido a la tienda (del módulo Mail alerts de PrestaShop) también muestra el ID de la taquilla. Si no se eligió taquilla porque la API no estaba disponible, solo el correo a la tienda lo menciona.

Clave de licencia

El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Instabee es el primer bloque de Modules > Module Manager > VibeFox Instabee > Configure, 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 quitar la clave de esta tienda. Debajo están la línea Product: presta-shipping-instabee 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 (incluye 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 no se puede acceder al 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. Libera la plaza en tu cuenta de vibefox.net.

Sin una clave activa, el transportista de Instabee no se muestra a los clientes en la finalización de compra y no se calcula ninguna tarifa. La tienda de PrestaShop no sabe que has iniciado sesión en el back office, así que el transportista también se oculta 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 se necesita ninguna tarea cron. Desinstalar o restablecer el módulo siempre elimina la clave de licencia y el estado de la licencia.

Solución de problemas

Instabee no aparece en la finalización de compra: comprueba que la licencia esté activa y que Enable/Disable esté activado. En Shipping > Carriers, comprueba que el transportista cubra la zona del país del cliente y el grupo del cliente, o que Ignore shipping zones esté activado y el país esté permitido. Comprueba que el país tenga precio, o que exista una fila * o un Fallback cost. Revisa los límites de peso y el Minimum order amount. Una advertencia sobre los ajustes te indica cuando no hay precio configurado. En la página del producto también se pueden limitar los productos a ciertos transportistas. Activa Debug log para ver el motivo en el campo Log.

Los clientes no ven la lista de taquillas: la lista aparece solo cuando API key y API secret están rellenados, para Suecia, Finlandia, Dinamarca, los Países Bajos y Bélgica, y una vez introducido un código postal. El último error de la API se muestra encima de los ajustes. Los detalles están en el campo Log de la página del módulo. 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 coincida con tus credenciales (las credenciales de pruebas solo funcionan con el entorno de pruebas activado).

No hay 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.

El cliente no puede continuar desde el paso de entrega: hay que elegir una taquilla de la lista, a menos que no se pueda acceder a la API de Budbee. Una taquilla que no está en la lista del código postal buscado no se guarda, y el cliente ve This parcel box is not in the Budbee list for the postal code. Please choose the parcel box again.

Listas de taquillas antiguas tras un cambio: haz clic en Save en la página del módulo. Esto borra las listas de taquillas en caché.

La página indica que no se encontró el transportista de Instabee: el transportista se borró en Shipping > Carriers. Restablece el módulo en Modules > Module Manager para volver a crearlo. Lo mismo se aplica al mensaje The settings were saved, but the carrier could not be updated. Restablecer mantiene el estado del transportista: un transportista desactivado sigue desactivado.

Desinstalación

Ve a Modules > Module Manager, abre el menú junto a VibeFox Instabee y elige Uninstall. La clave de licencia y el estado de la licencia siempre se eliminan. Las listas de taquillas en caché siempre se eliminan. Si Remove data on uninstall está activado, el transportista se borra (los pedidos conservan su historial), y se eliminan los ajustes, el registro y las taquillas elegidas en carritos que nunca se convirtieron en pedidos. Si está desactivado, el transportista solo se desactiva y se conservan todos los ajustes. Al volver a instalar el módulo, el transportista guardado recupera el estado que tenía. Las taquillas guardadas en los pedidos siempre se conservan.

Instabee y Budbee son marcas comerciales de sus respectivos propietarios. Este módulo no está afiliado ni respaldado por Instabee ni por Budbee.