VibeFox Econt 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.
Econt: no hace falta contrato ni clave API. La lista de oficinas es una nomenclatura pública de Econt. Solo se envía a Econt el código de país, sin datos de clientes. Introduce un usuario y una contraseña de e-Econt solo si Econt pide a tu tienda una autorización. El inicio de sesión en e-Econt se describe en la página para desarrolladores de Econt (econt.com/developers).
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 más tarde VibeFox Econt 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 (consulta Clave de licencia).
4. Define los precios por país y revisa las demás opciones (consulta Configuración), y luego haz clic en Save. Haz clic en Load offices from Econt now para probar la conexión.
Al instalarse, el módulo crea el transportista Econt Express con el texto de plazo de entrega Delivery to an Econt office or Econtomat. El transportista se asigna a las zonas de Bulgaria y Rumanía y a todos los grupos de clientes. Puedes cambiar las zonas, los grupos de clientes, el plazo de entrega, el logotipo y los límites de tamaño en Shipping > Carriers. No establezcas precios allí: el precio siempre procede del módulo.
Configuración
Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox Econt > Configure. Cada sección tiene su propio botón Save, que guarda toda la página. El precio y las condiciones se aplican a todas las zonas del transportista.
En la parte superior de la página, el módulo muestra advertencias: no se ha encontrado el transportista de Econt, la API de demostración está activada, no hay precio para Bulgaria ni Rumanía (en ese caso el transportista nunca se muestra), la última solicitud de oficinas para un país ha fallado o la unidad de peso de tu tienda no es conocida por el módulo (en ese caso los pesos se toman en kg; define la unidad en International > Localization, Local units). Los campos numéricos aceptan la coma decimal, por ejemplo 5,99. Si un campo numérico contiene algo que no es un número o un número negativo, o si Minimum weight (kg) es mayor que Maximum weight (kg), un error indica el campo y no se guarda nada.
General
Enable/Disable: activa o desactiva la entrega de Econt. Es el mismo interruptor que el estado del transportista en Shipping > Carriers.
Name: el nombre del transportista que se muestra en el carrito y en la finalización de compra. Predeterminado: Econt Express. Obligatorio, máximo 64 caracteres.
Tax: la regla de impuestos del transportista, o No tax. PrestaShop añade este impuesto sobre los precios de abajo. Con No tax los precios son definitivos.
Lista de oficinas de Econt
Las oficinas y los Econtomat se cargan desde la API de Econt y se guardan en caché durante 24 horas.
Demo API: usa la API de demostración de Econt con datos de prueba. Déjala desactivada en una tienda en producción. Las oficinas de demostración tienen ID distintos de los reales. En modo demo se usa la cuenta de prueba pública de Econt cuando no se ha definido ningún inicio de sesión.
Econt username: opcional. Tu inicio de sesión en e-Econt para la autorización HTTP Basic.
Econt password: opcional. Se guarda en la base de datos de la tienda y nunca se escribe en el registro. Después de guardar, el campo queda vacío y muestra Saved - leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarlo. Marca Remove the saved password y guarda para eliminarla.
Office list: muestra cuántas oficinas hay en caché por país y cuándo se cargaron. El botón Load offices from Econt now vuelve a cargar las listas de inmediato y muestra el resultado por país. Si una carga falla, se mantienen las oficinas de la última carga correcta. Sin este botón, la lista se carga automáticamente en la primera finalización de compra. Al cambiar Demo API, el usuario o la contraseña, se borran las listas en caché.
Selector de oficina en la finalización de compra
Show: qué puntos pueden elegir los clientes.
City order: muestra primero las ciudades más grandes (Sofía, Plovdiv, Varna, Bucarest y otras). Si está desactivado, las ciudades se ordenan alfabéticamente. Predeterminado: activado.
City list width: el ancho CSS de la lista de ciudades, por ejemplo 100% o 300px. Predeterminado: 100%.
Office list width: el ancho CSS de la lista de oficinas, por ejemplo 100% o 400px. Predeterminado: 100%.
Precios (el título de la sección muestra la moneda predeterminada de tu tienda)
Los precios están en la moneda predeterminada de tu tienda, sin impuestos. El módulo no consulta a Econt las tarifas en tiempo real. Bulgaria usa el euro desde el 1 de enero de 2026, así que una tienda búlgara normalmente introduce precios en EUR.
Price per country: un país por línea (o separados por comas): código de país, dos puntos y precio, por ejemplo BG:5.99 y RO:8.99 (son los valores predeterminados). También vale la coma decimal: BG:5,99. Un precio de 0 significa envío gratuito. Si el campo está vacío, se usan los precios predeterminados BG:5.99 y RO:8.99 (con Ignore zones, los países fuera de las zonas del transportista no reciben precio entonces). Las entradas con otro formato se ignoran y aparecen en una advertencia al guardar. El resto se guarda.
Calculation: Per order cobra el precio una sola vez. Per item (price x quantity) lo multiplica por el número de artículos que necesitan envío.
Price for other countries: se usa para un país de Econt (Bulgaria o Rumanía) que no aparezca en la lista de arriba. Vacío o 0 oculta el transportista en ese país.
Condiciones
El subtotal del carrito son los productos que necesitan envío, después de descuentos y antes de impuestos.
Free shipping from: el subtotal del carrito a partir del cual la entrega es gratuita. Déjalo vacío para no ofrecer nunca entrega gratuita.
Minimum subtotal: muestra el transportista solo cuando el subtotal del carrito sea al menos esta cantidad. Déjalo vacío para mostrarlo siempre.
Minimum weight (kg): oculta el transportista para los carritos más ligeros. Los pesos de los productos se convierten de la unidad de peso de tu tienda a kg. Déjalo vacío para no tener límite.
Maximum weight (kg): oculta el transportista para los carritos más pesados. Déjalo vacío para no tener límite.
Disponibilidad sin zonas de envío
Ignore zones: ofrece también Econt en los países de abajo cuando la zona de la dirección de entrega no está vinculada al transportista. Al activarlo, el transportista se vincula a todas las zonas activas, y también a las zonas creadas después. Al desactivarlo de nuevo, el transportista recupera las zonas que tenía antes. Las zonas que estaban vinculadas siguen funcionando como siempre. Econt sigue ofreciéndose solo para Bulgaria y Rumanía.
Countries: Bulgaria y/o Rumanía. Se usa solo con Ignore zones. Si no hay ninguno marcado, se incluyen todos los países de Econt a los que envía la tienda.
Avanzado
Debug log: escribe mensajes de depuración en logs/vfd_ecn_debug.log.php, en la carpeta del módulo. El archivo no se puede abrir desde la web. Los errores de la API siempre se registran. No se escriben contraseñas ni datos de clientes.
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 eliminan los ajustes de Econt, el transportista y el registro. Si está desactivado, los ajustes se conservan para una nueva instalación. Las oficinas guardadas en los pedidos siempre se conservan.
Cómo funciona en la finalización de compra
El transportista solo se ofrece para Bulgaria y Rumanía. En el paso de envío, PrestaShop pide al módulo el precio de Econt. Solo cuentan los productos físicos: los productos virtuales no suman peso ni se incluyen en el subtotal. El módulo comprueba los límites de peso y el subtotal mínimo, y después toma el precio del país. Si el subtotal del carrito alcanza Free shipping from, el precio es 0. Si no hay lista de oficinas disponible para el país, el transportista se oculta, porque la entrega siempre va a una oficina. El precio se calcula en la moneda predeterminada de tu tienda y después se muestra en la moneda del carrito del cliente.
Cuando el cliente selecciona Econt, aparecen dos listas debajo del transportista: City y Office / Econtomat. La lista de oficinas se carga una vez por página, solo cuando se selecciona Econt. Los Econtomat aparecen marcados en la lista. La elección se guarda en el carrito al momento. Si no se puede cargar la lista de oficinas, el cliente ve Econt offices cannot be loaded right now. Please try again in a few minutes or choose another shipping method.
Cuando el cliente hace clic en Continue en el paso de envío, el módulo comprueba en el servidor que se haya elegido una oficina y que exista en la lista de Econt para el país de entrega (filtrada por Show). Sin oficina, el cliente ve Please select an Econt office or Econtomat. Una oficina que no esté en la lista se rechaza con The selected Econt office is not available for the shipping country. Please select it again. El nombre de la oficina siempre se toma de la lista de Econt, no del navegador. El selector funciona con el tema Classic y con Hummingbird.
La lista de oficinas se guarda en caché durante 24 horas, por separado para la API en producción y la de demostración. Si no se puede contactar con Econt, se usa la última lista correcta y no se vuelve a consultar a Econt durante 10 minutos. El tiempo de espera de la API es de 15 segundos. La lista de oficinas procede de https://ee.econt.com/services/ (producción) o https://demo.econt.com/ee/services/ (demostración).
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 usa solo precios fijos. No consulta a Econt las tarifas en tiempo real, no crea albaranes ni etiquetas, no solicita recogidas de mensajería, no hace seguimiento de paquetes, no gestiona el pago contra reembolso ni entrega en una dirección. Solo Bulgaria y Rumanía tienen lista de oficinas.
Puntos de recogida
Al realizar el pedido, la oficina elegida para el carrito se guarda con el pedido: la ciudad, el nombre y la dirección de la oficina, y el código de oficina de Econt. Usa el código de oficina cuando crees el envío en e-Econt.
Página de pedido del back office: un bloque Econt office / Econtomat muestra la oficina y el Office code. Debajo de Change, elige otra ciudad y otra oficina del país del pedido y haz clic en Save. El cambio se guarda al momento y un mensaje privado del pedido registra la oficina anterior y la nueva. Si haces clic en Save sin elegir una oficina, el bloque dice Select a city and an office first - nothing was changed. Cualquier empleado con permiso para editar pedidos puede cambiar la oficina; no hace falta acceso a la página del módulo. Si no se puede cargar la lista de oficinas, el bloque muestra Econt offices cannot be loaded right now.
Varios pedidos de un mismo carrito: la oficina pertenece al primer pedido. Otro pedido realizado desde el mismo carrito no recibe oficina: se escribe un error en el registro y su bloque indica que la oficina de este carrito pertenece a otro pedido. Acuerda la oficina con el cliente y crea el envío en e-Econt manualmente.
Cliente: la oficina se muestra en la página de pedido del cliente y en la página de confirmación del pedido, y se añade al nombre del transportista en el correo de confirmación del pedido y en el correo de nuevo pedido a la tienda.
Los nombres de las oficinas se muestran en el idioma local (cirílico para Bulgaria) cuando el idioma de la tienda es búlgaro o rumano, y en inglés en los demás casos.
Clave de licencia
El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Econt es el primer bloque de Modules > Module Manager > VibeFox Econt > Configure, por 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-econt y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los empleados con el permiso Configure para el 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 solo 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 de Econt 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 aviso 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 a la semana. No se necesita ninguna tarea cron. Desinstalar o restablecer el módulo elimina siempre la clave de licencia y el estado de la licencia.
Solución de problemas
Econt no aparece en la finalización de compra: comprueba que la licencia esté activa y que Enable/Disable esté activado, y que el país de entrega sea Bulgaria o Rumanía. En Shipping > Carriers, comprueba que el transportista cubra la zona del país del cliente y el grupo del cliente (o activa Ignore zones y revisa Countries). Comprueba que haya un precio para el país, los límites de peso y Minimum subtotal. Revisa la línea Office list de los ajustes: el transportista se oculta mientras no haya lista de oficinas disponible para el país. Los productos también pueden limitarse a determinados transportistas en la página del producto.
La lista de oficinas no se carga: haz clic en Load offices from Econt now y lee el resultado, o la advertencia de la parte superior de la página de ajustes. Los errores siempre se escriben en el registro; activa Debug log para más detalle y revisa el campo Log. Si Econt exige autorización para tu tienda, rellena Econt username y Econt password.
Los clientes ven oficinas de prueba: Demo API está activada. Desactívala en una tienda en producción.
¿En qué moneda están los precios? En la moneda predeterminada de tu tienda, sin impuestos. Los clientes los ven en la moneda de su carrito.
Se cobra un impuesto encima del precio: el transportista tiene una regla de impuestos. Define Tax como No tax si tus precios ya incluyen IVA.
La página indica que no se ha encontrado el transportista de Econt: el transportista se eliminó en Shipping > Carriers. Restablece el módulo en Modules > Module Manager para volver a crearlo.
Desinstalación
Ve a Modules > Module Manager, abre el menú junto a VibeFox Econt y elige Uninstall. La clave de licencia y el estado de la licencia siempre se eliminan. Las listas de oficinas en caché siempre se eliminan. Si Remove data on uninstall está activado, el transportista se elimina (los pedidos conservan su historial) y se eliminan 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 se restaura el transportista guardado con el estado que tenía. Restablecer el módulo mantiene el estado actual del transportista. Las oficinas guardadas en los pedidos siempre se conservan.
Econt es una marca comercial de su respectivo titular. Este módulo no está afiliado a Econt ni cuenta con su aprobación.