VibeFox EasyPost 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 EasyPost (solo para tarifas en tiempo real): crea una cuenta en el sitio web de EasyPost, conecta tus cuentas de transportista (USPS, UPS, FedEx y otras) en el panel de EasyPost y copia la clave de API desde EasyPost Dashboard > Account Settings > API Keys. EasyPost cobra las etiquetas compradas, no las consultas de tarifas. Si solo usas precios de reserva, no necesitas una cuenta de EasyPost.

Productos: los productos necesitan peso y, mejor aún, dimensiones.

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

2. Haz clic en Activate.

3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox EasyPost, o haz clic en Settings debajo del nombre del plugin en la página de 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. Pega tu clave de API de EasyPost y completa la dirección de Ship from. El código postal es obligatorio para las tarifas en tiempo real.

6. Si la moneda de tu tienda no es USD, introduce el USD exchange rate. Opcionalmente, introduce los precios de reserva (ver Configuración).

7. Añade VibeFox EasyPost 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 EasyPost. 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 del método de envío que ven los clientes en esta zona. Déjalo vacío para usar el Name general.

En la parte superior de la página, el plugin muestra avisos cuando no se pueden usar las tarifas en tiempo real: falta la clave de API, falta el código postal o el país de origen, o la moneda de la tienda no es USD y no hay tipo de cambio. También aparece una nota cuando hay configurada una clave de API de prueba. Cada vez que guardas los ajustes, se borran las tarifas de EasyPost guardadas en caché.

General

Enable/Disable: activa o desactiva el método en todas las zonas a la vez. Predeterminado: activado.

Name: el nombre del método de envío que se muestra en el carrito y en la finalización de compra. Una zona puede cambiarlo con su propio Title. Predeterminado: EasyPost Shipping.

Cuenta de EasyPost

API key: tu clave de API de EasyPost desde EasyPost Dashboard > Account Settings > API Keys. Una clave de producción (empieza por EZAK) devuelve tarifas reales. Una clave de prueba (empieza por EZTK) devuelve tarifas de prueba de EasyPost; úsala solo para hacer pruebas.

Allowed carriers / services: opcional, separado por comas. Introduce un transportista (USPS) o un transportista y un servicio (USPS:Priority, UPS:Ground) tal como los nombra EasyPost. Se muestra la tarifa permitida más barata. Déjalo vacío para mostrar la tarifa más barata de cualquier transportista.

Origen del envío

La dirección desde la que se envían tus paquetes. Si el Country es el país de tu tienda, los campos vacíos se toman de la dirección de la tienda en WooCommerce > Settings > General (y el nombre del remitente, del título del sitio).

Sender name / company: el nombre del remitente o de la empresa.

Street address: la calle de la dirección de origen.

City: la ciudad de origen.

State: el código de estado de dos letras, por ejemplo CA o NY.

ZIP code: el código postal de origen. Obligatorio para las tarifas en tiempo real.

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

Tarifas

Parcels: cómo se envía el carrito a EasyPost.

One parcel per order (the cart is packed into one box): todas las unidades se apilan en una caja y se tarifican una vez. Es el valor predeterminado.

One parcel per item (every unit ships in its own box): cada producto se tarifica como un paquete propio y la tarifa se cobra por cada unidad. Los precios de reserva también se cobran por unidad.

Los pesos se convierten de la unidad de peso de tu tienda a onzas (mínimo 1 oz) y las dimensiones a pulgadas. Si algún producto no tiene dimensiones, el paquete se tarifica solo por peso.

USD exchange rate: las tarifas de EasyPost están en USD. Introduce el precio de 1 USD en la moneda de tu tienda, por ejemplo 0.92. Sin este valor no se usan las tarifas en tiempo real, solo los precios de reserva. No hace falta si la moneda de la tienda es USD. Las tiendas en USD y CAD piden a EasyPost que cotice en su propia moneda. Se aceptan tanto el punto como la coma como separador decimal.

Tax status: Taxable permite que WooCommerce añada impuestos al envío según tus reglas fiscales; None no lo hace. Las tarifas de EasyPost no incluyen el impuesto de ventas. Predeterminado: Taxable.

Precios de reserva

Se usan cuando no hay tarifa en tiempo real: no hay clave de API, no se puede contactar con EasyPost, la clave es rechazada o ningún transportista tiene tarifa para la dirección. Los precios están en la moneda de tu tienda. Deja los dos campos vacíos para ocultar el método en esos casos.

Country prices: una línea por país: código de país de dos letras, dos puntos y el precio, por ejemplo US:9.99. Las líneas con otro formato se ignoran y aparecen en un mensaje de error al guardar.

Other countries: el precio para los países que no están en la lista anterior. Déjalo vacío para ocultar el método en ellos.

Condiciones

Free shipping from: el subtotal del carrito a partir del cual el envío es gratis. En ese caso no se hace ninguna consulta a EasyPost. Déjalo vacío para desactivarlo.

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

