VibeFox Econt for OpenCart — Ayuda
Requisitos
OpenCart: 3.0.x (probado en 3.0.5.0) o 4.0.2 y posteriores (probado en 4.1.0.3).
PHP: 8.0 o posterior.
Países: Bulgaria y Rumanía deben estar activados en System > Localisation > Countries.
Econt: no se necesita contrato ni clave de API. La lista de oficinas es una nomenclatura pública de Econt. Solo se envía el código de país a Econt, no datos de clientes. Introduce un nombre de usuario y una contraseña de e-Econt solo si Econt pide a tu tienda una autorización. El inicio de sesión de e-Econt se describe en la página de desarrolladores de Econt (econt.com/developers).
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un dominio.
Instalación
La descarga es un único archivo zip con los paquetes para ambas versiones de OpenCart. Descomprímelo en tu ordenador. Contiene README.txt, el paquete de OpenCart 3 vfd_econt-oc3-(versión).ocmod.zip y el paquete de OpenCart 4 vfd_econt.ocmod.zip. Instala solo el paquete de tu versión de OpenCart. La clave de licencia es la misma para ambas versiones.
OpenCart 3
1. En el administrador, ve a Extensions > Installer, haz clic en Upload y elige el archivo vfd_econt-oc3-(versión).ocmod.zip. La extensión no añade modificaciones OCMOD, así que no necesitas actualizar Extensions > Modifications. En lugar del instalador, puedes copiar el contenido de la carpeta upload de este paquete en la carpeta raíz de tu tienda.
2. Ve a Extensions > Extensions y elige el tipo de extensión Shipping. Busca VibeFox Econt y haz clic en Install (el botón verde +).
3. Haz clic en Edit (el botón del lápiz) para abrir la página de ajustes.
4. Introduce tu clave de licencia de VibeFox en License key del bloque de licencia de la parte superior de la página Edit y haz clic en Activate (consulta License key).
5. Define los precios por país y revisa las demás opciones (consulta Configuration), activa Enable/Disable y haz clic en Save. Haz clic en Load offices from Econt now para probar la conexión.
OpenCart 4
1. En el administrador, ve a Extensions > Installer, haz clic en Upload y elige el archivo vfd_econt.ocmod.zip. No cambies el nombre del archivo: OpenCart 4 toma el código de la extensión del nombre del archivo, y un paquete renombrado no funciona.
2. El paquete aparece en la lista de extensiones instaladas en la misma página. Haz clic en Install (el botón verde +) junto a él.
3. Ve a Extensions > Extensions y elige el tipo de extensión Shipping. Busca VibeFox Econt, haz clic en Install (el botón verde +) y después en Edit (el botón del lápiz).
4. Introduce la clave de licencia y los ajustes como en los pasos 4 y 5 de OpenCart 3. La página de ajustes y sus campos son los mismos en ambas versiones.
Tras la instalación, el método está desactivado hasta que actives Enable/Disable y guardes. Si vuelves a instalar la extensión después de desinstalarla, se usan de nuevo los ajustes que conservaste.
Configuración
Todos los ajustes están en la página de la extensión: Extensions > Extensions > Shipping > VibeFox Econt > Edit. Las secciones aparecen a la izquierda. Un botón Save guarda toda la página sin recargarla. Solo los usuarios administradores con el permiso de modificación para esta extensión pueden guardar los ajustes, cargar las oficinas o vaciar el registro.
En la parte superior de la página, la extensión muestra advertencias: la API de demostración está activada, no hay ningún precio definido para Bulgaria o Rumanía (en ese caso el método nunca se muestra), la última solicitud de oficinas para un país ha fallado, o tu tienda no tiene una clase de peso con la unidad kg (los pesos de los productos se leen entonces según el nombre de su unidad: kg, g, lb u oz). 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. Lo mismo ocurre con un Name vacío o de más de 64 caracteres, un Sort order que no es un número entero, o una clase de impuesto o una zona geográfica desconocidas.
General
Enable/Disable: muestra u oculta la entrega de Econt en la finalización de compra. Predeterminado: desactivado.
Name: el nombre del método de envío que se muestra en el carrito y en la finalización de compra. Predeterminado: Econt Express. Obligatorio, máximo 64 caracteres.
Sort order: la posición entre los métodos de envío en la finalización de compra. Un número entero.
Tax class: la clase de impuesto del precio de envío, o --- None --- (predeterminado). OpenCart añade este impuesto sobre los precios de abajo. Con --- None --- los precios son definitivos.
Lista de oficinas de Econt
Las oficinas y los Econtomats 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 ID distintos de los reales. En modo demostración se usa la cuenta de prueba pública de Econt si no hay un inicio de sesión configurado.
Econt username: opcional. Tu inicio de sesión de 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 para cambiarlo.
Remove the saved password: actívalo y haz clic en Save para borrar la contraseña guardada.
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 de inmediato las listas de Bulgaria y Rumanía y muestra el resultado por país. Si una carga falla, se conservan las oficinas de la última carga correcta. Sin este botón, la lista se carga automáticamente en la primera finalización de compra. Si cambias Demo API, el nombre de 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. La extensión no consulta a Econt 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 (estos 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. Las entradas con otro formato se ignoran y se indican en una advertencia al guardar. El resto se guarda.
Calculation: Per order (predeterminado) 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 aparece arriba. Vacío o 0 oculta el método allí.
Condiciones
Subtotal del carrito significa los productos que necesitan envío, después del cupón 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 método solo cuando el subtotal del carrito es 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 su clase de peso 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.
Disponibilidad
Econt entrega solo en Bulgaria y Rumanía. Normalmente la zona geográfica decide dónde se ofrece el método; con Ignore geo zone, deciden en su lugar los países seleccionados.
Geo zone: ofrece Econt solo a direcciones de esta zona geográfica. All Zones (predeterminado) significa en todo Bulgaria y Rumanía. Las zonas geográficas se gestionan en System > Localisation > Geo Zones. La zona geográfica no se usa con Ignore geo zone.
Ignore geo zone: no se comprueba la zona geográfica. Econt se ofrece en los países de abajo, esté o no la dirección en la zona geográfica.
Countries: Bulgaria y/o Rumanía. Solo se usa con Ignore geo zone. Si no se selecciona ninguno, significa todos los países de Econt.
Avanzado
Debug log: escribe mensajes de depuración en storage/logs/vfd_ecn_debug.log.php (en OpenCart 4, system/storage/logs/vfd_ecn_debug.log.php). El archivo no se puede leer desde la web. Al llegar a 5 MB, se inicia un registro nuevo. Los errores y advertencias de la API (Econt no disponible, sin oficinas, un pedido sin oficina) 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 la extensión se borran los ajustes de Econt, el registro y las elecciones de las finalizaciones de compra sin terminar. Si está desactivado, los ajustes se conservan para una reinstalación. Las oficinas guardadas en los pedidos siempre se conservan.
Importación / Exportación
Export: haz clic en Download JSON para guardar los ajustes como archivo JSON. La contraseña no se exporta.
Import: pega un JSON exportado previamente y haz clic en Import para restaurar los ajustes, por ejemplo en otra tienda. Los valores se comprueban como en un guardado normal. La contraseña guardada se conserva.
Cómo funciona en la finalización de compra
El método se ofrece solo para Bulgaria y Rumanía. Cuando OpenCart muestra los métodos de envío, pide a la extensión el precio de Econt. Con Ignore geo zone, no se comprueba la zona geográfica y el método se ofrece solo en los Countries seleccionados (ninguno seleccionado = Bulgaria y Rumanía). En caso contrario, si hay una Geo zone definida, la dirección debe estar en ella. Solo cuentan los productos con Requires Shipping establecido en Yes: los demás productos no añaden peso ni se incluyen en el subtotal. La extensión comprueba los límites de peso y el subtotal mínimo, y luego 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 va a una oficina. El precio se calcula en tu moneda predeterminada y se muestra al cliente en su moneda con el impuesto de la Tax class seleccionada.
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, solo cuando se selecciona Econt. Los Econtomats aparecen marcados en la lista. La elección se guarda al instante. Si la lista de oficinas no se puede cargar, el cliente ve el mensaje 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 del método de envío, la extensión comprueba en el servidor que se ha elegido una oficina y que existe 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.
En OpenCart 4 el cliente hace clic en Choose en el bloque del método de envío de la página de finalización de compra y elige Econt en la ventana Shipping method options. Las listas City y Office / Econtomat aparecen en esa ventana debajo del método y funcionan como se ha descrito antes. El botón Continue de la ventana no avanza sin una oficina válida, con los mismos mensajes.
La lista de oficinas se guarda en caché durante 24 horas, por separado para la API en vivo y la de demostración y para cada país. 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. La lista de oficinas procede de https://ee.econt.com/services/ (en vivo) o https://demo.econt.com/ee/services/ (demostración).
La extensión usa solo precios fijos. No consulta a Econt tarifas en tiempo real, no crea guías de envío ni etiquetas, no encarga mensajeros, 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
Cuando se realiza el pedido, la oficina elegida en la finalización de compra 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.
Cliente: la oficina se añade al método de envío del pedido, por ejemplo Econt Express - Econt office / Econtomat: city, office (address) (máximo 128 caracteres; en OpenCart 4 el texto no se acorta). Así aparece en el historial de pedidos del cliente, en los correos del pedido, en la factura y en el pedido del administrador. OpenCart 4 mantiene un solo pedido para la finalización de compra y lo actualiza cada vez que el cliente vuelve a confirmar, y la oficina del pedido se actualiza con él.
Página del pedido del administrador: en Sales > Orders, el panel Econt office / Econtomat situado encima del historial muestra la oficina y su código, también cuando el método se desactiva más tarde. Bajo Change, elige otra ciudad y oficina del país del pedido y haz clic en Save. El panel muestra Saved., se actualiza el texto del método de envío del pedido y una nota en el historial del pedido (no enviada al cliente) registra la oficina anterior y la nueva. Si haces clic en Save sin elegir una oficina, el panel dice Select a city and an office first - nothing was changed. Una oficina que no está en la lista del país del pedido se rechaza con The selected Econt office is not available for the shipping country - nothing was changed. Cualquier usuario administrador con el permiso de modificación de pedidos puede cambiar la oficina; no hace falta acceso a los ajustes de la extensión. Si la lista de oficinas no se puede cargar, el panel muestra Econt offices cannot be loaded right now. Un pedido realizado sin oficina muestra No Econt office is saved for this order., y el registro tiene un error para él.
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
La extensión funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Econt es el primer bloque de Extensions > Extensions > Shipping > VibeFox Econt > Edit, 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 comprobar el estado de nuevo, Change key para introducir otra clave y Remove key para quitar la clave de esta tienda. Debajo está la línea Product: opencart-shipping-econt y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los usuarios administradores con el permiso Modify para la extensión pueden cambiar la clave. Los textos del bloque siguen el idioma del administrador (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 y 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, la extensión sigue funcionando con el último estado conocido.
Una clave funciona en un dominio: la dirección de la tienda de la configuración de OpenCart. Quitar 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 método de envío de Econt no se muestra a los clientes en la finalización de compra y no se calcula ninguna tarifa. Un usuario administrador que haya iniciado sesión en el administrador en el mismo navegador sigue viendo el método en la tienda, marcado como (unlicensed — visible to admins only), para que puedas configurar y probar la extensión antes de comprar una clave. En OpenCart 4 esta vista previa no está disponible: la tienda no ve el inicio de sesión del administrador, así que sin una clave activa el método se oculta para todos. Después de abrir la página Edit una vez, aparece un recordatorio en el Dashboard del administrador. Ciérralo con × para ocultarlo durante 7 días. Los pedidos existentes no se ven afectados.
Cuando una licencia caduca, la extensión sigue funcionando, pero las actualizaciones y el soporte necesitan una renovación. El estado se vuelve a comprobar automáticamente al abrir el Dashboard del administrador o la página Edit: 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 tarea cron. Al desinstalar la extensión siempre se eliminan 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 es Bulgaria o Rumanía (activado en System > Localisation > Countries). Revisa Geo zone (o Ignore geo zone y Countries), que hay un precio definido para el país, los límites de peso y Minimum subtotal. Revisa la línea Office list de los ajustes: el método se oculta mientras no haya lista de oficinas para el país. Comprueba que los productos tienen Requires Shipping establecido en Yes.
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 mira 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 su moneda.
El impuesto se cobra sobre el precio: hay una clase de impuesto seleccionada. Define Tax class como --- None --- si tus precios ya incluyen el IVA.
La página muestra "Warning: You do not have permission to modify VibeFox Econt!": tu grupo de usuarios administradores solo puede ver los ajustes. Concede al grupo el permiso de modificación para extension/shipping/vfd_econt (OpenCart 3) o extension/vfd_econt/shipping/vfd_econt (OpenCart 4) en System > Users > User Groups.
Desinstalación
Ve a Extensions > Extensions, elige el tipo Shipping y haz clic en Uninstall (el botón rojo −) junto a VibeFox Econt. La clave de licencia y el estado de la licencia de esta extensión siempre se eliminan. OpenCart siempre restablece Enable/Disable, Sort order, Tax class y Geo zone. La extensión siempre elimina sus eventos y las listas de oficinas en caché. Si Remove data on uninstall está activado, también se borran los demás ajustes, el registro y las elecciones de las finalizaciones de compra sin terminar. Si está desactivado, los ajustes se conservan y se vuelven a usar al reinstalar la extensión. Las oficinas guardadas en los pedidos siempre se conservan, y los pedidos existentes mantienen su método de envío y su coste.
En OpenCart 4, para eliminar también los archivos de la extensión, ve a Extensions > Installer después de la desinstalación y haz clic en Uninstall (el botón naranja −) junto a VibeFox Econt en la lista de extensiones instaladas, y luego en Delete (el botón rojo de papelera) para eliminar el paquete subido.
Econt es una marca comercial de su propietario. Esta extensión no está afiliada a Econt ni cuenta con su respaldo.