VibeFox Australia Post for PrestaShop — Ayuda
Requisitos
PrestaShop: 8.0 a 9.x.
PHP: 8.0 o posterior. El módulo no se instala en versiones anteriores de PHP.
Clave de API PAC de Australia Post (solo para tarifas en tiempo real): las tarifas en tiempo real usan la API Postage Assessment Calculator (PAC) de Australia Post. La clave es gratuita: regístrate para obtener una clave de API PAC en el Centro para desarrolladores de Australia Post (developers.auspost.com.au). La página del módulo enlaza con la página de registro. 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 el back office, ve a Modules > Module Manager y haz clic en Upload a module. Elige el archivo ZIP del módulo.
2. Cuando termine la carga, haz clic en Configure, o busca más tarde VibeFox Australia Post en la lista de módulos y haz clic en Configure.
3. Pega tu clave de licencia de VibeFox en License key en el bloque de licencia de la parte superior de la página Configure y haz clic en Activate (ver Clave de licencia).
4. Elige el Rate source. Para tarifas en tiempo real, introduce la clave de API PAC, tu código postal de origen y, si la moneda predeterminada de tu tienda no es AUD, el tipo de cambio a AUD (véase Configuración). Haz clic en Save.
Al instalarse, el módulo crea el transportista Australia Post con el texto del plazo de entrega Australia Post parcel delivery. El transportista se asigna a todas las zonas y a todos los grupos de clientes. Puedes cambiar las zonas, los grupos de clientes, el plazo de entrega, el logotipo, los límites de tamaño y la regla de impuestos en Shipping > Carriers. No establezcas precios allí: el precio siempre procede del módulo.
Configuración
Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox Australia Post > Configure. Se aplican a todas las zonas. En la parte superior de la página aparecen el nombre y el ID del transportista en Shipping > Carriers. Cada sección tiene su propio botón Save, que guarda toda la página. Cada guardado también borra las tarifas de Australia Post en caché.
Si se elige una fuente de tarifas en tiempo real pero falta la clave de API, un código postal de origen de 4 dígitos o el tipo de cambio a AUD, se muestra una advertencia tras guardar. También indica qué ocurre hasta que lo corrijas: el transportista se oculta en la finalización de compra, o se usan los precios fijos por país en el modo de respaldo.
Los campos numéricos aceptan un punto o una coma como separador decimal. Un valor que no es un número o es negativo no se guarda: una advertencia indica el campo y se conserva el valor anterior. La página también avisa si la unidad de peso o de dimensiones de la tienda (International > Localization) no es una que el módulo conoce. En ese caso, los pesos de los productos se leen como kg y las dimensiones como cm.
General
Enable Australia Post: desactiva el transportista en todas las zonas a la vez. Es el mismo interruptor que el estado del transportista en Shipping > Carriers.
Method title: el nombre del transportista que ve el cliente en la finalización de compra. También es el nombre del transportista en Shipping > Carriers, y si cambias el nombre allí, este campo se actualiza. Predeterminado: Australia Post. Máximo 64 caracteres: un título más largo se rechaza y no se guarda nada. Si el campo está vacío o contiene caracteres que PrestaShop no permite en el nombre de un transportista, se muestra una advertencia y se usa Australia Post.
Tax status: cómo se aplica el impuesto al coste del envío.
Rate source: cómo se calcula el precio.
Los detalles de los errores se envían al registro, nunca al cliente.
Australia Post API (live rates) (no es necesario 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. Después de guardar, el campo queda vacío y muestra Saved — leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarlo.
Remove the saved API key: activa y guarda para eliminar la clave guardada. Las tarifas en tiempo real dejan de funcionar.
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 de la API nacional entre 1,1. Los precios nacionales de Australia Post incluyen un 10% de GST. Actívalo cuando PrestaShop añada el impuesto al envío (Tax status = Taxable con una regla de impuestos en el transportista), para no cobrar el GST dos veces. El franqueo internacional está exento de GST y nunca se modifica.
AUD → (your currency) rate: la etiqueta muestra la moneda predeterminada de tu tienda. Los precios de Australia Post están en AUD. Si tu moneda predeterminada no es AUD, introduce cuántas unidades de tu moneda vale un AUD, por ejemplo 0.61. El tipo debe ser mayor que 0. Sin él, no se usan las tarifas en tiempo real. Si tu moneda predeterminada es AUD, la página indica que no hace falta conversión: deja el campo 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 sin peso, en la solicitud a Australia Post y en la comprobación de Min cart weight (kg) / Max cart weight (kg). 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.
Cuando los productos tienen dimensiones, el paquete toma la mayor longitud y anchura de ellos, y la altura aumenta hasta que el paquete contiene el volumen de todos los artículos.
Precios fijos (se usan con precios fijos y como alternativa de las tarifas en tiempo real)
Country prices: una tabla de códigos de país de 2 letras (AU, NZ, US, etc.) y precios en la moneda predeterminada de tu tienda, sin impuestos. Haz clic en Add row para añadir un país y en el enlace × para eliminar uno. Usa * para todos los demás países. Un país sin precio (y sin fila *) no tiene tarifa fija, así que el transportista se oculta para él. Las filas con un código de país no válido o sin precio se eliminan al guardar. La tabla está vacía hasta que añadas 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 transportista si el peso del carrito es inferior a este valor. 0 significa sin límite.
Max cart weight (kg): oculta el transportista si el peso del carrito supera este valor. Predeterminado: 22. 0 significa sin límite; un campo vacío equivale a 22 kg. Paquetes de Australia Post: 22 kg nacionales, 20 kg internacionales. Si Min cart weight (kg) es mayor que el máximo, el transportista nunca se mostraría: aparece una advertencia y ambos pesos conservan sus valores anteriores.
Minimum order amount: muestra el transportista solo cuando el subtotal de productos (después de descuentos, sin impuestos) alcanza este importe, en la moneda predeterminada de tu tienda. Déjalo vacío para mostrarlo siempre.
Free shipping: activa el envío gratuito a partir del importe indicado abajo.
Free shipping from: el subtotal de productos (después de descuentos, sin impuestos) a partir del cual el envío es gratuito. En ese caso no se hace ninguna solicitud a la API. Solo se usa cuando Free shipping está activado.
Disponibilidad sin zonas de envío
Normalmente el transportista se ofrece en las zonas seleccionadas para él en Shipping > Carriers.
Ignore shipping zones: ofrece el transportista para los países indicados abajo, sea cual sea la zona que coincida. Al guardar, el transportista se vincula a todas las zonas, y las zonas que crees después se vinculan automáticamente. Al desactivar la opción, se restauran las zonas que tenía el transportista antes.
Countries: los países de destino para ese modo. Déjalo vacío para permitir todos los países activos. Mantén pulsada la tecla Ctrl (Cmd en Mac) y haz clic para seleccionar varios. Solo se usa con Ignore shipping zones.
Avanzado
Debug log: registra los cálculos de tarifas en modules/vfd_australia_post/logs/vfd_ap.log.php. El archivo no se puede abrir desde la web. Los errores de la API siempre se registran. La clave de API y los códigos postales de los clientes no se registran. Desactiva el registro cuando termines.
Log: muestra el tamaño y las entradas más recientes del registro. Haz clic en Clear log para vaciarlo.
Remove data on uninstall: si está activado, al desinstalar el módulo se eliminan los ajustes, las tarifas en caché y el registro. El transportista siempre se elimina al desinstalar. Al volver a instalar, se restaura si los datos se conservaron.
Cómo funciona en la finalización de compra
En el paso de envío, PrestaShop pide al módulo el precio de Australia Post. Solo cuentan los productos físicos: los productos virtuales no suman peso ni se incluyen en el importe del pedido. El módulo primero comprueba las condiciones: la lista Countries (con Ignore shipping zones), el peso del carrito y el Minimum order amount. Si se aplica el envío gratuito, el precio es 0 y no se envía ninguna solicitud a Australia Post.
En el modo de precios fijos, el precio se toma de la tabla. En los modos de tarifas en tiempo real, el módulo envía a Australia Post el peso del paquete y, en envíos dentro de Australia, los códigos postales de origen y de destino y el tamaño del paquete; en envíos internacionales, el país de destino. Una tarifa nacional en tiempo real solo se solicita cuando la dirección de entrega tiene un código postal de 4 dígitos. No se envía ninguna solicitud cuando 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 elimina el GST de los precios nacionales si Remove GST está activado. El precio se calcula en la moneda predeterminada de tu tienda y después se muestra en la moneda del carrito del cliente.
Cada respuesta correcta se guarda en caché durante 1 hora, para que el mismo carrito no genere una nueva solicitud. 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. El tiempo de espera de la API es de 10 segundos. Los errores de la API nunca se muestran al cliente: el transportista se oculta o se usa el precio fijo en el modo de respaldo. El motivo se escribe en el registro.
Si editas el transportista en Shipping > Carriers después de que tenga pedidos, PrestaShop lo guarda como una nueva versión del transportista. El módulo sigue la nueva versión automáticamente.
El módulo solo calcula tarifas. No crea etiquetas de envío, envíos o manifiestos de eParcel o MyPost Business, no rastrea paquetes ni permite a los clientes elegir taquillas de paquetes u oficinas de correos. El carrito siempre se tarifa como un único paquete. No se incluyen las cartas, las bolsas ni las tarifas de contrato (eParcel).
Clave de licencia
El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Australia Post es el primer bloque de Modules > Module Manager > VibeFox Australia Post > Configure, por encima de los ajustes. Pega la clave en License key y haz clic en Activate. Después, el bloque muestra la clave enmascarada, el estado (por ejemplo, la fecha hasta la que la licencia está activa y tu dominio) y los botones Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para quitar la clave de esta tienda. Debajo aparecen la línea Product: presta-shipping-australia-post y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los empleados con el permiso Configure del módulo pueden cambiar la clave. Los textos del bloque siguen el idioma del back office (se incluyen inglés y ruso).
Si la clave no se acepta, el bloque indica el motivo, por ejemplo Key not found, This key belongs to another product, Domain limit reached o License expired on seguido de una fecha. Después de cambiar la dirección de la tienda, o tras liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si no se puede contactar con el servidor de licencias, el módulo sigue funcionando con el último estado conocido.
Una clave funciona en un solo dominio: el dominio de la tienda principal, también en una configuración multitienda. Quitar la clave de la tienda no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.
Sin una clave activa, el transportista de Australia Post no se muestra a los clientes en la finalización de compra y no se calcula ninguna tarifa. La tienda no sabe que has iniciado sesión en el back office, así que el transportista también queda oculto para ti: puedes configurar el módulo antes de comprar una clave, pero no probarlo en la finalización de compra. Aparece un recordatorio en Modules > Module Manager, en la pestaña Alerts. Los pedidos existentes no se ven afectados.
Cuando una licencia caduca, el módulo sigue funcionando, pero las actualizaciones y el soporte requieren una renovación. El estado se vuelve a comprobar automáticamente mientras trabajas en el back office: una vez al día durante los primeros 14 días tras introducir la clave, y después una vez a la semana. No hace falta ningún cron job. Desinstalar o restablecer el módulo elimina siempre la clave de licencia y el estado de la licencia.
Solución de problemas
Australia Post no aparece en la finalización de compra: comprueba que la licencia está activa y que Enable Australia Post está activado (el transportista está activo en Shipping > Carriers). En Shipping > Carriers, comprueba que el transportista cubre la zona del país del cliente y su grupo (o que Ignore shipping zones está activado y el país está permitido en Countries). Revisa los límites de peso del carrito y el Minimum order amount. En el modo de precios fijos, comprueba que el país o * tiene un precio. Los productos también pueden limitarse a determinados transportistas en la página del producto.
Las tarifas en tiempo real no aparecen: activa el Debug log, recarga la finalización de compra y mira el campo Log de la página del módulo. Indica 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 corriges el problema.
Mi tienda no usa AUD: introduce el tipo de cambio (cuántas unidades de tu moneda predeterminada vale un AUD) en el campo AUD → (your currency) rate. Los precios fijos siempre están en tu moneda predeterminada.
El GST se cobra dos veces en el envío: los precios nacionales de Australia Post incluyen un 10% de GST. Si Tax status es Taxable y el transportista tiene una regla de impuestos, activa Remove GST o define Tax status como None.
No se añade impuesto al envío: con Tax status = Taxable, el impuesto procede de la regla de impuestos del transportista. Selecciónala en Shipping > Carriers. La página del módulo muestra una advertencia mientras el transportista no tenga regla de impuestos.
El precio es demasiado alto o demasiado bajo: revisa los pesos y las dimensiones de los productos y los valores predeterminados de Paquete para tarifas en tiempo real. Con Item (price × quantity), los precios fijos se multiplican por el número de artículos.
Las tarifas parecen desactualizadas tras un cambio: haz clic en Save en la página del módulo. Así se borran las tarifas de Australia Post en caché.
La página indica que el transportista de Australia Post se ha eliminado: el transportista se eliminó en Shipping > Carriers. Haz clic en Save en la página del módulo para volver a crearlo, o restablece el módulo en Modules > Module Manager.
Desinstalación
Ve a Modules > Module Manager, abre el menú junto a VibeFox Australia Post y elige Uninstall. La clave de licencia y el estado de la licencia se eliminan siempre. El transportista siempre se elimina (los pedidos conservan su historial) y las tarifas en caché se borran. Si Remove data on uninstall está activado, también se eliminan los ajustes, la tabla de caché de tarifas y el registro. Si está desactivado, los ajustes se conservan y al volver a instalar el módulo se restaura el transportista con sus zonas, grupos y logotipo.
Australia Post es una marca comercial de su titular. Este módulo no está afiliado a Australia Post ni cuenta con su respaldo.