VibeFox Sameday Easybox 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.

Nombre de usuario y contraseña de la API de Sameday: el acceso a la API forma parte de una cuenta de empresa de Sameday en Rumanía, Hungría o Bulgaria. Pregunta a tu gestor de cuenta de Sameday o al equipo de integración de Sameday. Las credenciales suelen ser las mismas que las del portal eAWB (eawb.sameday.ro, .hu o .bg). Para la API de demostración, Sameday proporciona credenciales de prueba independientes. Sin nombre de usuario y contraseña de la API, el método no se ofrece, porque el cliente no podría elegir un locker.

Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un 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_sameday_easybox a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox Sameday Easybox, 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 tu API username y tu API password de Sameday, elige el Sameday country y guarda. La página debería mostrar "Connected to Sameday ... easybox lockers". Pickup point y Easybox service se rellenan a partir de tu cuenta.

6. Configura tus precios: Exchange rate of the estimate si la moneda de tu tienda es distinta de la moneda de Sameday, y una fila de Country prices (por ejemplo * Default) o un Fallback cost.

7. Añade VibeFox Sameday Easybox a la zona de envío de tu país de Sameday en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore shipping zones.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox Sameday Easybox. 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 que ven los clientes en esta zona. Déjalo vacío para usar el Name global.

Encima de los ajustes, la página muestra el estado de la conexión: el host de Sameday, el número de lockers de easybox y cuándo se actualizó la lista, o que Sameday rechazó el nombre de usuario o la contraseña. También muestra los problemas de configuración, por ejemplo la falta de credenciales, de precio o de tipo de cambio para la estimación.

Todos los precios y límites aceptan una coma o un punto como separador decimal (4,99 o 4.99). Un número no válido se rechaza con un mensaje.

General

Enable/Disable: activa o desactiva el método en todas las zonas a la vez.

Name: el nombre del método de envío que se muestra al cliente. Una zona puede sustituirlo con su propio Title. Default: Sameday easybox.

Tax status: Taxable añade el impuesto de WooCommerce al coste de envío; None no lo añade.

Cuenta de Sameday (API)

Al guardar, el plugin inicia sesión en Sameday y carga tus servicios, puntos de recogida y la lista de lockers de easybox. La lista se actualiza a diario.

API username: tu nombre de usuario de la API de Sameday.

API password: tu contraseña de la API de Sameday. Si Sameday la rechaza, no se vuelve a probar durante 10 minutos.

Sameday country: el país de tu cuenta de Sameday: Romania (api.sameday.ro) (predeterminado), Hungary (api.sameday.hu) o Bulgaria (api.sameday.bg). Se ofrecen sus lockers y el método solo se muestra para este país de destino.

Test mode: usa la API de demostración de Sameday con credenciales de demostración.

Precios

El orden de uso es: la estimación de Sameday (cuando Pickup point y Easybox service están configurados), después la tabla de precios por país y, por último, el coste alternativo. Los precios de la tabla se introducen en la moneda de la tienda.

Pickup point: tu punto de recogida de Sameday, donde Sameday recoge los paquetes. Tras iniciar sesión correctamente, es una lista de los puntos de recogida de tu cuenta, y se elige automáticamente el predeterminado. Es necesario para la estimación de Sameday. Elige - not set (price table only) - para usar solo la tabla de precios.

Easybox service: el servicio de Sameday para la entrega en easybox, normalmente "Locker NextDay" (código LN), que se elige automáticamente. Es necesario para la estimación de Sameday.

Exchange rate of the estimate: Sameday calcula las estimaciones en la moneda de tu país de Sameday: RON, HUF o BGN (EUR para las tiendas búlgaras que venden en euros). Si tu tienda vende en otra moneda, introduce el valor de 1 unidad de la moneda de Sameday en la moneda de tu tienda, por ejemplo 0.20. Sin este valor no se usa la estimación y se aplica la tabla de precios. El lev y el euro se convierten automáticamente al tipo de cambio fijo.

Table price: Per order cobra el precio una sola vez. Per item (price x quantity) lo multiplica por el número de artículos enviables. Esto se aplica al precio de la tabla y al coste alternativo. La estimación de Sameday siempre se refiere al paquete completo.

