VibeFox Aramex for PrestaShop — Ayuda
Requisitos
PrestaShop: 8.0 a 9.x.
PHP: 8.0 o posterior. El módulo no se instala en versiones anteriores de PHP.
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 solo dominio.
Instalación
1. En el back office ve a Modules > Module Manager y haz clic en Upload a module. Elige el archivo ZIP del módulo.
2. Cuando termine la subida, haz clic en Configure, o busca VibeFox Aramex más tarde en la lista de módulos y haz clic en Configure.
3. Pega tu clave de licencia de VibeFox en License key en el bloque de licencia de la parte superior de la página Configure y haz clic en Activate (ver Clave de licencia).
4. Elige cómo se calcula el coste del envío, rellena las secciones correspondientes (ver Configuración) y haz clic en Save.
Al instalar, el módulo crea el transportista Aramex con el texto del tiempo de entrega Courier delivery. El transportista se asigna a todas las zonas y a todos los grupos de clientes. Puedes cambiar zonas, grupos de clientes, tiempo de entrega, logotipo y límites de tamaño en Shipping > Carriers. No definas precios allí: el precio siempre procede del módulo.
Configuración
Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox Aramex > Configure. Cada sección tiene su propio botón Save, que guarda toda la página. Cada guardado también borra las tarifas de Aramex en caché.
General
Enable Aramex: activa o desactiva el transportista. Es el mismo interruptor que el estado del transportista en Shipping > Carriers.
Method title: el nombre del transportista que se muestra en el carrito y en la compra. Por defecto: Aramex. Obligatorio.
Shipping cost: cómo se calcula el precio.
El motivo de la falta de tarifa en tiempo real se escribe en el registro de depuración. Nunca se muestra al cliente.
Cuenta de la 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. Después de guardar, el campo queda vacío y muestra Saved — leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarlo.
Account number: tu número de cliente de Aramex.
Account PIN: el PIN de tu cuenta de Aramex. Como la contraseña, no se vuelve a mostrar después de guardar.
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 Domestic. Todos los demás envíos se cotizan como International express.
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 y más).
Payment type: quién paga a Aramex por el envío: Prepaid (paga el remitente), Collect (paga el destinatario) o Third party (tercero). Normalmente Prepaid.
API weight unit: la unidad que se envía a Aramex, KG o LB. Los pesos y las dimensiones de los productos se convierten desde las unidades 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 predeterminada 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 predeterminada de tu tienda). Déjalo vacío para rechazar esas cotizaciones, de modo que nunca se cobre al cliente en una moneda incorrecta.
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 Shop Parameters > Contact > Stores.
Precios fijos (se usan en el modo fijo y como alternativa para las tarifas en tiempo real)
Price per country: una tabla de códigos de país de dos letras y precios en la moneda predeterminada de tu tienda, sin impuestos. Haz clic en Add row para añadir un país y en el icono de papelera para eliminarlo. Usa * como código de país para todos los demás países. Los países sin precio (cuando no hay una fila con *) no tienen tarifa fija, así que el transportista 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 son siempre por envío.
Condiciones
Minimum weight: oculta el transportista cuando el carrito pesa menos, en kg. 0 significa sin límite.
Maximum weight: oculta el transportista cuando el carrito pesa más, en kg. Por defecto: 100. 0 significa sin límite.
Minimum order amount: muestra el transportista 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: activa el envío gratuito de 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: la regla de impuesto del transportista, o No tax. Las tarifas de Aramex en tiempo real pueden incluir ya el IVA. En ese caso elige No tax para no cobrar el impuesto dos veces.
Countries: ofrece Aramex solo para estos países de destino. Déjalo vacío para permitir todos los países de las zonas del transportista.
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 módulo. 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.
Log: muestra el tamaño y las entradas más recientes del registro de depuración. Haz clic en Clear log para vaciarlo.
Remove data on uninstall: si está activado, al desinstalar el módulo se borran los ajustes de Aramex, el transportista, las tarifas en caché y los registros. Si está desactivado, todo se conserva para una reinstalación.
Cómo funciona en la compra
En el paso de envío, PrestaShop pide al módulo el precio de Aramex. Solo cuentan los productos físicos: los productos virtuales no suman peso ni se incluyen en el importe del pedido. El módulo comprueba primero las condiciones: países permitidos, peso del carrito e importe mínimo del pedido. Si se aplica el envío gratuito, el precio es 0 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 módulo envía a Aramex las direcciones de origen y de entrega, el peso facturable, el servicio y tu moneda predeterminada, y usa el total devuelto. Una tarifa en tiempo real se solicita solo cuando la dirección de entrega tiene ciudad o código postal. El precio se calcula en tu moneda predeterminada y después se muestra en la moneda del carrito del cliente.
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 tipo de cambio, el cliente no ve ningún error. El transportista se oculta, o se usa el precio fijo en el modo de alternativa. El motivo se escribe en el registro de depuración.
Si editas el transportista en Shipping > Carriers después de que tenga pedidos, PrestaShop lo guarda como una nueva versión del transportista. El módulo sigue automáticamente la nueva versión.
El módulo solo calcula tarifas. No crea envíos de Aramex, no imprime etiquetas, no reserva recogidas, no hace seguimiento de paquetes ni permite al cliente elegir una oficina de Aramex. El paquete siempre se envía a Aramex como una sola pieza.
Clave de licencia
El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Aramex es el primer bloque de Modules > Module Manager > VibeFox Aramex > Configure, por encima de los ajustes. Pega 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 volver a comprobar el estado, Change key para introducir otra clave y Remove key para quitar la clave de esta tienda. Debajo aparecen la línea Product: presta-shipping-aramex y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los empleados con el permiso Configure del módulo pueden cambiar la clave. Los textos del bloque siguen el idioma del back office (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 seguido de una fecha. Después de cambiar la dirección de la tienda, o tras liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si no se puede contactar con el servidor de licencias, el módulo sigue funcionando con el último estado conocido.
Una clave funciona en un solo dominio: el dominio de la tienda principal, también en una configuración multitienda. 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 transportista Aramex no se muestra a los clientes en la compra y no se calcula ninguna tarifa. La tienda no sabe que has iniciado sesión en el back office, así que el transportista también queda oculto para ti: puedes configurar el módulo antes de comprar una clave, pero no probarlo en la compra. Aparece un recordatorio en Modules > Module Manager, en la pestaña Alerts. Los pedidos existentes no se ven afectados.
Cuando una licencia caduca, el módulo sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente mientras trabajas en el back office: una vez al día durante los primeros 14 días tras introducir la clave, y después una vez a la semana. No hace falta ningún cron job. Desinstalar o restablecer el módulo elimina siempre la clave de licencia y el estado de la licencia.
Solución de problemas
Aramex no aparece en la compra: comprueba que la licencia esté activa y que Enable Aramex esté activado. En Shipping > Carriers comprueba que el transportista cubra la zona del país del cliente y su grupo. Revisa Countries, los límites de peso y Minimum order amount. En el modo fijo, comprueba que el país o * tenga un precio. Los productos también pueden limitarse a ciertos transportistas en la página del producto.
Las tarifas en tiempo real no aparecen: activa Debug log, recarga la compra y consulta el campo Log de la página del módulo. Muestra el motivo: faltan las credenciales de la API, el código de error de Aramex, falta la ciudad de origen, falta la ciudad o el código postal de entrega, hay un límite de peso o de importe, o la cotización está 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. Comprueba 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 de tu moneda predeterminada. Introduce 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 en No tax.
Las tarifas parecen desactualizadas tras un cambio: haz clic en Save en la página del módulo. Esto borra las tarifas de Aramex en caché.
La página indica que no se encontró el transportista de Aramex: el transportista se eliminó en Shipping > Carriers. Restablece el módulo en Modules > Module Manager para volver a crearlo.
Desinstalación
Ve a Modules > Module Manager, abre el menú junto a VibeFox Aramex y elige Uninstall. La clave de licencia, el estado de la licencia y las tarifas en caché se eliminan siempre. Si Remove data on uninstall está activado, el transportista se elimina (los pedidos conservan su historial) y se borran los ajustes y el registro. Si está desactivado, el transportista solo se desactiva y todos los ajustes se conservan. Volver a instalar el módulo reactiva el transportista guardado.
Aramex es una marca comercial de su respectivo titular. Este módulo no está afiliado a Aramex ni cuenta con su respaldo.