Minimum weight: oculta el método cuando el carrito pesa menos, en la unidad de peso de tu tienda. 0 significa sin límite.

Maximum weight: oculta el método cuando el carrito pesa más, en la unidad de peso de tu tienda. 0 significa sin límite.

Disabled shipping classes: oculta el método cuando 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 a continuación, esté o no añadido a una zona.

Countries: los países de destino para ese modo. Déjalo vacío para usar todos los países a los que envía tu tienda. Este campo solo se usa cuando Ignore shipping zones está activado.

Avanzado

Debug log: escribe las consultas a EasyPost en WooCommerce > Status > Logs, origen vfd-easypost. Los errores de la API siempre se registran, incluso con esta opción desactivada. La clave de API y las direcciones de los clientes nunca se registran.

Remove data on uninstall: si está activado, al eliminar el plugin se borran sus ajustes y los métodos de las zonas. 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 una tarifa al plugin. El plugin comprueba primero las condiciones: país de entrega, peso del carrito, subtotal mínimo y clases de envío desactivadas. Si se aplica el envío gratis, el método se muestra con precio cero y no se envía ninguna consulta a EasyPost.

En caso contrario, el plugin envía a EasyPost la dirección de origen, la dirección de entrega y el paquete, y recibe las tarifas de todas tus cuentas de transportista. Elige la tarifa permitida más barata, la convierte a la moneda de tu tienda y la muestra con el nombre de tu método. En los países que necesitan código postal, la consulta se hace solo después de que el cliente lo haya introducido.

Cada respuesta se guarda en caché durante 1 hora para la misma dirección y el mismo paquete. Una dirección sin tarifas utilizables se recuerda durante 10 minutos. Tras un tiempo de espera, una clave rechazada, un límite de peticiones o un error del servidor de EasyPost, no se hace ninguna consulta durante 5 minutos. El tiempo de espera de la API es de 10 segundos. En todos estos casos el cliente no ve ningún error: se usa el precio de reserva o, si no hay precio de reserva, el método se oculta.

El transportista y el servicio elegidos y, en el modo de un paquete, los días de entrega estimados se guardan en la línea de envío del pedido. Los puedes ver en la pantalla del pedido del administrador.

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

El plugin solo calcula tarifas. No compra etiquetas, no hace seguimiento de paquetes, no valida direcciones, no ofrece puntos de recogida o entrega, ni añade opciones de seguro o de firma. Muestra una sola opción (la tarifa permitida más barata), no una lista de servicios. No empaqueta cajas más allá de apilar los artículos en un paquete, y no aplica recargos sobre la tarifa ni cargos por gestión.

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 EasyPost. 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, EasyPost no se muestra a los clientes en la finalización de compra. Los gestores de la tienda con sesión iniciada 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 de 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

EasyPost 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, el Minimum subtotal y las Disabled shipping classes. Sin tarifa en tiempo real, el método necesita un precio de reserva para el país o para Other countries.

Las tarifas en tiempo real no aparecen: lee los avisos de la parte superior de la página de ajustes, después activa el Debug log, recarga la finalización de compra y abre WooCommerce > Status > Logs, origen vfd-easypost. Motivos habituales: falta la clave de API o el código postal de origen, la tienda no está en USD y no hay USD exchange rate, el cliente aún no ha introducido un código postal, ningún transportista de tu cuenta de EasyPost atiende la dirección, o Allowed carriers / services filtra todas las tarifas.

Las tarifas parecen precios de prueba: hay una clave de prueba (EZTK...) configurada. Usa una clave de producción (EZAK...) en la tienda en vivo.

Las tarifas se detuvieron durante unos minutos: tras un tiempo de espera, una clave rechazada o un error del servidor de EasyPost, el plugin pausa las consultas durante 5 minutos y usa precios de reserva. Revisa la clave de API y el registro.

¿Se incluye el impuesto? Las tarifas de EasyPost no incluyen el impuesto de ventas. Con Tax status en Taxable, WooCommerce añade impuestos al envío según tus ajustes fiscales.

Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Esto borra las tarifas de EasyPost guardadas en caché.

Hooks para desarrolladores: los filtros vfd_ep_shipment_request (cuerpo de la consulta), vfd_ep_selected_rate (tarifa elegida), vfd_ep_api_url (URL base de la API) y woocommerce_shipping_vfd_easypost_is_available adaptan el plugin.

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 ha cambiado la dirección del sitio, haz clic en Check now para activar la clave en el nuevo dominio. Si no se puede contactar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.

Desinstalación

Desactivar el plugin conserva todos los ajustes y solo borra las tarifas en caché. Para eliminarlo, desactívalo y bórralo en la página Plugins. La clave de licencia, el estado de la licencia de este plugin, las tarifas en caché y los archivos de registro antiguos siempre se eliminan. Los ajustes y los métodos de zona solo se eliminan 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.

EasyPost es una marca comercial de su respectivo titular. Este plugin no está afiliado a EasyPost ni cuenta con su aprobación.