VibeFox Aramex 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.

Cuenta de Aramex (solo para tarifas en tiempo real): las tarifas en tiempo real usan la API Aramex Rate Calculator. Aramex da acceso a la API a sus titulares de cuenta. Pregunta a tu gestor de cuenta de Aramex o consulta el Aramex Developers Solution Center en el sitio web de Aramex. Necesitas seis valores: nombre de usuario de la API (normalmente una dirección de correo electrónico), contraseña, número de cuenta, PIN de la cuenta, entidad de la cuenta (por ejemplo, DXB) y código de país de la cuenta (por ejemplo, AE). Si solo usas precios fijos por país, no necesitas una cuenta de Aramex.

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_aramex a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Shipping > VibeFox Aramex, 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. Elige cómo se calcula el coste de envío y completa las secciones correspondientes (consulta Configuración).

6. Añade VibeFox Aramex a una zona de envío 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 Aramex. Se aplican a todas las zonas de envío. Cuando añades el método a una zona, la ventana de la zona tiene solo un 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 tarifas de Aramex en caché.

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. Por defecto: Aramex.

Shipping cost: cómo se calcula el precio.

El motivo de que falte una tarifa en tiempo real se escribe en el registro de depuración. Nunca se muestra al cliente.

Cuenta de API de Aramex (necesaria solo para tarifas en tiempo real; los seis campos son obligatorios)

Username: tu nombre de usuario de la API de Aramex, normalmente una dirección de correo electrónico.

Password: tu contraseña de la API de Aramex.

Account number: tu número de cuenta de cliente de Aramex.

Account PIN: el PIN de tu cuenta de Aramex.

Account entity: el código de entidad (oficina) de tu cuenta de Aramex, por ejemplo DXB, AMM o RUH.

Account country code: el código de país de dos letras de tu cuenta de Aramex, por ejemplo AE.

Servicio de Aramex (se usa para tarifas en tiempo real)

Si la dirección de entrega está en el país de origen, el envío se cotiza como nacional. Todos los demás envíos se cotizan como internacional urgente.

International service: el producto de Aramex para envíos al extranjero: PPX Priority Parcel Express (por defecto), PDX Priority Document Express, PLX Priority Letter Express, DPX Value Express Parcels, EPX Economy Parcel Express, EDX Economy Document Express, GPX Ground Parcel Express o GDX Ground Document Express.

Domestic service: el producto de Aramex para envíos dentro del país de origen: ONP Overnight Parcel (por defecto), OND Overnight Document, SMP Same Day Parcel, SMD Same Day Document, SDD Same Day Delivery, EMD Early Morning Delivery, PEC Economy Delivery, PEX Road Express o HVY Heavy (20 kg o más).

Payment type: quién paga a Aramex el envío: Prepaid (paga el remitente), Collect (paga el destinatario) o Third party. Normalmente Prepaid.

API weight unit: la unidad que se envía a Aramex, KG o LB. Los pesos de los productos se convierten desde la unidad de peso de tu tienda. El peso facturable es el mayor entre el peso real y el peso volumétrico (largo × ancho × alto en cm / 5000). El mínimo es 0.5 kg, que también se aplica a los productos sin peso.

Currency conversion rate: se pide a Aramex que cotice en la moneda de tu tienda. Si aun así responde en otra moneda, la tarifa se multiplica por este número (1 unidad de la moneda de Aramex = X unidades de la moneda de tu tienda). Déjalo vacío para rechazar estas cotizaciones, de modo que un cliente nunca pague en una moneda incorrecta. Se aceptan tanto el punto como la coma como separador decimal.

Envío desde (dirección de origen) (se usa para tarifas en tiempo real)

Origin country: el país desde el que envías. Por defecto es el país de tu tienda.

Origin city: la ciudad desde la que envías. Aramex la exige.

Origin state / emirate: opcional.

Origin postcode: opcional.

Si el país de origen es el país de tu tienda, los campos vacíos se toman de la dirección de la tienda en WooCommerce > Settings > General.

Precios fijos (se usan en el modo fijo y como alternativa para las tarifas en tiempo real)

Price per country: una tabla con códigos de país de dos letras y precios en la moneda de tu tienda. Haz clic en Add row para añadir un país y en la cruz para eliminar uno. Usa * como código de país para todos los demás países. Los países sin precio (cuando no hay una fila *) no reciben tarifa fija, por lo que el método se oculta para ellos.

Fixed price applies: Per order cobra el precio una sola vez. Per item lo multiplica por el número de artículos del carrito. Las tarifas en tiempo real de Aramex siempre son por envío.

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: 100. 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.

