VibeFox Purolator 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. No se necesita la extensión SOAP de PHP.

Purolator E-Ship Web Services (solo para tarifas en tiempo real): regístrate en E-Ship Web Services en el Purolator E-Ship Resource Centre del sitio web de Purolator. Purolator entrega claves y contraseñas independientes para los entornos de desarrollo y de producción. También necesitas tu número de cuenta de facturación de Purolator y el código postal canadiense desde el que envías. Si solo usas precios fijos, no necesitas claves de API.

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

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Shipping > VibeFox Purolator, 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. Para las tarifas en tiempo real, rellena la sección Purolator API (live rates). Para hacer pruebas, activa Development environment con la clave de desarrollo. Rellena Country prices o Fallback price si quieres precios fijos o un precio alternativo (consulta Configuración).

6. Añade VibeFox Purolator 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 Purolator. 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 en esta zona. Déjalo vacío para usar el Method title global.

Cada vez que guardes los ajustes, se borrarán las tarifas de Purolator guardadas en caché. Si las tarifas en tiempo real no pueden funcionar con los valores guardados (falta la clave, la contraseña o la cuenta, no hay código postal canadiense de origen o no hay tipo de cambio a CAD), o si no hay ni credenciales de API ni precios fijos, aparecerá una advertencia 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 cambiarlo. Predeterminado: Purolator.

Tax status: Taxable añade el impuesto de WooCommerce al coste del envío, None no lo añade. Consulta también Canadian sales taxes más abajo.

API de Purolator (tarifas en tiempo real)

Con la clave de API, la contraseña y la cuenta de facturación rellenadas, el precio procede del servicio web Purolator E-Ship Estimating. Si Purolator no devuelve ninguna tarifa, se usa el precio fijo, o el método se oculta si no hay ninguno.

API key: tu clave de E-Ship Web Services para el entorno seleccionado.

API password: la contraseña que corresponde a la clave.

Billing account number: tu número de cuenta de Purolator. Las estimaciones usan las tarifas de esta cuenta. El entorno de desarrollo acepta la cuenta de prueba de la documentación de Purolator.

Development environment: usa el entorno de desarrollo de Purolator (devwebservices.purolator.com) con la clave de desarrollo. Los precios son datos de prueba. Desactívalo en una tienda real.

Ship-from postal code: el código postal canadiense desde el que se envían los paquetes, por ejemplo L4W 5M8.

Service in Canada: Cheapest available (predeterminado), Purolator Ground, Purolator Ground 9AM, Purolator Ground 10:30AM, Purolator Ground Evening, Purolator Express, Purolator Express 9AM, Purolator Express 10:30AM, Purolator Express 12PM o Purolator Express Evening.

Service to the USA: Cheapest available (predeterminado), Purolator Ground U.S., Purolator Express U.S., Purolator Express U.S. 9AM, Purolator Express U.S. 10:30AM o Purolator Express U.S. 12:00.

International service: Cheapest available (predeterminado), Purolator Express International, Purolator Express International 9AM, Purolator Express International 10:30AM o Purolator Express International 12:00.

Si el servicio elegido no se ofrece para la dirección, se usa el más barato disponible.

Canadian sales taxes: en el caso de direcciones canadienses, el total de Purolator incluye GST/HST/PST/QST. Activa Use Purolator prices without GST/HST/PST/QST cuando Tax status sea Taxable, para no cobrar el impuesto dos veces.

CAD → (store currency) rate: los precios de Purolator están en CAD. Si la moneda de tu tienda no es CAD, indica cuántas unidades de tu moneda vale un CAD, por ejemplo 0.68. Sin este valor no se usan las tarifas en tiempo real. Si la moneda de tu tienda es CAD, déjalo vacío.

Default product weight (kg): se usa para cada producto que no tenga peso. Predeterminado: 0.5. Los pesos se convierten desde la unidad de la tienda y se envían a Purolator como peso total en libras enteras, redondeado hacia arriba.

Precios fijos (se usan sin credenciales de API y como alternativa cuando la API no devuelve ninguna tarifa)

Country prices: un precio por país y peso del carrito en la moneda de la tienda. Haz clic en + Add country para añadir una fila y en la × para eliminar una. Elige * Default (all other countries) para una fila que cubra todos los países sin fila propia. Cada fila tiene un precio Base y columnas de tamaño: XS hasta 1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg y XL más de 5 kg. Un precio de tamaño vacío o cero usa Base. Un Base de 0, o un Base vacío, significa envío gratis para los pesos sin su propio precio de tamaño. Las filas sin ningún precio y los códigos de país no válidos se eliminan al guardar. Solo se conserva una fila por país.

Fallback price: el precio para un país que no tiene fila en Country prices ni fila *. Déjalo vacío para ocultar el método en esos países.

