VibeFox Sameday Easybox for PrestaShop — Ayuda

Requisitos

PrestaShop: 8.0 a 9.x.

PHP: 8.0 o posterior. El módulo no se instala en versiones anteriores de PHP.

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 facilita credenciales de prueba aparte. Sin nombre de usuario y contraseña de la API el transportista no se ofrece, porque el cliente no podría elegir un locker.

Condados en el formulario de dirección: la estimación de Sameday necesita el condado de la dirección de entrega. PrestaShop no tiene condados para Rumanía, Hungría y Bulgaria por defecto. El módulo puede añadirlos por ti (véase la sección Lockers easybox más abajo). Sin ellos, los precios salen de tu tabla o del coste alternativo.

Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un 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 subida, haz clic en Configure, o busca VibeFox Sameday Easybox 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 de configuración, y haz clic en Activate (véase Clave de licencia).

4. Introduce tu API username y API password de Sameday, elige el Sameday country y haz clic en Save. La página debe mostrar "Conectado a Sameday ... lockers easybox". Pickup point y Easybox service se rellenan con los datos de tu cuenta.

5. 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.

6. Si la página indica que la tienda no tiene condados para tu país de Sameday, haz clic en Add counties en la sección Lockers easybox.

Al instalar el módulo se crea el transportista Sameday easybox con el texto del tiempo de entrega Delivery to a Sameday easybox locker. Se asigna a todos los grupos de clientes y a la zona de Rumanía. 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 procede del módulo.

Configuración

Todos los ajustes están en la página Configure del módulo, en seis secciones. El botón Save de cualquier sección guarda toda la página.

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

Todos los precios y límites aceptan coma o punto como separador decimal (4,99 o 4.99). Un número no válido o negativo no se guarda: una advertencia indica el campo y se mantiene el valor anterior.

General

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

Name: el nombre del método de envío que ve el cliente (el nombre del transportista). Por defecto: Sameday easybox.

Tax status: None significa que el precio es definitivo. Taxable con una regla de impuesto hace que PrestaShop añada ese impuesto de envío sobre el precio.

Cuenta de Sameday (API)

Al guardar, el módulo inicia sesión en Sameday y carga tus servicios, tus puntos de recogida y la lista de lockers 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. No se vuelve a mostrar: deja el campo vacío para conservar la guardada. Vaciar el nombre de usuario también elimina la contraseña. 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) (por defecto), Hungary (api.sameday.hu) o Bulgaria (api.sameday.bg). Se ofrecen sus lockers, y el transportista solo se muestra para este país de destino. Al cambiarlo, el transportista también se vincula a la zona del nuevo país.

Test mode: usa la API de demostración de Sameday (sameday-api.demo.zitec.com) con credenciales de demostración.

Precios

El orden de uso es: primero 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 predeterminada de la tienda. Los clientes que pagan en otra moneda ven el precio convertido.

Pickup point: tu punto de recogida de Sameday, donde Sameday recoge los paquetes. Tras un inicio de sesión correcto es una lista de los puntos de recogida de tu cuenta, y el predeterminado se elige automáticamente. 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 hace la estimación 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. El tipo debe ser superior a 0. Sin él no se usa la estimación y se aplica la tabla de precios. El leva y el euro se convierten automáticamente al tipo 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. Esto se aplica al precio de la tabla y al coste alternativo. La estimación de Sameday siempre es para el 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 de papelera para eliminar una. Cada fila tiene la columna Price y las columnas de peso: XS hasta 1 kg, S de 1 a 2 kg, M de 2 a 3 kg, L de 3 a 5 kg y XL más de 5 kg. Una columna de peso dejada 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 gratuito. Elige el país e introduce los precios antes de guardar, o elimina la fila. Si el mismo país figura en dos filas, al guardar solo se conserva la primera y una advertencia lo indica. 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 del país no tiene fila para el destino. Déjalo vacío para no ofrecer el transportista en ese caso.

Free shipping from: el subtotal del carrito (productos que necesitan envío, después de descuentos, sin impuestos) a partir del cual la entrega en easybox es gratuita. Cuando el subtotal lo alcanza, el transportista se ofrece sin coste y no se consulta ningún precio. Déjalo vacío para no ofrecer nunca envío gratuito.

Disponibilidad

Minimum weight (kg): oculta el transportista cuando el carrito pesa menos. El peso se convierte desde la unidad de peso de tu tienda (kg, g, lb u oz). Vacío o 0 significa sin límite.