Country prices: un precio por país de destino y por peso del paquete. Haz clic en + Add country para añadir una fila y en el icono con forma de cruz para eliminar una. Cada fila tiene una columna Price y columnas de peso: XS hasta 1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg y XL más de 5 kg. Una columna de peso que se deja en 0 usa la columna Price. La fila * Default se usa para los países que no tienen fila propia. Una fila nueva empieza como * Default con todos los precios en 0, lo que significa envío gratis. Elige el país e introduce los precios antes de guardar, o elimina la fila. Si el mismo país aparece en dos filas, al guardar solo se conserva la primera. Si una celda no es un número válido, la tabla no se guarda.

Fallback cost: se usa cuando no hay estimación de Sameday y la tabla de países no tiene fila para el destino. Déjalo vacío para no ofrecer el método en ese caso.

Free shipping from: el subtotal del carrito (después de descuentos, sin impuestos) a partir del cual la entrega en easybox es gratuita. Se aplica solo cuando se encuentra un precio: una fila de país, la fila * Default o el coste alternativo (en ese caso no se solicita estimación), o la estimación de Sameday. Déjalo vacío para no ofrecer nunca envío gratis.

Disponibilidad

Minimum weight (kg): oculta el método cuando el carrito pesa menos. El peso se convierte desde la unidad de peso de tu tienda. Vacío o 0 significa sin límite.

Maximum weight (kg): los paquetes más pesados que este valor no se ofrecen para la entrega en easybox. Default: 30. Consulta el límite de tu contrato con Sameday y los tamaños de las cajas de easybox. Vacío o 0 significa sin límite.

Minimum cart subtotal: ofrece el método solo cuando el subtotal del carrito (después de descuentos, sin impuestos) alcance este importe.

Excluded shipping classes: oculta el método cuando el carrito contiene un producto de alguna de estas clases de envío de WooCommerce.

Ignore shipping zones: cuando está activado, el método se ofrece para los países seleccionados abajo, aunque no esté añadido a la zona de envío correspondiente. Cuando está desactivado, se ofrece solo en las zonas a las que se ha añadido.

Countries (ignore zones mode): los países de destino para ese modo. Déjalo vacío para usar el país de Sameday. Los países distintos del país de Sameday se omiten. Este campo solo se usa cuando Ignore shipping zones está activado.

Avanzado

Debug log: registra los cálculos de tarifas, las llamadas a la API y las elecciones de locker en WooCommerce > Status > Logs (origen "vfd-sameday-easybox"). Los errores de la API siempre se registran. No se registra ninguna contraseña, token ni datos personales del cliente. Desactiva el registro cuando termines.

Remove data on uninstall: si está activado, al eliminar el plugin se borran los ajustes y las instancias de este método en las zonas. Desactivar el plugin nunca borra nada. El locker guardado en los pedidos siempre se conserva.

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 de tu cuenta de Sameday, credenciales de la API y una lista de lockers utilizable, peso del carrito, subtotal mínimo del carrito y clases de envío excluidas. Después busca un precio: la estimación de Sameday, la tabla por país o el coste alternativo. Si no hay precio, el método se oculta. Si se aplica el envío gratis, el cliente ve el método sin coste.

En caso contrario, el plugin pide a Sameday una estimación, una vez que el cliente ha introducido una ciudad y una provincia. Envía tu punto de recogida y servicio, el peso del paquete y la dirección, ciudad, provincia y código postal del cliente. No se envía el nombre, el correo electrónico ni el teléfono. Bucarest se envía como "Sector 1", igual que en el plugin oficial de Sameday. La estimación se convierte a la moneda de tu tienda. Si no hay estimación (no configurada, todavía sin ciudad o provincia, error, sin tipo de cambio), el precio procede de la tabla por país y, después, del coste alternativo. Si no hay precio, el método se oculta.

Los problemas de Sameday nunca rompen la finalización de compra. La estimación se guarda en caché durante 1 hora. Un error se guarda en caché durante 10 minutos. Tras un tiempo de espera o un error del servidor, no se solicita ninguna estimación durante 5 minutos. Las solicitudes caducan a los 15 segundos. Durante la finalización de compra, la lista de lockers se lee de tu servidor, no de Sameday.

