VibeFox Purolator for PrestaShop — Ayuda

Requisitos

PrestaShop: de 8.0 a 9.x.

PHP: 8.0 o posterior. El módulo no se instala en versiones anteriores de PHP. 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 de la web de Purolator. Purolator entrega claves y contraseñas distintas para los entornos de desarrollo y de producción. También necesitas el número de tu 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 solo 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 VibeFox Purolator más tarde en la lista de módulos y haz clic en Configure.

3. Introduce 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 (véase Clave de licencia).

4. Para tarifas en tiempo real rellena la sección Purolator API (live rates). Para 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). Haz clic en Save.

Al instalar, el módulo crea el transportista Purolator con el texto del plazo de entrega Purolator courier. El transportista se asigna a todas las zonas y a todos los grupos de clientes. Puedes cambiar zonas, grupos de clientes, plazo de entrega, logotipo y límites de tamaño en Shipping > Carriers. No definas precios allí: el precio siempre viene del módulo.

Configuración

Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox Purolator > Configure. Cada sección tiene su propio botón Save, que guarda toda la página. Cada guardado también borra las tarifas de Purolator en caché.

Si las tarifas en tiempo real no pueden funcionar con los valores guardados (falta la clave, la contraseña o la cuenta de facturación, 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, aparece un aviso encima de los ajustes. También aparece un aviso si la unidad de peso de la tienda no es una que el módulo conoce (kg, g, lb, oz y similares). En ese caso, los pesos de los productos se toman como kg. Define la unidad de peso en International > Localization (Local units).

Un campo numérico que no contiene un número igual o mayor que 0 no se guarda. Un aviso indica el campo y el valor. El campo queda vacío o recibe su valor predeterminado en el caso de los campos de peso. Un valor incorrecto en Country prices se guarda como 0, y el aviso indica el país y la columna. Si Min cart weight es mayor que Max cart weight, no se guarda nada y se muestra un error.

General

Enable Purolator: activa o desactiva el transportista. Es el mismo interruptor que el estado del transportista en Shipping > Carriers.

Method title: el nombre del transportista que se muestra en el carrito y en la finalización de compra. Predeterminado: Purolator. Obligatorio, máximo 64 caracteres.

Tax: la regla fiscal del transportista, o No tax. Decide si la tienda añade impuestos sobre el coste del envío. Para direcciones canadienses, el total de Purolator ya incluye GST/HST/PST/QST. Consulta 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 viene del servicio web Purolator E-Ship Estimating. Si Purolator no devuelve ninguna tarifa, se usa el precio fijo, o el transportista se oculta cuando no hay ninguno. La sección tiene un enlace al Purolator E-Ship Resource Centre, donde te registras y obtienes las claves.

API key: tu clave de E-Ship Web Services para el entorno seleccionado. Después de guardar, el campo queda vacío y muestra Saved — leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarla.

API password: la contraseña que corresponde a la clave. Como la clave, no se vuelve a mostrar después de guardar.

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. Borrar este campo también elimina la clave y la contraseña de API guardadas.

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: usa precios de Purolator sin GST/HST/PST/QST. Para direcciones canadienses, el total de Purolator incluye estos impuestos. Actívalo cuando el transportista tenga una regla fiscal en Tax, para no cobrar el impuesto dos veces.

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

Default product weight: en kg, se usa para cada producto que no tiene peso. Predeterminado: 0.5. Los pesos se convierten desde la unidad de peso 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: precio por país y peso del carrito, en la moneda predeterminada de tu tienda, sin impuestos. Haz clic en Add country para añadir una fila y en el icono de papelera para quitar una. Elige * Default (all other countries) para una fila que cubra todos los países que no tengan fila propia. Cada fila tiene un precio Base y columnas de tamaño: XS hasta 1 kg, S de 1 a 2 kg, M de 2 a 3 kg, L de 3 a 5 kg y XL más de 5 kg. Un precio de tamaño vacío o igual a cero usa Base. Un Base de 0, o un Base vacío, significa envío gratuito para los pesos sin precio de tamaño propio. Se aceptan tanto 9.99 como 9,99. Las filas sin ningún precio no se guardan, y 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 transportista en esos países.

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 envío completo.

Condiciones

Min cart weight: en kg, oculta el transportista cuando el carrito pesa menos. 0 significa sin límite.

Max cart weight: en kg, oculta el transportista cuando el carrito pesa más. Predeterminado: 30. 0 significa sin límite.

Minimum order amount: muestra el transportista solo cuando el subtotal del carrito (después de descuentos, antes de impuestos) alcanza este importe. Déjalo vacío para mostrarlo siempre.

Free shipping from: el subtotal del carrito (después de descuentos, antes de impuestos) a partir del cual el envío es gratuito. En ese caso no se envía ninguna solicitud a Purolator. Déjalo vacío para no ofrecer nunca envío gratuito.

Para estas condiciones, el peso del carrito cuenta los productos sin peso como 0.

Disponibilidad sin zonas de envío

Normalmente el transportista se ofrece en las zonas a las que está asignado en Shipping > Carriers.

Ignore shipping zones: ofrece Purolator para los países indicados abajo, sin importar qué zona coincida. Al guardar, el transportista se añade a todas las zonas, y las zonas creadas después también se añaden. Al desactivar esta opción, esas zonas se eliminan de nuevo.

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

Avanzado

Debug log: escribe los cálculos de tarifas en logs/vfd_prlr_debug.log.php dentro de la carpeta del módulo. El archivo no se puede abrir desde la web. Los errores de la API siempre se registran, aunque el registro de depuración esté 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.

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 borran los ajustes, el transportista, las tarifas en caché y los registros. Si está desactivado, todo se conserva para una reinstalación.

Cómo funciona en la finalización de compra

En el paso de envío, PrestaShop pide al módulo el precio de Purolator. Solo cuentan los productos físicos: los productos virtuales no suman peso ni se incluyen en el importe del pedido. Antes de que el cliente introduzca una dirección, el precio se estima para el país que la tienda usa para las estimaciones. El módulo comprueba primero las condiciones: países permitidos (con Ignore shipping zones), peso del carrito e importe mínimo del pedido. Si se aplica envío gratuito, el precio es 0 y no se envía ninguna solicitud a Purolator. Después busca un precio: primero la tarifa en tiempo real de Purolator, luego la tabla por país y después el precio alternativo. Si no hay precio, el transportista se oculta.

Con credenciales de API, el módulo envía a Purolator una solicitud Quick Estimate: tu cuenta de facturación, el código postal de origen, la ciudad, la provincia o el estado del cliente, el país y el código postal, y el peso total del carrito en libras enteras. Para Canadá se necesita un código postal válido; para Estados Unidos, un ZIP code 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 responde en francés o en inglés, según el idioma del cliente. Purolator devuelve los precios de todos los servicios; el módulo toma el servicio elegido o el más barato, quita los impuestos de venta canadienses si está configurado y convierte el precio desde CAD. 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 se guarda en caché durante 1 hora. Una solicitud fallida se guarda en caché 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 (API caída, 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 transportista se oculta si no hay precio fijo. 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 envíos de Purolator, no imprime etiquetas, no reserva recogidas, no gestiona devoluciones ni hace seguimiento de paquetes. No usa Full Estimate (dimensiones, varias piezas, opciones como firma o mercancías peligrosas), no muestra fechas de entrega, no muestra varios servicios como transportistas separados ni obtiene tipos de cambio automáticamente.

Pedidos

Cuando se realiza un pedido con una tarifa de Purolator en tiempo real, el servicio se guarda con el pedido. Los recálculos posteriores del carrito no lo cambian. En la página del pedido en el back office (Orders > Orders, abre el pedido) un bloque Purolator muestra Purolator service (nombre y código) y Live rate (excl. tax). Los pedidos con precios fijos o con envío gratuito no tienen este bloque.

Clave de licencia

El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Purolator es el primer bloque de Modules > Module Manager > VibeFox Purolator > Configure, por encima de los ajustes. Introduce 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 eliminar la clave de esta tienda. Debajo están la línea Product: presta-shipping-purolator 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 después de 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. Libérala en tu cuenta de vibefox.net.

Sin una clave activa, el transportista de Purolator no se muestra a los clientes en la finalización de compra, y no se solicita ni se calcula ninguna tarifa. La tienda de PrestaShop no sabe que has iniciado sesión en el back office, así que el transportista también se oculta 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 necesitan 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 después de introducir la clave, y después una vez por semana. No se necesita 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

Purolator no aparece en la finalización de compra: comprueba que la licencia está activa y que Enable Purolator está activado. En Shipping > Carriers comprueba que el transportista cubre la zona del país del cliente y el grupo del cliente (o que Ignore shipping zones está activado y el país está permitido). Revisa los límites de peso y Minimum order amount. Si Purolator no devuelve ninguna tarifa, el transportista solo se muestra con un precio por país, una fila * o un Fallback price. En la página del producto también se pueden limitar los productos a ciertos transportistas.

Las tarifas en tiempo real no aparecen: mira el campo Log en la página del módulo. Los errores de la API siempre aparecen allí. Activa Debug log y vuelve a cargar la finalización de compra para ver los detalles. Con claves de API, la dirección debe tener un código postal válido (Canadá) o un ZIP code (Estados Unidos). Revisa también los avisos encima de los ajustes.

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

La tarifa es distinta 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 direcciones canadienses el total incluye los impuestos de venta; usa Canadian sales taxes si el transportista tiene una regla fiscal. Los precios se convierten con tu CAD → (shop currency) rate.

Un valor desapareció después de guardar: lee el aviso que aparece tras Save. El valor no era un número igual o mayor que 0, así que no se guardó. Vuelve a introducirlo como un número simple.

Las tarifas parecen desactualizadas tras un cambio: haz clic en Save en la página del módulo. Esto borra las tarifas de Purolator en caché.

La página dice que no se encontró el transportista de Purolator: el transportista se eliminó en Shipping > Carriers. Restablece el módulo en Modules > Module Manager para volver a crearlo.

Desinstalación

Ve a Modules > Module Manager, abre el menú junto a VibeFox Purolator y elige Uninstall. La clave de licencia y el estado de la licencia siempre se eliminan. Las tarifas en caché siempre se eliminan. Si Remove data on uninstall está activado, el transportista se elimina (los pedidos conservan su historial) y se borran los ajustes, los servicios de Purolator guardados en los pedidos y el registro. Si está desactivado, el transportista solo se desactiva y todos los ajustes se conservan; los pedidos realizados conservan su servicio de Purolator. Al volver a instalar el módulo o al hacer un Reset, el transportista recupera el estado que tenía antes.

Purolator es una marca de su respectivo titular. Este módulo no está afiliado a Purolator ni avalado por la empresa.