Maximum weight (kg): los paquetes más pesados que esto no se ofrecen con entrega en easybox. Por defecto: 30. Consulta el límite de tu contrato de Sameday y los tamaños de caja de easybox. Vacío o 0 significa sin límite. Un peso mínimo superior al peso máximo no se guarda: una advertencia lo indica y se mantienen los valores anteriores.

Minimum cart subtotal: ofrece el transportista solo cuando el subtotal del carrito (productos que necesitan envío, después de descuentos, sin impuestos) alcance este importe.

Ignore shipping zones: cuando está activado, el transportista se ofrece en los países seleccionados abajo (el país de Sameday si la lista está vacía), aunque su zona no esté configurada para el transportista. El transportista se vincula entonces a todas las zonas activas, también a las creadas más tarde. Al desactivarlo de nuevo, el transportista recupera las zonas que tenía antes. Cuando está desactivado, el transportista solo se ofrece en sus zonas de Shipping > Carriers.

Countries (ignore zones mode): los países de destino para ese modo. Los países distintos del país de Sameday se omiten, y la página avisa de ellos. Este campo solo se usa cuando Ignore shipping zones está activado.

Lockers easybox

Locker list: muestra cuántos lockers easybox en cuántas ciudades están cargados y desde cuándo. Refresh the locker list now los vuelve a cargar. La lista se actualiza al guardar los ajustes y, cuando tiene más de un día de antigüedad, tras una petición de finalización de compra. Para una actualización diaria fija, llama una vez al día a la Cron URL que se muestra aquí desde una tarea cron de tu servidor. La URL contiene un token secreto. Sin el token responde con un error y no contacta con Sameday.

Counties: la estimación de Sameday necesita el condado de la dirección. Si PrestaShop no tiene condados (states) para tu país de Sameday, haz clic en Add counties. El módulo añade los condados de Rumanía, Hungría o Bulgaria y el campo de condado al formulario de dirección de ese país. Los condados que ya existen no se añaden dos veces. Cuando están en su sitio, la página muestra su número.

Avanzado

Debug log: escribe los cálculos de tarifas, las llamadas a la API y las elecciones de locker en el archivo logs/vfd_sdeb_debug.log.php de la carpeta del módulo, que no se puede leer desde la web. Los errores de la API siempre se registran. Ni la contraseña, ni el token ni los datos personales del cliente se registran. El campo Log de abajo muestra el final del archivo, con un botón Clear log. Desactiva el registro cuando termines.

Remove data on uninstall: cuando está activado, al desinstalar el módulo se eliminan los ajustes y el transportista. Sin él, desinstalar solo desactiva el transportista. La lista de lockers y las cachés siempre se eliminan. El locker guardado en los pedidos siempre se conserva.

Cómo funciona en la finalización de compra

Cuando la tienda calcula el envío de un carrito, PrestaShop pide al módulo el precio del transportista Sameday easybox. El módulo comprueba las condiciones: país de destino de tu cuenta de Sameday, credenciales de la API y una lista de lockers utilizable, los países de Ignore shipping zones, el peso del carrito y el subtotal mínimo. Los productos que no necesitan envío (productos virtuales) no se cuentan. Si se aplica el envío gratuito, el cliente ve el transportista sin coste.

En caso contrario, el módulo pide a Sameday una estimación, una vez que el cliente ha introducido una ciudad y un condado. Envía tu punto de recogida y tu servicio, el peso del paquete y la calle, la ciudad, el condado y el código postal de la dirección del cliente. No se envía ningún nombre, correo electrónico ni teléfono. Bucarest se envía como "Sector 1", como hace el plugin oficial de Sameday. La estimación se convierte a la moneda de tu tienda. Si no hay estimación (no configurada, sin ciudad o condado todavía, error, sin tipo de cambio), el precio sale de la tabla del país y, después, del coste alternativo. Si no hay precio, el transportista 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 pide ninguna estimación durante 5 minutos. Las peticiones caducan a los 15 segundos. Durante la finalización de compra, la lista de lockers se lee de tu servidor, no de Sameday.

El transportista funciona en el paso de envío del tema Classic (PrestaShop 8) y del tema Hummingbird (PrestaShop 9).

El módulo 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.

Puntos de recogida