Fixed price per: Order cobra el precio una vez. Item (price × quantity) lo multiplica por el número de artículos del carrito. Esto se aplica solo a los precios fijos. Las tarifas en tiempo real siempre se calculan para todo el envío.

Condiciones

Min cart weight (kg): oculta el método cuando el carrito pesa menos. 0 significa sin límite.

Max cart weight (kg): oculta el método cuando el carrito pesa más. Predeterminado: 30. 0 significa sin límite.

Minimum order amount: muestra el método solo cuando el subtotal del carrito 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 from: el subtotal del carrito a partir del cual el envío es gratis. Solo se aplica cuando el método tiene precio: un precio por país o el precio alternativo (entonces no se envía ninguna solicitud a Purolator), o una tarifa en tiempo real. Déjalo vacío para no ofrecer nunca envío gratis.

El peso del carrito para estas condiciones cuenta los productos sin peso como 0. Los precios y los pesos aceptan la coma o el punto como separador decimal.

Disponibilidad sin zonas de envío

Ignore shipping zones: ofrece Purolator 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-purolator"). Los errores de la API siempre se registran, incluso con el registro de depuración desactivado. Las claves de API, la cuenta de facturación y los códigos postales de los clientes no se registran. Desactiva el registro cuando termines.

Remove data on uninstall: si está activado, al eliminar el plugin se borran sus ajustes, los métodos de zona y las tarifas 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. Después busca un precio: la tarifa en tiempo real de Purolator, luego la tabla de países y, por último, el precio alternativo. Si no hay ningún precio, el método se oculta. Si se aplica el envío gratis, el cliente ve el método sin coste.

Con credenciales de API, el plugin envía a Purolator una solicitud Quick Estimate: tu cuenta de facturación, el código postal de origen, la ciudad, provincia o estado del cliente, el país y el código postal, y el peso total del carrito en libras enteras. En Canadá se necesita un código postal válido; en Estados Unidos, un código ZIP válido; los demás países se envían con el código postal tal como se introdujo. No se envían las dimensiones (peso volumétrico). Purolator devuelve los precios de todos los servicios; el plugin toma el servicio que elegiste o el más barato, quita los impuestos canadienses si está configurado y convierte el precio desde CAD. El servicio se guarda con el pedido como Purolator service y es visible en la pantalla de pedidos del administrador.

Cada respuesta se guarda en caché durante 1 hora. Una solicitud fallida se guarda durante 10 minutos, para que una caída de Purolator no ralentice cada actualización de la finalización de compra. El tiempo de espera de la API es de 10 segundos.

Si Purolator no devuelve ninguna tarifa (la API no funciona, credenciales o código postal incorrectos, servicio no disponible, sin tipo de cambio a CAD), el cliente no ve ningún error. Se usa el precio fijo, o el método se oculta si no hay precio fijo. 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 de Finalizar compra. Es compatible con el almacenamiento de pedidos de alto rendimiento (HPOS) de WooCommerce.

El plugin solo calcula tarifas. No crea envíos de Purolator, no imprime etiquetas, no reserva recogidas, no gestiona devoluciones ni hace seguimiento de paquetes. No usa el Full Estimate (dimensiones, varias piezas, opciones como firma o mercancías peligrosas), no muestra fechas de entrega, no muestra varios servicios como tarifas separadas ni obtiene tipos de cambio automáticamente.

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 Purolator. 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, Purolator 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 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 necesitan una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.

Solución de problemas

Purolator 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. Si Purolator no devuelve ninguna tarifa, el método solo se muestra con un precio por país, una fila * o un Fallback price.

Las tarifas en tiempo real no aparecen: abre WooCommerce > Status > Logs, origen "vfd-purolator". Los errores de la API siempre están ahí. Activa Debug log para ver los detalles. Con claves de API, la dirección debe tener un código postal válido (Canadá) o un código ZIP válido (Estados Unidos).

HTTP 401 en el registro: la clave o la contraseña de API no coincide con el entorno seleccionado. Las claves de desarrollo solo funcionan con Development environment activado; las de producción solo con él desactivado.

La tarifa es distinta a la de la web de Purolator: Quick Estimate usa las tarifas de tu cuenta de facturación y el peso total redondeado hacia arriba a libras enteras, sin peso volumétrico. En las direcciones canadienses el total incluye impuestos; usa Canadian sales taxes si WooCommerce añade impuesto al envío. Los precios se convierten con tu CAD → (store currency) rate.

Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Así se borran las tarifas de Purolator guardadas 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 tarifas 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.

Purolator es una marca comercial de su respectivo propietario. Este plugin no está afiliado a Purolator ni respaldado por Purolator.