VibeFox Econt 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.
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, ningún dato del cliente. Introduce un usuario y una contraseña de e-Econt solo si Econt pide a tu sitio autorización. El inicio de sesión de 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 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_econt a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox Econt, 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. Establece los precios por país y revisa las demás opciones (véase la sección Configuración). Haz clic en Load offices from Econt now para probar la conexión.
6. Añade VibeFox Econt a una zona de envío con Bulgaria y/o Rumanía en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore zones y elige los países.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox Econt. El precio y las condiciones se aplican a todas las zonas de envío. Al añadir el método a una zona, la ventana de la zona tiene solo un campo:
Title (zone): el nombre que ven los clientes en esta zona. Déjalo vacío para usar el Name general.
En la parte superior de la página el plugin muestra avisos: la API de demostración está activada, no hay precio para Bulgaria o Rumanía (el método entonces nunca se muestra), o la última solicitud de oficinas para un país ha fallado. Los campos numéricos aceptan coma decimal, por ejemplo 5,99. Un valor que no es un número se ignora y se notifica al guardar.
General
Enable/Disable: activa o desactiva la entrega de Econt en todas las zonas a la vez. Por defecto: activado.
Name: el nombre del método de envío que se muestra en la finalización de compra. Un Title definido en la zona lo sustituye. Por defecto: Econt Express.
Tax status: Taxable añade el impuesto de WooCommerce al coste del envío, None no lo añade. Por defecto: Taxable.
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. Mantenla desactivada en una tienda en producción. Las oficinas de demostración tienen otros ID que las reales. En modo demostración se usa la cuenta de prueba pública de Econt cuando no hay ningún inicio de sesión configurado.
Econt username: opcional. Tu usuario de e-Econt para la autorización HTTP Basic.
Econt password: opcional. Se guarda en la base de datos de WordPress y nunca se escribe en el registro.
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. 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. Por defecto: activado.
City list width: el ancho CSS de la lista de ciudades en la finalización de compra clásica, por ejemplo 100% o 300px. Por defecto: 100%.
Office list width: el ancho CSS de la lista de oficinas en la finalización de compra clásica, por ejemplo 100% o 400px. Por defecto: 100%.
Precios (en la moneda de tu tienda)
El plugin 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 por defecto). También vale la coma decimal: BG:5,99. Un precio de 0 significa envío gratuito. Las entradas con otro formato se ignoran y aparecen en un mensaje de error al guardar.
Calculation: Per order cobra el precio una sola vez. Per item (price x quantity) lo multiplica por el número de artículos enviables del carrito.
Price for other countries: se usa para un país de Econt (Bulgaria o Rumanía) que no figure arriba. Vacío o 0 oculta el método en ese país.
Condiciones
Free shipping from: el subtotal del carrito a partir del cual el envío es gratuito. Déjalo vacío para no ofrecer nunca envío gratuito.
Minimum subtotal: muestra el método solo cuando el subtotal del carrito sea al menos este importe. Déjalo vacío para mostrarlo siempre.
Minimum weight (kg): oculta el método para carritos más ligeros. Los pesos de los productos se convierten de la unidad de tu tienda a kg. Déjalo vacío para no tener límite.
Maximum weight (kg): oculta el método para carritos más pesados. Déjalo vacío para no tener límite.
Hide for shipping classes: oculta el método si el carrito contiene un producto de una de estas clases de envío de WooCommerce.
Disponibilidad sin zonas de envío
Ignore zones: ofrece también Econt en los países de abajo cuando ninguna zona lo añade. Las zonas que contienen el método siguen funcionando como siempre.
Countries: Bulgaria y/o Rumanía. Se usa solo con Ignore zones. Déjalo vacío para todos los países de Econt a los que tu tienda envía.
Avanzado
Debug log: escribe mensajes de depuración en WooCommerce > Status > Logs, origen vfd-econt. Los errores de la API siempre se registran. No se escriben contraseñas ni datos de clientes.
Remove data on uninstall: si está activado, al eliminar el plugin se borran los ajustes de Econt y los métodos de las zonas. Desactivar el plugin nunca borra los ajustes. Las oficinas guardadas en los pedidos siempre se conservan.
Cómo funciona en la finalización de compra
El método se ofrece solo para Bulgaria y Rumanía. Cuando el cliente introduce una dirección de envío, el plugin comprueba el peso del carrito, el subtotal mínimo y las clases de envío ocultas, 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 método se oculta, porque la entrega siempre se hace en una oficina.
Cuando el cliente selecciona Econt, aparecen dos listas debajo del método: City y Office / Econtomat. La lista de oficinas se carga una vez por página. Los Econtomat aparecen marcados en la lista. La elección se recuerda durante la sesión. Si no se puede cargar la lista de oficinas, el cliente ve un mensaje para volver a intentarlo en unos minutos o elegir otro método de envío.
El cliente no puede realizar el pedido sin elegir una oficina. En el servidor, el plugin vuelve a comprobar que la oficina existe en la lista de Econt para el país de envío. El nombre de la oficina siempre se toma de la lista de Econt, nunca del navegador. Esto funciona en la finalización de compra clásica y en la de bloques. El plugin es compatible con el almacenamiento de pedidos de alto rendimiento de WooCommerce (HPOS).
La lista de oficinas se guarda en caché durante 24 horas. Si Econt no responde, 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.
El plugin 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
La oficina elegida 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 al crear el envío en e-Econt.
Pantalla de pedido del administrador: la oficina y el código de oficina se muestran debajo de la dirección de envío. Haz clic en Change para cargar la lista de oficinas y elegir otra ciudad y oficina. El cambio se guarda al momento y una nota del pedido registra la oficina anterior y la nueva.
Cliente: la oficina se muestra en la página de pedido del cliente y en la página de agradecimiento, y en los correos electrónicos de pedido (HTML y texto sin formato).
Los nombres de las oficinas se muestran en el idioma local (cirílico para Bulgaria) cuando el idioma del sitio es búlgaro o rumano, y en inglés en el resto de casos.
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 Econt. 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 comprobar el estado otra vez, 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 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, Econt no se muestra a los clientes en la finalización de compra. Los gestores de la tienda que han iniciado sesión sí la ven, marcada 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
Econt no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado, que el país de entrega es Bulgaria o Rumanía y que el método está añadido a la zona de ese país (o que Ignore zones está activado y el país está permitido). Comprueba que hay un precio para el país, los límites de peso, Minimum subtotal y Hide for shipping classes. Revisa la línea Office list de los ajustes: el método se oculta mientras no haya lista de oficinas para el país.
La lista de oficinas no se carga: haz clic en Load offices from Econt now y lee el resultado, o el aviso de la parte superior de la página de ajustes. Los errores se escriben en WooCommerce > Status > Logs, origen vfd-econt. Si Econt exige autorización para tu sitio, introduce 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 de tu tienda.
Otros países: los desarrolladores pueden añadir países con el filtro vfd_ecn_countries (código de 2 letras asignado a un código de 3 letras).
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 el servidor de licencias no responde, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Desactivar el plugin conserva todos los ajustes y solo borra la caché de oficinas. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin, y las listas de oficinas en caché, siempre se eliminan. Los ajustes y los métodos de zona se eliminan solo si Remove data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Las oficinas guardadas en los pedidos siempre se conservan, y los pedidos existentes mantienen sus líneas de envío.
Econt es una marca registrada de su respectivo propietario. Este plugin no está afiliado ni cuenta con el respaldo de Econt.