Cuando el cliente selecciona el transportista, aparece debajo un bloque easybox locker con dos listas: - Select city - y - Select easybox locker -. La ciudad de la dirección de entrega se preselecciona cuando tiene lockers. Cada locker muestra su nombre y su dirección. La elección se guarda en el carrito al instante, así que se mantiene cuando se actualiza el paso de envío o se recarga la página.

El locker es obligatorio. Sin uno, el cliente no puede continuar y ve "Por favor, elige un locker easybox de Sameday." Cuando el cliente hace clic en Continue, el servidor comprueba que el locker elegido está en la lista. Un ID de locker falsificado o eliminado se rechaza con "El locker easybox elegido ya no está disponible. Por favor, elige otro locker easybox." Si la lista no se puede cargar, el cliente ve "No se pudieron cargar los lockers easybox. Inténtalo de nuevo en un momento o elige otro método de envío." El nombre y la dirección guardados con el pedido proceden de la lista, no del navegador. Una vez realizado el pedido, su locker ya no cambia.

Página de pedido del administrador: un bloque Sameday easybox locker con el nombre, la dirección y el Locker ID para el AWB de Sameday. Si un pedido easybox no tiene locker, el bloque indica "No se seleccionó ningún locker easybox para este pedido."

Páginas de confirmación e historial de pedidos: Sameday easybox locker: con el nombre y la dirección.

Correos de pedido: el nombre y la dirección del locker se añaden al transportista en el correo de confirmación del pedido. El correo de nuevo pedido enviado a la tienda (módulo Mail alerts) incluye también el Locker ID.

Clave de licencia

El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Sameday Easybox es el primer bloque de Modules > Module Manager > VibeFox Sameday Easybox > 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 eliminar la clave de esta tienda. Debajo aparecen la línea Product: presta-shipping-sameday-easybox 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 (se incluyen 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 contactar con el servidor de licencias, el módulo sigue funcionando con el último estado conocido.

Una clave funciona en un dominio: el dominio de la tienda principal, también en una configuración multitienda. Eliminar 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 Sameday easybox no se muestra a los clientes en la finalización de compra y no se solicita ni calcula ningún precio. 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 tras introducir la clave, y después una vez a la semana. No hace falta ninguna tarea cron. Desinstalar el módulo elimina siempre la clave de licencia y el estado de la licencia. Reset de este módulo no borra datos, así que la clave y el estado se conservan.

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 el nombre de usuario y la contraseña de la API están introducidos, que la página de configuración indica "Conectado a 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 del país, fila * Default o Fallback cost) y los límites de peso y de subtotal. En Shipping > Carriers comprueba que el transportista cubre la zona del país del cliente y su grupo, o activa Ignore shipping zones. Los productos también se pueden limitar a ciertos transportistas en la página del producto. Activa Debug log para ver el motivo en el campo Log.

Sameday rechazó el nombre de usuario o la contraseña de la API: compruébalos y vuelve a guardar. Las credenciales de demostración solo funcionan 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, condados en el formulario de dirección y, cuando la moneda de tu tienda es distinta de la de Sameday, el Exchange rate of the estimate. Solo se pide después de que el cliente haya introducido una ciudad y un condado. 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 está anticuada o falta: haz clic en Refresh the locker list now o guarda los ajustes. Si una actualización falla, se usa la lista anterior y el estado lo indica. Si la tienda está en modo de mantenimiento, la URL de cron se bloquea como el resto de la tienda, salvo que se permita la IP del servidor de cron.

El envío es gratuito por error: comprueba Free shipping from y las filas de Country prices con un Price de 0, sobre todo una fila * Default añadida con + Add country y sin rellenar.

Los límites de peso o las columnas de peso no coinciden: si la página avisa de que no se reconoce la unidad de peso de la tienda, configura kg, g, lb u oz en International > Localization (Local units).

La página indica que no se encontró el transportista Sameday easybox: el transportista se ha eliminado en Shipping > Carriers. Restablece el módulo en Modules > Module Manager para volver a crearlo. El restablecimiento conserva los ajustes y el estado de un transportista existente.

Desinstalación

Ve a Modules > Module Manager, abre el menú junto a VibeFox Sameday Easybox y elige Uninstall. La clave de licencia y el estado de la licencia siempre se eliminan. La lista de lockers guardada, el resultado de la comprobación de la cuenta y todas las cachés siempre se eliminan. Si Remove data on uninstall está activado, el transportista se elimina (los pedidos conservan su historial) y se borran los ajustes y el registro. 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. Los pedidos existentes conservan el locker guardado.

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