VibeFox iMile for WooCommerce — Ayuda
Requisitos
WordPress: 5.8 o posterior.
WooCommerce: 5.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
Tarifa de iMile: los precios que acordaste con el equipo comercial de iMile. Los introduces en la tabla de precios en la moneda de tu tienda.
Cuenta de API de iMile (solo para la estimación en tiempo real): la estimación en tiempo real usa la OpenAPI de iMile "Estimated order delivery costs". Necesitas un Customer ID y una Secret key (la clave de API que iMile emite junto con tu Customer ID). Para un cliente de prueba, regístrate en el portal para desarrolladores de iMile (developer.imile.com). Las claves de producción las facilita tu gestor de cuenta de iMile. Si solo usas la tabla de precios, no necesitas claves de API.
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_imile a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox iMile, 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. Introduce tus precios de iMile en la Price table. Opcionalmente, completa la sección Live rates (API) y activa Live estimate (consulta Configuración).
6. Añade VibeFox iMile a una zona de envío en WooCommerce > Settings > Shipping > Shipping zones (por ejemplo, "United Arab Emirates"), 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 iMile. 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 único campo:
Title (zone): el nombre que ven los clientes para esta zona. Déjalo vacío para usar el Method title global.
Cada vez que guardas los ajustes, se borran las estimaciones de iMile en caché y los tokens de acceso. Cuando la estimación en tiempo real está activada pero no puede funcionar (sin claves, sin ciudad o país de origen, sin tipos de cambio, tabla de precios vacía), aparecen advertencias encima de los ajustes.
General
Enable/Disable: activa o desactiva el método en todas las zonas a la vez.
Method title: el nombre del método de envío que se muestra en el carrito y en la finalización de compra. Una zona puede sustituirlo. Por defecto: iMile.
Tarifas en tiempo real (API) (opcional)
Si iMile no devuelve ninguna estimación (sin claves, sin ciudad introducida todavía, error, tiempo de espera agotado, sin tipo de cambio), se usa la tabla de precios.
Live estimate: actívala para obtener el coste de envío de iMile. Por defecto: desactivada. Con la estimación en tiempo real desactivada, no se envía nada a iMile durante la finalización de compra.
Environment: Production (openapi.imile.com) (por defecto) o Test (test-openapi.52imile.cn). Las claves de prueba solo funcionan con el servidor de pruebas y dan precios de prueba.
Customer ID: el código de cliente (customerId) que emite iMile, por ejemplo C2102192601.
Secret key: la clave secreta (clave de API) que emite iMile junto con el Customer ID. Firma las solicitudes.
Signature: cómo se firman las solicitudes.
Ship-from country: el país desde el que envías. Por defecto es el país de tu tienda. La lista contiene los países para los que el plugin tiene códigos de país de iMile.
Ship-from city: la ciudad desde la que se envían tus paquetes, escrita como aparece en la lista de ciudades de iMile (por ejemplo, Dubai, Riyadh). Déjalo vacío para usar la ciudad de la tienda de WooCommerce > Settings > General.
Ship-from province: opcional, por ejemplo Dubai o Riyadh Province.
iMile service: el tipo de pedido que se envía a iMile: Delivery order (100) (por defecto) o Express order (1100). El servicio express debe estar habilitado en tu cuenta y en tu país.
Goods category: el tipo de mercancía que se envía a iMile: Normal goods (por defecto), Sensitive (cosmetics, liquids...), With battery, Batteries / power banks, Documents o Parcel.
Exchange rates: iMile calcula en la moneda del país de destino. Introduce una línea por moneda con el precio de 1 unidad en la moneda de tu tienda, por ejemplo "AED = 0.25" o "SAR = 0.24". Se aceptan tanto el punto como la coma como separador decimal. No hace falta un tipo de cambio para la propia moneda de la tienda. Sin tipo de cambio, las estimaciones en esa moneda no se usan y se utiliza la tabla de precios en su lugar. El mismo tipo de cambio convierte el valor declarado del carrito a iMile. Las líneas no válidas se eliminan al guardar.
Precios (se usa cuando la estimación en tiempo real está desactivada, y como alternativa cuando iMile no devuelve ninguna estimación)
Introduce tu tarifa de iMile en la moneda de la tienda. Si está en AED, SAR u otra moneda, conviértela antes.
Price table: una fila por país de destino. Haz clic en + Add country para añadir una fila y en la cruz para eliminar una. Elige * All other countries para una fila que cubra todos los países sin fila propia. Cada fila tiene un Base price y columnas de peso opcionales: XS ≤1 kg, S ≤2 kg, M ≤3 kg, L ≤5 kg y XL >5 kg. Una columna de peso vacía (o 0) usa el precio base. Un precio base de 0 significa envío gratuito a ese país. Se aceptan tanto "9.99" como "9,99". Las filas sin precio, los códigos de país no válidos y los precios negativos se eliminan al guardar. Solo se conserva una fila por país.
Price for countries not in the table: un precio en la moneda de la tienda. Se usa cuando la tabla no tiene fila para el país de destino (y tampoco hay fila *), o la fila no tiene precio para este peso. Déjalo vacío para ocultar el método en ese caso.
Price applies: cómo se cobra el precio de la tabla.
La misma elección se aplica a la estimación en tiempo real: por pedido envía un único paquete con todo el carrito; por artículo solicita cada paquete distinto y multiplica por el número de unidades. Si el carrito tiene más de 5 paquetes distintos, se usa la tabla de precios.
Los pesos de los productos se convierten de la unidad de peso de tu tienda a kilogramos.
Condiciones
Minimum weight (kg): oculta el método cuando el carrito pesa menos. 0 significa sin límite.
Maximum weight (kg): oculta el método cuando el carrito pesa más. Por defecto: 30. 0 significa sin límite.
Minimum order amount: muestra el método solo cuando el subtotal del carrito (después de descuentos, antes de impuestos) alcanza este importe. Déjalo vacío para mostrarlo siempre.
Free shipping from: el subtotal del carrito (después de descuentos, antes de impuestos) a partir del cual el envío con iMile es gratuito. Déjalo vacío para no ofrecer nunca envío gratuito.
Excluded shipping classes: oculta el método cuando el carrito contiene un producto de cualquiera de estas clases de envío de WooCommerce.
Tax status: Taxable añade el impuesto de WooCommerce al coste de envío; None no lo añade. Elige None si los precios de la tabla y las estimaciones de iMile ya incluyen el IVA.
Disponibilidad sin zonas de envío
Ignore shipping zones: ofrece iMile para los países indicados abajo, aunque el método no esté añadido a ninguna zona de envío.
Countries: los países de destino para ese modo. Déjalo vacío para usar todos los países a los que envías. Este campo solo se usa cuando Ignore shipping zones está activado.
Avanzado
Debug log: escribe los cálculos de tarifas en WooCommerce > Status > Logs (origen "vfd_imile"). No se registran claves ni direcciones de clientes. Las solicitudes fallidas a iMile siempre se registran, aunque el registro de depuración esté desactivado. Desactiva el registro cuando termines.
Remove data on uninstall: si está activado, al eliminar el plugin se borran todos los ajustes de iMile, los métodos de zona y las estimaciones en caché. Desactivar el plugin nunca borra nada.
Cómo funciona en la finalización de compra
Cuando el cliente introduce una dirección de entrega, WooCommerce pide al plugin una tarifa. Primero el plugin comprueba las condiciones: país de entrega, peso del carrito, importe mínimo del pedido y clases de envío excluidas. Si se aplica el envío gratuito, el cliente ve el método sin coste y no se envía ninguna solicitud a iMile.
Con la estimación en tiempo real activada, el plugin envía a iMile el país, la provincia y la ciudad de origen; el país, el estado, la ciudad y el código postal de destino; el peso del carrito en kg; el tamaño en cm³ (a partir de las dimensiones del producto); el valor del carrito; el servicio de iMile y la categoría de mercancía. La estimación siempre se solicita como prepagada, así que no se incluyen las comisiones de pago contra reembolso. La estimación en tiempo real se solicita solo después de que el cliente haya introducido una ciudad, y solo cuando todos los paquetes tienen peso. Cada respuesta se guarda en caché durante 1 hora. Una solicitud fallida se guarda en caché durante 5 minutos. Tras un tiempo de espera o un error del servidor, no se consulta a iMile durante 2 minutos; tras claves rechazadas, durante 5 minutos, para que la finalización de compra no espere a iMile en cada actualización. El tiempo de espera de la API es de 12 segundos. Un token de acceso caducado se renueva automáticamente.
La estimación se convierte a la moneda de la tienda con tus tipos de cambio. Si iMile no devuelve una estimación utilizable (claves sin configurar, ciudad sin introducir, ciudad desconocida, error, tiempo de espera, sin tipo de cambio), el cliente no ve ningún error y se usa el precio de la tabla. Si la tabla tampoco tiene precio, el método se oculta. El motivo se escribe en el registro.
El método funciona en la finalización de compra clásica y en los bloques de Carrito y Finalizar compra. Es compatible con el almacenamiento de pedidos de alto rendimiento de WooCommerce (HPOS).
El plugin solo calcula tarifas. No crea envíos de iMile, no imprime etiquetas AWB, no solicita recogidas, no hace seguimiento de paquetes, no concilia los pagos contra reembolso ni ofrece puntos de recogida ni taquillas. Usa el portal de iMile para los envíos.
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 iMile. 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 volver a comprobar el estado, Change key para introducir otra clave y Remove key para eliminarla 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. Eliminar la clave de un sitio no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.
Sin una clave activa, iMile 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 requieren una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
iMile no aparece en la finalización de compra: comprueba que la licencia está activa, que Enable/Disable está activado 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). Revisa los límites de peso, Minimum order amount y Excluded shipping classes. Comprueba que el país o * tiene una fila en la Price table, o que Price for countries not in the table está definido.
Se muestra la tarifa de la tabla en lugar de la estimación de iMile: abre WooCommerce > Status > Logs, origen "vfd_imile", y activa Debug log para ver los detalles. Motivos habituales: Live estimate está desactivada, faltan las claves, el cliente aún no ha introducido una ciudad, iMile no reconoce la ortografía de la ciudad, los productos no tienen peso, no hay tipo de cambio para la moneda de destino o hay un error de la API. Revisa también las advertencias encima de los ajustes.
"sign is invalid" en el registro: revisa la Secret key y luego prueba Signature = SimpleKey.
Las claves son rechazadas: revisa el Customer ID, la Secret key y el Environment. Las claves de prueba solo funcionan con el servidor de pruebas.
Los nombres de las ciudades no coinciden: los nombres deben coincidir con la lista de ciudades de iMile. Los desarrolladores pueden asignarlos con el filtro vfd_imile_live_request, y los códigos de país con el filtro vfd_imile_live_country_code.
Los precios están en una moneda incorrecta: la tabla de precios está en la moneda de la tienda (WooCommerce > Settings > General). Convierte una tarifa en AED, SAR o MXN al introducirla. Las estimaciones en tiempo real se convierten con Exchange rates.
El impuesto se cobra dos veces en el envío: si tus precios ya incluyen el IVA, define Tax status como None.
Las estimaciones parecen desactualizadas tras un cambio: guarda la página de ajustes. Esto borra las estimaciones de iMile en caché.
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 conserva todos los datos. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin siempre se eliminan. Los ajustes, los métodos de zona y las estimaciones en caché se eliminan solo si Remove data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los pedidos existentes conservan sus líneas de envío.
iMile es una marca comercial de su respectivo propietario. Este plugin no está afiliado a iMile ni cuenta con su respaldo.