VibeFox Australia 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.
Clave de API PAC de Australia Post (solo para tarifas en tiempo real): las tarifas en tiempo real usan la API PAC (Postage Assessment Calculator) de Australia Post. La clave es gratuita: regístrate para obtener una clave de API PAC en el Centro de Desarrolladores de Australia Post (developers.auspost.com.au). También necesitas el código postal australiano de 4 dígitos desde el que envías. Si solo usas precios fijos por país, no necesitas clave 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_australia_post a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox Australia 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. Elige la Rate source. Para las tarifas en tiempo real, introduce la clave de API PAC, tu código postal de origen y, si la moneda de tu tienda no es AUD, el tipo de cambio a AUD (véase Configuración).
6. Añade VibeFox Australia Post 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 Australia 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 único campo:
Title (zone): el nombre que ve el cliente para esta zona. Déjalo vacío para usar el Method title general.
Cada vez que guardas los ajustes, se borran las tarifas de Australia Post en caché. Si eliges tarifas en tiempo real pero falta la clave de API, el código postal de origen o el tipo de cambio a AUD, aparece una advertencia tras guardar.
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 ve el cliente en la finalización de compra. Una zona puede sustituirlo por su propio título. Predeterminado: Australia Post.
Tax status: Taxable añade el impuesto de WooCommerce al coste del envío; None no lo añade.
Rate source: cómo se calcula el precio.
Los detalles de los errores se envían al registro, nunca al cliente.
API de Australia Post (tarifas en tiempo real) (no es necesaria para precios fijos)
PAC API key: tu clave gratuita de la API PAC de Australia Post. Se envía a Australia Post en la cabecera AUTH-KEY.
Ship-from postcode: el código postal australiano de 4 dígitos desde el que se envían los paquetes, por ejemplo 2000.
Domestic service: se usa para envíos dentro de Australia (hasta 22 kg, 105 cm por lado): Parcel Post (predeterminado) o Express Post.
International service: se usa para envíos fuera de Australia (hasta 20 kg): International Standard (predeterminado), International Express o International Courier.
Remove GST: divide los precios nacionales de la API entre 1,1. Los precios nacionales de Australia Post incluyen el 10 % de GST. Actívalo cuando WooCommerce añada el impuesto al envío (Tax status = Taxable), para no cobrar el GST dos veces. El franqueo internacional no lleva GST y nunca se modifica.
AUD → (your currency) rate: los precios de Australia Post están en AUD. Si la moneda de tu tienda no es AUD, introduce cuántas unidades de tu moneda equivale a 1 AUD, por ejemplo 0.61. Sin este dato no se usan las tarifas en tiempo real. Si la moneda de tu tienda es AUD, déjalo vacío. Se aceptan tanto el punto como la coma como separador decimal.
Paquete para tarifas en tiempo real
El carrito se envía como un único paquete. Los pesos y las dimensiones de los productos se convierten de las unidades de tu tienda a kg y cm. Los valores siguientes se usan para los productos sin peso ni dimensiones.
Default product weight (kg): se usa para cada producto que no tiene peso, en la solicitud a Australia Post y en la comprobación de Min cart weight / Max cart weight. Predeterminado: 1.
Default parcel length (cm): se usa cuando ningún producto del carrito tiene dimensiones. Predeterminado: 22.
Default parcel width (cm): se usa cuando ningún producto del carrito tiene dimensiones. Predeterminado: 16.
Default parcel height (cm): se usa cuando ningún producto del carrito tiene dimensiones. Predeterminado: 8.
Precios fijos (se usan con precios fijos y como alternativa de las tarifas en tiempo real)
Country prices: una tabla con códigos de país de 2 letras (AU, NZ, US, etc.) y precios en la moneda de tu tienda. Haz clic en + Add row para añadir un país y en el botón de eliminar para borrar uno. Usa * para todos los demás países. Un país sin precio (y sin fila *) no tiene tarifa fija, así que el método se oculta para él. La tabla está vacía hasta que añades precios.
Fixed price per: Order cobra el precio una sola 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. Predeterminado: 22. 0 significa sin límite. Paquetes de Australia Post: 22 kg nacionales, 20 kg internacionales.
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 hace 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 tu tienda. Se usa solo con Ignore shipping zones.
Avanzado
Debug log: registra los cálculos de tarifas en WooCommerce > Status > Logs, origen «vfd-australia-post». Los errores de la API siempre se registran. La clave de API 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. El plugin comprueba primero el peso del carrito, el Minimum order amount y las Excluded shipping classes. Si se aplica el envío gratuito, la tarifa es 0 y no se envía ninguna solicitud a Australia Post.
En el modo de precio fijo, el precio se toma de la tabla. En los modos de tarifas en tiempo real, el plugin envía a Australia Post el peso del paquete y, en los envíos nacionales, los códigos postales de origen y de entrega y el tamaño del paquete; en los envíos internacionales, el país de destino. Una tarifa en tiempo real nacional se solicita solo después de que el cliente haya introducido un código postal de 4 dígitos. No se envía ninguna solicitud si el paquete supera los límites de Australia Post (22 kg o 105 cm nacional, 20 kg internacional). El precio en AUD se convierte con tu tipo de cambio, y se quita el GST de los precios nacionales si Remove GST está activado.
Cada respuesta correcta se guarda en caché durante 1 hora, así que el mismo carrito no genera una solicitud nueva. Una solicitud fallida se guarda en caché durante 10 minutos, para que la finalización de compra no espere a Australia Post en cada actualización. Los errores de la API nunca se muestran al cliente: el método se oculta o, en el modo de respaldo, se usa el precio fijo.
El método funciona en la finalización de compra clásica y en los bloques de Carrito y Finalizar compra. Es compatible con el almacenamiento de pedidos de alto rendimiento de WooCommerce (HPOS).
El plugin solo calcula tarifas. No crea etiquetas de envío, envíos eParcel o MyPost Business ni manifiestos, no rastrea paquetes ni permite a los clientes elegir taquillas de paquetes u oficinas de correos. El carrito siempre se calcula como un único paquete. Las cartas, los sobres y bolsas (satchels) y las tarifas de contrato (eParcel) no están incluidas.
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 Australia 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 volver a comprobar el estado, 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 dominio. Quitar la clave de un sitio no libera su plaza de dominio. Libérala desde tu cuenta de vibefox.net.
Sin una clave activa, Australia Post no se muestra a los clientes en la finalización de compra. Los gestores de la tienda con sesión iniciada 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 aviso 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
Australia 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 del carrito, el Minimum order amount y las Excluded shipping classes. En el modo de precio fijo, comprueba que el país o * tiene un precio.
Las tarifas en tiempo real no aparecen: activa el Debug log, recarga la finalización de compra y abre WooCommerce > Status > Logs (origen «vfd-australia-post»). Ahí verás el motivo: falta la clave de API o el código postal de origen, aún no hay un código postal de entrega de 4 dígitos, el paquete supera los límites, falta el tipo de cambio a AUD o aparece el mensaje de error de Australia Post. Con Live rates, fixed price if the API gives no rate, los clientes siguen viendo el precio fijo mientras solucionas el problema.
Mi tienda no está en AUD: introduce el tipo de cambio (cuántas unidades de tu moneda equivale a 1 AUD) en AUD → (your currency) rate. Los precios fijos siempre están en la moneda de tu tienda.
El GST se cobra dos veces en el envío: los precios nacionales de Australia Post incluyen el 10 % de GST. Si Tax status es Taxable, activa Remove GST.
El precio es demasiado alto o demasiado bajo: revisa los pesos y las dimensiones de los productos y los valores predeterminados de Parcel for live rates. Con Item (price × quantity), los precios fijos se multiplican por el número de artículos.
Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Así se borran las tarifas de Australia 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 contactar 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 existentes conservan sus líneas de envío.
Australia Post es una marca registrada de su respectivo titular. Este plugin no está afiliado ni respaldado por Australia Post.