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

Cuenta de FedEx y claves de API (solo para tarifas en tiempo real): en el FedEx Developer Portal (developer.fedex.com) crea un proyecto con la Rate API, vincula tu cuenta de envío de FedEx y copia la API Key y la Secret Key. También necesitas tu número de cuenta de FedEx de 9 dígitos. Las claves de prueba funcionan solo con Sandbox activado; las de producción, solo con él desactivado. El plugin usa la API REST de FedEx con OAuth 2.0; no necesita número de medidor ni contraseña de servicios web. Si solo usas precios fijos, no necesitas claves de FedEx.

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

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Shipping > VibeFox FedEx, 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 la API Key, la Secret Key, el número de cuenta de FedEx de 9 dígitos y la dirección Ship from (código postal y, para EE. UU. y Canadá, el estado de 2 letras). Desactiva Sandbox cuando uses claves de producción.

6. Añade VibeFox FedEx a una zona de envío en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore shipping zones y elige los países.

7. Opcionalmente, introduce precios fijos como alternativa.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox FedEx. 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 de esta opción en la finalización de compra. Déjalo vacío para usar el Name global.

En la parte superior de la página, el plugin muestra avisos: solo algunas de las tres credenciales de API están rellenadas, no hay claves de API ni precios fijos (en ese caso el método nunca se muestra), falta el código postal de origen, falta el estado de origen para EE. UU. o Canadá, o la moneda de la tienda es distinta de la moneda de la cuenta de FedEx sin tipo de cambio. Cada vez que guardas los ajustes se borran el token de FedEx y las tarifas en caché. Los campos numéricos aceptan punto o coma decimal. Un número no válido no se guarda y se notifica.

General

Enable/Disable: activa o desactiva el envío con FedEx en todas las zonas a la vez. Predeterminado: activado.

Name: el nombre del método de envío que ve el cliente en la finalización de compra. Predeterminado: FedEx.

Tax status: Taxable permite que WooCommerce añada impuestos al coste del envío, así que se usa el cargo de FedEx sin impuestos. None usa el cargo neto de FedEx tal cual. Predeterminado: Taxable.

API de FedEx (tarifas en tiempo real)

Sin claves se usan los precios fijos. La sección tiene el enlace Clear cached FedEx token and rates.

Sandbox: usa el sandbox de FedEx con claves de prueba. Desactívalo para tarifas reales con claves de producción. Predeterminado: activado.

API Key: la API Key (client_id) de tu proyecto del FedEx Developer Portal.

Secret Key: la Secret Key (client_secret) del mismo proyecto.

FedEx account number: la cuenta de envío de FedEx de 9 dígitos vinculada al proyecto.

Rates: Account rates (your negotiated FedEx prices) (predeterminado) o List rates (FedEx published prices).

Residential delivery: cotiza las direcciones de los clientes como residenciales (FedEx Home Delivery, recargo residencial). Desactívalo si envías sobre todo a empresas. Predeterminado: activado.

Box size: dimensiones opcionales de la caja en la unidad de dimensiones de tu tienda, por ejemplo 30x20x15. Entonces FedEx aplica el peso volumétrico. Déjalo vacío para cotizar solo por peso.

FedEx account currency: la moneda de tu cuenta de FedEx, por ejemplo USD para cuentas de EE. UU. o CAD para Canadá. Predeterminado: USD. A FedEx siempre se le pide también que cotice en la moneda de la tienda.

Exchange rate: solo es necesario cuando FedEx devuelve tarifas únicamente en la moneda de la cuenta y la moneda de tu tienda es otra: el precio de 1 unidad de la moneda de la cuenta en la moneda de tu tienda, por ejemplo 0.92. Sin él, esas tarifas no se usan.

Origen del envío

La dirección desde la que FedEx recoge los paquetes o donde los entregas. Se usa para las tarifas en tiempo real.

Country: el país desde el que envías. Predeterminado: United States.

State / province code: el código de 2 letras, obligatorio para EE. UU. y Canadá, por ejemplo TN, CA u ON.

City: la ciudad de origen del envío.

ZIP / postal code: el código postal de origen. FedEx lo necesita para cotizar las tarifas.

Precios fijos

Se usan cuando no hay claves de API y como alternativa cuando FedEx no devuelve ninguna tarifa (API caída, claves incorrectas, sin servicio). Deja vacíos ambos campos para ocultar el método en ese caso.

Country prices: el precio en la moneda de tu tienda por país de destino, uno por línea en el formato CC=PRECIO, por ejemplo US=12.99 o CA=19,99. Usa * para cualquier otro país, por ejemplo *=29.99. Las líneas con otro formato se ignoran y se notifican al guardar.

Fallback cost: un precio fijo cuando no coincide ningún precio por país. Déjalo vacío para ocultar el método.

Fixed price is: Per order cobra el precio una vez. Per item (price x number of items) lo multiplica por el número de artículos. Esto se aplica solo a los precios fijos. Las tarifas en tiempo real de FedEx siempre se calculan para el peso total del carrito.

Condiciones

Free shipping from: el subtotal del carrito a partir del cual este método es gratuito. Déjalo vacío para no ofrecer nunca envío gratuito.

