VibeFox Omniva 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.
Omniva: no se necesita una cuenta de API. Omniva no tiene una API pública de precios. La API OMX de Omniva solo está disponible para clientes con contrato y este plugin no la usa, así que introduces tus propios precios (de contrato). Registra los paquetes en tu cuenta empresarial de Omniva.
Parcel machine list: el plugin descarga el archivo abierto de ubicaciones de Omniva desde omniva.ee (no se necesita clave ni contrato). Tu servidor debe poder hacer solicitudes HTTPS salientes a www.omniva.ee.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo 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_omniva a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox Omniva, 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 (ver Clave de licencia).
5. Revisa los precios por país y tamaño de paquete, los tamaños de paquete y la línea de estado de Parcel machine list.
6. Añade VibeFox Omniva a tu zona de Estonia, Letonia y/o Lituania en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore shipping zones y elige los países.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox Omniva. 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 ve el cliente para esta zona. Déjalo vacío para usar el Method title general.
En la parte superior de la página, los avisos muestran los problemas. Un aviso rojo aparece cuando no hay ningún precio configurado o cuando no se pudo descargar la lista de terminales de paquetes y no hay copia guardada, porque entonces el método no se muestra en la finalización de compra. Un aviso amarillo aparece cuando la lista no se pudo actualizar en ese momento y se usa la copia guardada. Los números que no se pueden leer se notifican tras guardar y no se guardan.
General
Enable/Disable: activa o desactiva Omniva en todas las zonas a la vez.
Method title: el nombre del método de envío que ve el cliente. El Title de un método de zona lo sustituye. Por defecto: Omniva parcel machine.
Tax status: Taxable añade el impuesto de WooCommerce al coste del envío; None no lo añade.
Precios (en la moneda de tu tienda; los decimales se pueden escribir como 3.50 o 3,50)
Price by parcel size: una fila para cada país (Estonia, Letonia y Lituania), con las columnas S, M, L, XL y Free from. Introduce el precio de cada tamaño de paquete de Omniva para el país de destino. Una celda vacía significa que ese tamaño no se ofrece en ese país: el método se oculta cuando el paquete lo necesita. 0 significa gratis. Free from es el total del carrito (después de descuentos, como se muestra en el carrito) a partir del cual la entrega a ese país es gratuita; déjalo vacío si no hay envío gratis. Hasta que guardes tus propios precios, la tabla empieza con 3.50 para Estonia y 4.00 para Letonia y Lituania. Cuando los impuestos de WooCommerce están activados, un pequeño botón -% junto a cada precio quita el IVA del país de tu tienda del precio introducido (para precios que conoces con IVA incluido).
Calculation: cómo se determinan el tamaño del paquete y el precio.
Parcel sizes (cm): las dimensiones máximas de cada tamaño, como Smallest side, Middle side y Largest side. Las dimensiones del producto se ordenan del mismo modo y se comparan lado a lado; los valores se ordenan al guardar. Las dimensiones del producto se convierten de la unidad de la tienda a cm. Los productos sin dimensiones caben en el tamaño S. Si ningún tamaño cabe, el método se oculta. Valores por defecto: S 9 x 38 x 64, M 19 x 38 x 64, L 38 x 39 x 64, XL 39 x 64 x 64. Compáralos con los tamaños de paquete vigentes de Omniva.
Disponibilidad
Minimum weight (kg): oculta el método cuando el carrito pesa menos. Vacío o 0 significa sin límite.
Maximum weight (kg): oculta el método cuando el carrito (o, con Per item, un artículo) pesa más. Los terminales de paquetes de Omniva aceptan paquetes de hasta 30 kg. Por defecto: 30. 0 significa sin límite. La unidad de peso de la tienda se convierte a kg.
Minimum cart total: muestra el método solo a partir de este total del carrito. Déjalo vacío para mostrarlo siempre.
Excluded shipping classes: oculta el método cuando el carrito contiene productos de estas clases de envío de WooCommerce.
Ignore shipping zones: ofrece Omniva para los países indicados abajo sin añadirlo a una zona. Cuando está desactivado, los países se definen por las zonas de envío donde se añade el método. Se recomienda dejarlo desactivado.
Countries (without zones): los países de destino para ese modo. Este campo solo se usa cuando Ignore shipping zones está activado. Déjalo vacío para todos los países de envío. En cualquier modo, Omniva solo se ofrece donde tiene terminales de paquetes: Estonia, Letonia y Lituania.
Terminales de paquetes
Post offices: ofrece también las oficinas de correos de Omniva en la misma lista. Omniva tiene oficinas de correos en Estonia. Desactivado por defecto.
City order: muestra primero las ciudades más grandes (Tallinn, Riga, Vilnius y otras) y después el resto por orden alfabético. Activado por defecto. Si está desactivado, las ciudades se ordenan alfabéticamente.
Parcel machine list: una línea de estado con el número de terminales de paquetes por país (y de oficinas de correos, si están activadas) y la hora de la última descarga desde omniva.ee. Haz clic en Update the list now para descargar la lista de inmediato; si omniva.ee no responde, se mantiene la copia guardada.
Avanzado
Debug log: registra los detalles del cálculo de precios y de la lista de terminales de paquetes en WooCommerce > Status > Logs (fuente vfd-omniva). Los errores, como una lista de terminales no disponible, siempre se registran. No se registran datos de clientes.
Remove data on uninstall: cuando está activado, al eliminar el plugin se borran los ajustes, los métodos de zona y la lista guardada de terminales de paquetes. Desactivar el plugin nunca borra los ajustes. El terminal de paquetes guardado en los pedidos se conserva.
Cómo funciona en la finalización de compra
Cuando el cliente introduce una dirección de entrega en Estonia, Letonia o Lituania, WooCommerce pide una tarifa al plugin. El plugin comprueba el peso del carrito, el total mínimo y las clases de envío excluidas, y después determina el tamaño del paquete a partir de las dimensiones del producto. Si el paquete no cabe en ningún tamaño, o el tamaño no tiene precio para el país, o no hay ningún terminal de paquetes disponible, el método se oculta, de modo que el cliente nunca ve una finalización de compra que no se pueda completar. Si el total del carrito alcanza el Free from del país, el precio es 0. El tamaño del paquete se guarda en la línea de envío del pedido como Omniva parcel size.
La lista de terminales de paquetes se descarga de omniva.ee una vez al día y se guarda en la base de datos de WordPress, no en la carpeta del plugin. Si la descarga falla, la copia guardada sigue funcionando y el siguiente intento se hace a los 15 minutos, para que la finalización de compra no espere a omniva.ee en cada actualización. El tiempo límite de descarga es de 15 segundos.
El método funciona en la finalización de compra clásica y en los bloques Carrito y Finalizar compra. Es compatible con el almacenamiento de pedidos de alto rendimiento de WooCommerce (HPOS). Los precios están en la moneda de tu tienda. El plugin no convierte monedas.
El plugin no solicita precios a Omniva, no registra envíos, no imprime etiquetas, no llama a un mensajero ni hace seguimiento de paquetes. Registra los paquetes en tu cuenta empresarial de Omniva. La entrega a domicilio por mensajero no forma parte de este método.
Puntos de recogida
Cuando el cliente selecciona Omniva, aparecen debajo del método dos listas: -- Select city -- y -- Select parcel machine --. Solo se muestran las ciudades y los terminales de paquetes del país de entrega; cuando el cliente cambia el país, las listas también cambian. En Estonia, las ciudades son condados, y Tallinn, Tartu y Pärnu aparecen por separado; en Letonia y Lituania son ciudades y municipios. La ciudad de la dirección de envío se preselecciona cuando coincide con una ciudad de la lista. Cada terminal de paquetes se muestra con su nombre y dirección. La elección se recuerda durante la finalización de compra, así que no se pierde cuando esta se actualiza.
El terminal de paquetes es obligatorio. En la finalización de compra clásica, el cliente ve Please select an Omniva parcel machine. En la finalización de compra por bloques, Place order está bloqueado hasta que se elige un terminal de paquetes. En ambas, el servidor vuelve a comprobar el terminal contra la lista, así que un ID falsificado o un terminal de otro país se rechaza.
El ID, el nombre, la ciudad y el país del terminal de paquetes se guardan en el pedido. Se muestran en la pantalla del pedido, debajo de la dirección de envío (con el ID del terminal), en la página de pedido recibido, en My account > Orders y en los correos del pedido (HTML y texto sin formato) como Omniva parcel machine.
Para cambiar el terminal de paquetes de un pedido, abre el pedido en WooCommerce > Orders, haz clic en Change junto al terminal de paquetes, elige una ciudad y un terminal del país de entrega del pedido, y haz clic en Save parcel machine. Una nota del pedido registra el terminal anterior y el nuevo.
Clave de licencia
El plugin funciona con una clave de licencia de VibeFox comprada en vibefox.net. El bloque de licencia está en la parte superior de WooCommerce > Settings > Shipping > VibeFox Omniva. 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 solo 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, Omniva 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 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 necesitan una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
Omniva 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 Estonia, Letonia o Lituania, y que el método está añadido a la zona del país del cliente (o que Ignore shipping zones está activado y el país está permitido). Abre la página de ajustes: un aviso rojo explica si no hay ningún precio o si no hay lista de terminales de paquetes. Revisa también las dimensiones de los productos (un paquete más grande que el tamaño XL, o un tamaño con una celda de precio vacía, oculta el método), los límites de peso, el Minimum cart total y las Excluded shipping classes. Con Debug log activado, WooCommerce > Status > Logs (fuente vfd-omniva) muestra por qué se ocultó el método.
No hay terminales de paquetes: la lista no se pudo descargar de omniva.ee y no hay copia guardada. El plugin lo reintenta cada 15 minutos. Haz clic en Update the list now; si falla, comprueba que tu servidor puede acceder a www.omniva.ee y consulta el error en WooCommerce > Status > Logs.
Falta un terminal de paquetes nuevo: la lista se actualiza una vez al día. Haz clic en Update the list now para descargarla de inmediato.
Se cobra un precio incorrecto: el precio depende del tamaño de paquete determinado a partir de las dimensiones del producto. Revisa las dimensiones de los productos, Calculation y Parcel sizes (cm). Con Debug log activado, el registro muestra el tamaño elegido y el precio.
El cliente no puede realizar el pedido: hay que elegir un terminal de paquetes. Si el cliente ve «The Omniva parcel machine list is temporarily unavailable», no hay terminales de paquetes disponibles en este momento; consulta «No hay terminales de paquetes».
Moneda de los precios: la moneda de tu tienda. El plugin no convierte monedas.
Para desarrolladores: el filtro vfd_omniva_locations_url cambia la dirección del archivo de ubicaciones (CSV en formato Omniva), y vfd_omniva_countries cambia la lista de países de destino (por defecto EE, LV, LT).
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 no se puede acceder al servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Desactivar el plugin mantiene todos los ajustes y la lista guardada de terminales de paquetes. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia, el estado de licencia y las cachés de este plugin siempre se eliminan. Los ajustes, los métodos de zona y la lista guardada de terminales de paquetes se eliminan solo si Remove data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. El terminal de paquetes guardado en los pedidos nunca se borra, y los pedidos existentes conservan sus líneas de envío.
Omniva es una marca comercial de su respectivo propietario. Este plugin no está afiliado a Omniva ni cuenta con su respaldo.