VibeFox Canada Post 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.

Canada Post Developer Program (solo para tarifas en tiempo real): las tarifas en tiempo real usan la Rating API de Canada Post. Únete al Canada Post Developer Program en el sitio web de Canada Post y copia tu clave de API y tu número de cliente. La clave de API tiene el formato usuario:contraseña, y Canada Post entrega claves separadas para los entornos de desarrollo (sandbox) y de producción. También necesitas 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 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_canada_post a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox Canada Post, 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. Para las tarifas en tiempo real, introduce el nombre de usuario y la contraseña de la API, tu número de cliente y el código postal de envío. Si la moneda de tu tienda no es CAD, introduce el tipo de cambio a CAD. Rellena Country prices si quieres precios fijos o una alternativa (consulta Configuración).

6. Añade VibeFox Canada Post a tus zonas de envío en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore shipping zones y elige países.

Configuración

Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox Canada Post. 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 que ve el cliente en esta zona. Déjalo vacío para usar el Method title global.

Cada vez que guardas los ajustes, se borran las tarifas de Canada Post en caché. La página también muestra un error cuando los ajustes no pueden funcionar: solo se ha rellenado uno de los campos, nombre de usuario o contraseña de la API; el código postal de envío no es canadiense; falta el tipo de cambio a CAD en una tienda con otra moneda; o no hay ni claves de API ni precios fijos.

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: Canada Post. Una zona puede usar su propio título.

Tax status: Taxable añade el impuesto de WooCommerce sobre el coste del envío; None no lo añade.

API de Canada Post (tarifas en tiempo real)

Con el nombre de usuario y la contraseña de la API rellenados, el precio viene de la Rating API de Canada Post. Si la API no devuelve ninguna tarifa (API no disponible, código postal incorrecto, servicio no disponible), se usa el precio fijo de Country prices, o el método se oculta si no hay ninguno.

API username: la parte de la clave de API anterior a los dos puntos. Usa la clave de desarrollo con Sandbox y la clave de producción en una tienda real.

API password: la parte de la clave de API posterior a los dos puntos. Nunca se escribe en el registro.

Customer number: con un número de cliente, Canada Post devuelve las tarifas comerciales (con descuento) de tu cuenta. Déjalo vacío para las tarifas minoristas (de mostrador).

Contract number: opcional, para clientes con contrato. Se usa solo junto con el número de cliente.

Sandbox: usa el entorno de desarrollo de Canada Post, para probar con la clave de API 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 K1A 0B1. Las tarifas en tiempo real lo necesitan.

Service in Canada: el servicio para direcciones canadienses: Cheapest available, Regular Parcel (por defecto), Expedited Parcel, Xpresspost o Priority.

Service to the USA: Cheapest available (por defecto), Expedited Parcel USA, Tracked Packet USA, Small Packet USA Air, Xpresspost USA o Priority Worldwide parcel USA.

International service: Cheapest available (por defecto), International Parcel Surface, International Parcel Air, Tracked Packet International, Small Packet International Surface, Small Packet International Air, Xpresspost International o Priority Worldwide parcel International.

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

Canadian sales taxes: usa los precios de Canada Post sin GST/HST/PST. En direcciones canadienses, el precio de Canada Post incluye estos impuestos. Actívalo cuando WooCommerce añade el impuesto al envío (Tax status = Taxable), para no cobrar el impuesto dos veces.

CAD → store currency rate: el nombre del campo muestra la moneda de tu tienda. Los precios de Canada Post están en CAD. Si la moneda de tu tienda no es CAD, introduce cuántas unidades de tu moneda vale un CAD, por ejemplo 0.68. Sin este dato no se usan las tarifas en tiempo real. Si la moneda de tu tienda es CAD, déjalo vacío. Se aceptan tanto el punto como la coma como separador decimal.

Default product weight (kg): se envía a Canada Post para cada producto que no tenga peso. Por defecto: 0.5. Los pesos y las dimensiones de los productos se convierten desde las unidades de tu tienda, y el carrito se calcula como un único paquete.

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

Country prices: una tabla de países con un precio Base y precios según el peso del carrito en la moneda de tu tienda: XS hasta 1 kg, S 1–2 kg, M 2–3 kg, L 3–5 kg, XL más de 5 kg. Un precio de tamaño vacío o cero usa el precio Base. Haz clic en Add country para añadir una fila y en la × para eliminar una. La fila * Default (all other countries) fija los precios de todos los países que no tengan fila propia. Un país sin fila (y sin *) no tiene precio fijo. Un precio base de 0 significa envío gratuito para ese país.

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 el paquete completo.

Condiciones

Min cart weight (kg): oculta el método por debajo de este peso del carrito. 0 significa sin límite.