El método funciona en la finalización de compra clásica y en los bloques de Carrito y Finalizar compra. Es compatible con WooCommerce High-Performance Order Storage (HPOS).

El plugin no crea AWB (envíos), no imprime etiquetas, no hace seguimiento de paquetes ni gestiona el pago contra reembolso. No tiene entrega a domicilio por mensajería ni widget de mapa de Sameday. Crea el AWB en el portal eAWB de Sameday o en tu herramienta habitual con el ID de locker que aparece en el pedido.

Selección del locker

Cuando el cliente selecciona el método, aparece debajo un bloque easybox locker con dos listas: - Select city - y - Select easybox locker -. La ciudad del cliente se preselecciona si tiene lockers. Cada locker muestra su nombre y dirección. La elección se recuerda cuando se actualiza la finalización de compra o se recarga la página.

El locker es obligatorio. Sin uno, la finalización de compra se detiene con "Please choose a Sameday easybox locker.". El servidor comprueba que el locker elegido está en la lista, tanto en la finalización de compra clásica como en la de bloques. Un ID de locker falsificado o eliminado se rechaza con el mensaje "The selected easybox locker is not available any more. Please choose another easybox locker.". El nombre y la dirección guardados con el pedido proceden de la lista, no del navegador.

Pantalla de pedido del administrador: Sameday easybox locker con el nombre y la dirección y el Locker ID para el AWB de Sameday, debajo de la dirección de envío. Si un pedido de easybox no tiene locker, la pantalla muestra "No easybox locker was selected for this order."

Página de gracias y vista del pedido: Sameday easybox locker: con el nombre y la dirección.

Correos de pedido: el nombre y la dirección del locker en los correos HTML y de texto plano. Los correos del administrador incluyen también el Locker ID.

En la base de datos, el locker se guarda en los metadatos del pedido _vfd_sdeb_locker_id (el ID de locker de Sameday para el AWB) y _vfd_sdeb_locker_name (nombre y dirección).

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 Sameday Easybox. 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 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, Sameday easybox 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

Sameday easybox no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado, que se han introducido el nombre de usuario y la contraseña de la API y que la página de ajustes indica "Connected to Sameday", y que el país de destino es el país de tu cuenta de Sameday. Comprueba que hay un precio disponible (estimación de Sameday, fila de país, fila * Default o Fallback cost), los límites de peso y subtotal, Excluded shipping classes, y que el método está añadido a la zona correspondiente (o que Ignore shipping zones está activado). Activa Debug log para ver el motivo en WooCommerce > Status > Logs.

Sameday rechazó el nombre de usuario o la contraseña de la API: compruébalos y guárdalos de nuevo. Las credenciales de demostración funcionan solo con Test mode activado, y las de producción solo con él desactivado. Mientras tanto, se ofrece la lista de lockers guardada, si existe, y no se usa la estimación de Sameday.

El precio viene de mi tabla, no de Sameday: la estimación necesita un Pickup point, el Easybox service y, cuando la moneda de tu tienda es distinta de la de Sameday, el Exchange rate of the estimate. Solo se solicita después de que el cliente haya introducido una ciudad y una provincia. Cuando Sameday no está disponible o devuelve un error, se usa la tabla o el coste alternativo; el motivo aparece en el registro.

La lista de lockers es antigua o falta: guarda los ajustes. La lista se vuelve a cargar cuando está vacía, tiene más de una hora de antigüedad o la última carga falló. Si una actualización falla, se usa la lista anterior y el estado lo indica.

El envío es gratis por error: revisa Country prices en busca de filas con un Price de 0, sobre todo una fila * Default añadida con + Add country y sin rellenar.

Lockers transfronterizos: los desarrolladores pueden añadir países de destino con el filtro vfd_sdeb_countries. La lista de lockers es siempre la de tu cuenta.

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 la dirección del sitio ha cambiado, 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 conserva todos los datos y solo detiene la actualización diaria de la lista de lockers. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin siempre se eliminan, junto con la lista de lockers guardada, el resultado de la comprobación de la cuenta y todas las cachés. Los ajustes y los métodos de zona solo se eliminan si Remove data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus líneas de envío y el locker guardado.

Sameday y easybox son marcas comerciales de sus respectivos propietarios. Este plugin no está afiliado a Sameday ni cuenta con su respaldo.