VibeFox bpost Cubee 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 bpost Shipping Platform (solo para el selector de puntos de recogida): el plugin busca puntos de recogida a través de la API de bpost Shipping Platform. Inicia sesión en tu cuenta de bpost Shipping Platform en plugins.bpost.be y crea las claves en Settings > Key management. Necesitas tres valores: Account ID (clave pública), Passphrase (clave privada) y un App ID (X-APPID). bpost emite el App ID para tu integración; pídeselo al soporte de comercio electrónico de bpost (eol@bpost.be). También necesitas el ID de transportista de tu contrato (68 = bpost). Sin claves completas, el método sigue funcionando como método de envío de precio fijo, pero no se pide al cliente que elija un punto de recogida.
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_bpost_cubee a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox bpost Cubee, 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 tus precios y, para el selector de puntos de recogida, las claves API de bpost (véase Configuración).
6. Añade VibeFox bpost Cubee a tu zona de envío de Bélgica 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 bpost Cubee. 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 (zone): el nombre de esta opción en la finalización de compra para esta zona. Déjalo vacío para usar el Name global.
La página de ajustes muestra avisos cuando algo oculta el método o el selector sin avisar: el selector de puntos de recogida está activado pero las claves API están incompletas, no hay precio para Bélgica, o la última conexión con la API de bpost falló. Cada vez que guardas los ajustes, se borran el token de API guardado y las listas de puntos de recogida en caché.
General
Enable/Disable: activa o desactiva el envío a taquillas de bpost en todas las zonas a la vez.
Name: el nombre del método de envío que ve el cliente en la finalización de compra. Por defecto: bpost parcel locker.
Tax status: Taxable añade el impuesto de WooCommerce sobre tus precios; None significa que los precios son finales.
API de bpost (búsqueda de puntos de recogida) (necesaria solo para el selector de puntos de recogida)
Account ID (public key): la clave pública de tu cuenta de bpost Shipping Platform, de Key management en plugins.bpost.be.
Passphrase (private key): la clave privada que firma cada solicitud (HMAC-SHA256). Nunca se envía a bpost ni se escribe en el registro.
App ID (X-APPID): el identificador de aplicación que bpost emitió para tu integración. Se envía en la cabecera X-APPID.
Carrier ID: el transportista de tu contrato de bpost Shipping Platform cuyos puntos de recogida y taquillas se listan. Por defecto: 68 (bpost). Otros transportistas habilitados en tu contrato tienen sus propios ID.
Selector de punto de recogida
Pickup points: muestra el selector de puntos de recogida y taquillas en la finalización de compra. Activado por defecto. El selector aparece solo cuando las tres claves API están completas.
Search field width: el ancho CSS del campo de código postal / ciudad, por ejemplo 100% o 300px. Por defecto: 100%.
Pickup point list width: el ancho CSS de la lista de puntos de recogida, por ejemplo 100% o 400px. Por defecto: 100%.
Precios (en la moneda de tu tienda; bpost no devuelve precios de envío a través de esta API)
Price by: cómo se elige el precio.
Country prices: una línea por país con el formato CC=PRICE, por ejemplo BE=4.95. La línea *=PRICE fija el precio para todos los demás países, por ejemplo *=9.95. Se aceptan tanto el punto como la coma como separador decimal. Las líneas no válidas se ignoran y se listan en un mensaje de error al guardar. No se ofrece el método a los países sin precio (cuando no hay línea *).
Size prices: se usa cuando Price by es tamaño de paquete, en el formato S=3.50, M=4.50, L=6.00, XL=8.00. El tamaño procede del peso del carrito: S hasta 2 kg, M hasta 5 kg, L hasta 10 kg, XL por encima de 10 kg.
Calculation: Per order cobra el precio una sola vez. Per item (price x number of items) lo multiplica por el número de artículos del carrito.
Condiciones
Min weight (kg): el peso mínimo del carrito para que aparezca el método. 0 significa sin límite.
Max weight (kg): el método se oculta por encima de este peso del carrito. Por defecto: 30, porque las taquillas de bpost aceptan paquetes de hasta 30 kg. 0 significa sin límite.
Minimum order amount: muestra el método solo cuando el subtotal del carrito (sin impuestos) alcanza este importe. Déjalo vacío para mostrarlo siempre.
Excluded shipping classes: oculta el método cuando algún artículo del carrito pertenece a una de estas clases de envío de WooCommerce.
Los pesos de los productos se convierten de la unidad de peso de tu tienda a kilogramos.
Envío gratuito
Free shipping: activa la entrega gratuita a partir del importe indicado abajo.
Free shipping from: el subtotal del carrito (sin impuestos) a partir del cual el envío es gratuito. Se usa solo cuando Free shipping está activado.
Disponibilidad sin zonas de envío
Ignore shipping zones: ofrece el método en los países indicados abajo sin añadirlo a una zona.
Countries: los países de destino para ese modo. Por defecto: Bélgica. Déjalo vacío para usar todos los países a los que envías. Este campo se usa solo cuando Ignore shipping zones está activado.
Avanzado
Debug log: registra las solicitudes a la API y los cálculos de precios en WooCommerce > Status > Logs, origen vfd-bpost-cubee. Los errores de API siempre se registran, incluso con esta opción desactivada. Las claves, los tokens y los datos de clientes nunca se registran.
Remove data on uninstall: si está activado, al eliminar el plugin se borran sus ajustes y sus métodos de zona. Desactivar el plugin nunca borra datos. Los puntos de recogida guardados en los pedidos siempre 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: país de entrega, peso del carrito, importe mínimo del pedido y clases de envío excluidas. Después toma el precio de la lista de países o según el tamaño del paquete, lo multiplica por el número de artículos en el modo por artículo y lo pone a cero cuando se aplica el envío gratuito.
Cuando el cliente elige la tarifa de bpost, debajo aparecen un campo de búsqueda, un botón Search y una lista de puntos de recogida. Si el campo de búsqueda está vacío, se busca automáticamente el código postal de la dirección de finalización de compra. El cliente puede introducir otro código postal o el nombre de una ciudad. Cada punto se muestra con su nombre y dirección. Se listan hasta 50 puntos. La lista de puntos de recogida se solicita en neerlandés en los sitios en neerlandés y en francés en los demás.
El cliente debe elegir un punto de recogida. Sin él, la finalización de compra clásica muestra Please select a bpost pickup point., y la finalización de compra en bloques no permite realizar el pedido con el mismo mensaje. La elección se conserva durante la sesión de compra, así que recargar la página no la borra.
Para listar los puntos de recogida, el plugin envía a bpost solo el código postal o la ciudad buscados, el país y el ID de transportista, firmados con tus claves. No se envía el nombre, el correo electrónico ni ninguna línea de dirección del cliente. El token de API se solicita y se renueva automáticamente. Si bpost rechaza un token, se solicita uno nuevo una vez y la búsqueda se repite. Los resultados de búsqueda se guardan en caché durante 6 horas. Si bpost no responde, el cliente ve Pickup points cannot be loaded right now. Please try again in a few minutes or choose another shipping method., y el plugin lo vuelve a intentar al cabo de 5 minutos. El tiempo de espera de la API es de 15 segundos.
El método funciona en la finalización de compra clásica y en los bloques Carrito y Finalizar compra. Es compatible con WooCommerce High-Performance Order Storage (HPOS).
El plugin usa solo precios fijos. No obtiene tarifas en tiempo real de bpost, no crea envíos, no imprime etiquetas ni hace seguimiento de paquetes. Los puntos de recogida se muestran como una lista, no en un mapa. Crea los envíos en tu cuenta de bpost Shipping Platform o Shipping Manager; el ID del punto de recogida está en el pedido.
Puntos de recogida
El punto de recogida elegido (nombre y dirección) y su ID se guardan en el pedido. En la pantalla de pedidos del administrador aparece debajo de la dirección de envío como bpost pickup point. Haz clic en Change, busca un código postal o una ciudad y elige otro punto de la lista. El pedido se actualiza al momento y se añade una nota de pedido bpost pickup point changed to: …. El enlace Change solo está disponible cuando las claves API están completas.
Los clientes ven el punto de recogida en la página de agradecimiento y en My account > Orders. También se añade a los correos de pedido, tanto en HTML como en texto sin formato.
Para ofrecer taquilla y entrega a domicilio juntas, añade otro método de envío, por ejemplo Flat rate, a la misma zona. El selector de puntos de recogida aparece solo debajo de la tarifa de bpost.
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 bpost Cubee. 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. Libérala en tu cuenta de vibefox.net.
Sin una clave activa, el método de bpost no se muestra a los clientes en la finalización de compra. Los gestores de la tienda con sesión iniciada 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 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
bpost 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 una línea *=PRICE, y revisa los límites de peso, Minimum order amount y Excluded shipping classes. La página de ajustes muestra un aviso cuando Bélgica no tiene precio.
No hay selector de punto de recogida en la finalización de compra: comprueba que Pickup points está activado y que Account ID (public key), Passphrase (private key) y App ID (X-APPID) están todos rellenados. La página de ajustes muestra un aviso cuando las claves están incompletas.
Los clientes ven "Pickup points cannot be loaded right now": bpost no respondió o rechazó las claves. El motivo está en WooCommerce > Status > Logs (origen vfd-bpost-cubee) y en la página de ajustes. El plugin lo vuelve a intentar automáticamente al cabo de 5 minutos. Guardar los ajustes lo vuelve a intentar de inmediato.
No se encuentran puntos de recogida para este código postal o ciudad: bpost no devolvió puntos para esa búsqueda. Pide al cliente que pruebe un código postal cercano o el nombre de una ciudad, y comprueba el Carrier ID.
Los precios con coma no se usan: se aceptan tanto 5,50 como 5.50. Las líneas de Country prices que no siguen el formato CC=PRICE se ignoran; el mensaje de error tras guardar las enumera.
¿Los precios incluyen impuestos? Con Tax status en Taxable, WooCommerce añade el impuesto sobre tus precios. Con None, los precios son finales.
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 contactar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Desactivar el plugin conserva todos los ajustes; solo borra el token de API y las listas de puntos de recogida en caché. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin, el token de API y las cachés siempre se borran. Los ajustes y los métodos de zona solo se eliminan si Remove data on uninstall estaba activado. Si no, se conservan para una futura reinstalación. Los puntos de recogida guardados en los pedidos forman parte del historial de pedidos y nunca se eliminan.
bpost es una marca comercial de su respectivo titular. Este plugin no está afiliado a bpost ni cuenta con su aprobación.