Max cart weight (kg): oculta el método por encima de este peso del carrito. Por defecto: 25. 0 significa sin límite. Los paquetes de Canada Post pueden pesar hasta 30 kg.

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 si algún artículo del carrito tiene una de estas clases de envío de WooCommerce.

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

Free shipping from: el subtotal del carrito a partir del cual el envío es gratuito. En ese caso no se envía ninguna solicitud a la API.

Disponibilidad sin zonas de envío

Ignore shipping zones: ofrece el método para los países indicados abajo, sea cual sea la zona que coincida.

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

Avanzado

Debug log: registra los cálculos de tarifas en WooCommerce > Status > Logs, origen vfd-canada-post. Los errores de la API siempre se registran, aunque esta opción esté desactivada. Las claves de API, los números de cliente y los códigos postales de los clientes no se registran.

Remove data on uninstall: si está activado, al eliminar el plugin se borran sus ajustes, los métodos de las zonas 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 una tarifa al plugin. Primero el plugin comprueba las condiciones: peso del carrito, importe mínimo del pedido y clases de envío excluidas. Si se aplica el envío gratuito, el cliente obtiene una tarifa gratuita y no se envía ninguna solicitud a Canada Post.

Con claves de API, el plugin envía a Canada Post el código postal de envío, el destino, el peso del paquete y, cuando todos los productos tienen dimensiones, el tamaño estimado del paquete. Para Canadá el destino es el código postal, para Estados Unidos el código ZIP, y para el resto de países solo el país. Una tarifa en tiempo real se solicita solo cuando una dirección canadiense o estadounidense tiene un código postal o ZIP válido. Canada Post devuelve todos los servicios del paquete; el plugin elige el servicio indicado para el grupo de destino o el más barato, quita los impuestos de venta canadienses si Canadian sales taxes está activado, y convierte el precio en CAD con tu tipo de cambio. El nombre del servicio se guarda con el pedido y se muestra en la pantalla de pedidos del administrador como Canada Post service.

Cada respuesta se guarda en caché durante 1 hora, así que el mismo carrito y la misma dirección no generan una nueva solicitud. Una solicitud fallida se guarda en caché durante 10 minutos, para que una caída de Canada Post no ralentice cada actualización de la finalización de compra. El tiempo límite de la API es de 10 segundos. Los paquetes de más de 30 kg no se envían a la API.

Si la API no devuelve ninguna tarifa, se usa el precio fijo, o el método se oculta si no hay precio fijo. El cliente nunca ve los detalles de los errores de la API; estos van al registro de WooCommerce.

El método funciona en la finalización de compra clásica y en los bloques de Carrito y Finalizar compra. Es compatible con WooCommerce High-Performance Order Storage (HPOS).

El plugin solo calcula tarifas. No crea envíos, no imprime etiquetas, no crea manifiestos ni devoluciones, y no hace seguimiento de paquetes. Los clientes no pueden elegir una oficina de correos ni un punto de recogida. Muestra una sola tarifa de Canada Post, sin fechas de entrega, seguro ni opciones de firma. El carrito siempre se calcula como un único paquete, y los tipos de cambio no se actualizan 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 Canada Post. 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 quitarla 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. Quitar la clave de un sitio no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.

Sin una clave activa, Canada Post no se muestra a los clientes en la finalización de compra. Los gestores de la tienda que han iniciado sesión lo siguen viendo, 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 necesitan una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.

Solución de problemas

Canada Post 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. Debe haber una tarifa: con claves de API, la dirección necesita un código postal válido (Canadá) o un código ZIP (Estados Unidos); si no, debe existir un precio fijo para el país o para *.

Las tarifas en tiempo real no aparecen: activa Debug log, vuelve a cargar la finalización de compra y abre WooCommerce > Status > Logs, origen vfd-canada-post. Ahí aparece el motivo: falta el nombre de usuario o la contraseña de la API, un código postal de envío o de destino no válido, falta el tipo de cambio a CAD, un paquete de más de 30 kg, o el mensaje de error de Canada Post. Mientras tanto, los clientes reciben el precio fijo si existe.

La tarifa es distinta a la del sitio web de Canada Post: con un número de cliente obtienes las tarifas comerciales (con descuento) de tu cuenta; sin él, las tarifas minoristas (de mostrador). Para las direcciones canadienses, el precio de Canada Post incluye GST/HST/PST. Los precios se convierten con tu tipo de cambio a CAD.

El impuesto se cobra dos veces en el envío: activa Canadian sales taxes, o pon Tax status en None.

Prueba los precios en una tienda real: desactiva Sandbox y usa la clave de API de producción.

Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Esto borra las tarifas de Canada Post 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 conectar con el 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 nunca se tocan.

Canada Post es una marca comercial de su respectivo titular. Este plugin no está afiliado ni respaldado por Canada Post.