Minimum subtotal: muestra el método solo si el subtotal del carrito es al menos este importe. Déjalo vacío para mostrarlo siempre.

Min weight (kg): el peso mínimo del carrito para que aparezca el método. 0 significa sin límite.

Max weight (kg): el peso máximo del carrito. El método se oculta si se supera. 0 significa sin límite.

Default product weight (kg): el peso que se usa para los productos sin peso, en las tarifas de FedEx y en los límites de peso anteriores. Predeterminado: 0.5.

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

Disponibilidad sin zonas de envío

Ignore shipping zones: ofrece el método para los países indicados abajo aunque no se haya añadido a una zona de envío. Un método de zona desactivado en su zona sigue desactivado.

Countries: los países de destino para ese modo. Déjalo vacío para todos los países de envío de la tienda. Se usa solo cuando Ignore shipping zones está activado.

Avanzado

Debug log: registra las peticiones a la API y el cálculo de tarifas en WooCommerce > Status > Logs, origen vfd-fedex. Los errores de API siempre se registran. Las claves, los tokens y las direcciones de los clientes nunca se registran.

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

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 el peso del carrito, el subtotal mínimo y las clases de envío excluidas. Si se aplica el envío gratuito, el cliente ve el método como FedEx (Free) y no se envía ninguna petición a FedEx.

En caso contrario, el plugin obtiene un token OAuth y envía a la Rate API de FedEx la dirección de origen, la dirección de entrega, el peso del carrito (en kg, o en lb para tiendas que usan lb u oz), el tamaño de caja si está definido y la moneda de tu tienda como moneda preferida. En los países que usan códigos postales, la petición se hace solo después de que el cliente haya introducido uno. Para los envíos internacionales se envía el valor aduanero del carrito. Los códigos de estado solo se envían para EE. UU. y Canadá.

FedEx devuelve los servicios disponibles. Para cada servicio, el plugin toma la tarifa de cuenta o de lista que elegiste, prefiere una tarifa en la moneda de tu tienda, convierte una tarifa en la moneda de la cuenta de FedEx con tu tipo de cambio y descarta las tarifas que no puede convertir. El servicio más barato se muestra con el nombre de tu método, y su nombre se guarda con la línea de envío del pedido.

El token se guarda en caché por entorno y clave, y se vuelve a pedir automáticamente cuando FedEx lo rechaza. Las cotizaciones se guardan en caché durante 1 hora. Una petición de tarifa fallida se recuerda durante 10 minutos, y una petición de token fallida durante 5 minutos, para que una caída del servicio no ralentice cada actualización de la finalización de compra. El tiempo de espera de la API es de 15 segundos. Si FedEx no responde, el cliente no ve ningún error: se usa el precio fijo o se oculta el método.

El método funciona en la finalización de compra clásica y en la de bloques. Es compatible con el almacenamiento de pedidos de alto rendimiento de WooCommerce (HPOS).

El plugin solo calcula tarifas. No crea envíos de FedEx, no imprime etiquetas, no reserva recogidas, no hace seguimiento de paquetes y no permite que los clientes elijan una ubicación de FedEx. Muestra una opción (el servicio más barato), no varias, y no hay empaquetado en cajas: el carrito se cotiza como un único paquete.

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 FedEx. 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 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, FedEx no se muestra a los clientes en la finalización de compra. Los gestores de la tienda que han iniciado sesión sí lo ven, marcado 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

FedEx 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 permitido). Revisa los avisos de la parte superior de la página de ajustes, los límites de peso, Minimum subtotal y Excluded shipping classes. Sin tarifa en tiempo real, el método necesita un precio por país, una línea * o un Fallback cost.

Las tarifas en tiempo real no aparecen: activa Debug log, recarga la finalización de compra y abre WooCommerce > Status > Logs, origen vfd-fedex. Ahí se registran las claves incorrectas, el entorno equivocado (claves de prueba con Sandbox desactivado, o claves de producción con él activado) y los códigos de error de FedEx.

Mi tienda no usa USD: FedEx recibe la petición de tarifa en la moneda de la tienda. Si tu cuenta devuelve solo su propia moneda, define FedEx account currency y Exchange rate. Sin tipo de cambio, esas tarifas se ignoran y se usa el precio fijo, así que un importe en USD nunca se muestra en euros.

¿La opción «per item» multiplica la tarifa de FedEx? No. Per item se aplica solo a los precios fijos.

Las tarifas parecen desactualizadas tras un cambio: después de cambiar las claves, la caché se borra automáticamente. También puedes hacer clic en Clear cached FedEx token and rates.

Solo se deben ofrecer algunos servicios: los desarrolladores pueden restringir los servicios con el filtro vfd_fdx_allowed_services.

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 ajustes y solo borra los tokens y las tarifas en caché. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia y el estado de licencia de este plugin, los tokens y tarifas en caché y los archivos de registro antiguos siempre se eliminan. Los ajustes y los métodos de zona se eliminan solo si Remove data on uninstall estaba activado. En caso contrario se conservan para una reinstalación posterior. Los pedidos existentes conservan sus líneas de envío.

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