Excluded shipping classes: oculta el método cuando el carrito contiene un producto de cualquiera de estas clases de envío de WooCommerce.

Free shipping: activa el envío gratuito con Aramex a partir del importe indicado abajo.

Free shipping from: el subtotal del carrito (después de descuentos, antes de impuestos) a partir del cual el envío es gratuito. Se usa solo cuando Free shipping está activado.

Tax status: Taxable añade el impuesto de WooCommerce al coste de envío, None no lo añade. Las tarifas en tiempo real de Aramex pueden incluir ya el IVA. En ese caso elige None para no cobrar el impuesto dos veces.

Disponibilidad sin zonas de envío

Ignore shipping zones: ofrece Aramex 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 se usa solo cuando Ignore shipping zones está activado.

Avanzado

Debug log: escribe los cálculos de tarifas y los errores de la API en logs/vfd_armx_debug.log.php dentro de la carpeta del plugin. El archivo no se puede abrir desde la web. Las contraseñas, el PIN, el número de cuenta y las direcciones de los clientes se enmascaran. Desactiva el registro cuando termines.

Remove data on uninstall: si está activado, al eliminar el plugin se borran todos sus ajustes, métodos de zona, tarifas en caché y registros. Desactivar el plugin nunca borra nada.

Cómo funciona al finalizar la 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 como Aramex (free) y no se envía ninguna solicitud a Aramex.

En el modo fijo, el precio se toma de la tabla. En los modos en tiempo real, el plugin envía a Aramex las direcciones de origen y de entrega, el peso facturable, el servicio y la moneda de tu tienda, y muestra el total devuelto. Una tarifa en tiempo real se solicita solo después de que el cliente haya introducido una ciudad o un código postal. Cada respuesta se guarda en caché durante 1 hora, así que el mismo carrito no genera una nueva solicitud. Una solicitud fallida se guarda en caché durante 10 minutos, para que la compra no espere a Aramex en cada actualización. El tiempo de espera de la API es de 10 segundos.

Si Aramex devuelve un error, un importe cero o una cotización en otra moneda sin tasa de conversión, el cliente no ve ningún error. El método se oculta, o en el modo alternativo se usa el precio fijo. El motivo se escribe en el registro de depuración.

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 Aramex, no imprime etiquetas, no reserva recogidas, no hace seguimiento de paquetes ni permite a los clientes elegir una oficina de Aramex. El paquete se envía siempre a Aramex como una sola pieza.

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 Aramex. 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 de nuevo, 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 dominio. Eliminar la clave de un sitio no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.

Sin una clave activa, Aramex no se muestra a los clientes en la compra. Los gestores de la tienda que hayan iniciado sesión aún lo ven, marcado 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

Aramex no aparece en la 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. En el modo fijo, comprueba que el país o * tenga un precio.

Las tarifas en tiempo real no aparecen: activa Debug log, recarga la página de compra y abre logs/vfd_armx_debug.log.php en la carpeta del plugin. Muestra el motivo: faltan las credenciales de la API, el código de error de Aramex, falta la ciudad de origen, aún no hay ciudad o código postal de entrega, un límite de peso o de importe, o una cotización en otra moneda. Con Aramex live rates, fixed prices if the API fails los clientes siguen viendo el precio fijo mientras corriges el problema.

Error ERR75 en el registro: Aramex rechazó el inicio de sesión. Revisa el nombre de usuario, la contraseña, el número de cuenta, el PIN, la entidad y el código de país con tu gestor de cuenta de Aramex.

Se rechaza una cotización en otra moneda: Aramex respondió en una moneda distinta a la de tu tienda. Introduce una Currency conversion rate o pide a Aramex que cotice en tu moneda.

El impuesto se cobra dos veces en el envío: los totales de Aramex pueden incluir ya el IVA. Pon Tax status en None.

Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Así se borran las tarifas de Aramex en caché.

Entorno de pruebas de Aramex (sandbox): el plugin usa la Aramex Rate Calculator de producción. Los desarrolladores pueden cambiar el endpoint con el filtro vfd_armx_api_url. Los filtros vfd_armx_rate_request, vfd_armx_number_of_pieces y vfd_armx_volumetric_divisor ajustan la solicitud, el número de piezas y el divisor volumétrico.

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 para 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, las tarifas en caché y los registros 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.

Aramex es una marca comercial de su respectivo propietario. Este plugin no está afiliado a Aramex ni cuenta con su respaldo.