VibeFox PostNord 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 de PostNord (para el selector de puntos de servicio): crea una cuenta gratuita en developer.postnord.com, añade una aplicación y copia su clave de API. Sin clave, los transportistas siguen funcionando, pero los clientes no pueden elegir un punto de servicio.

Contrato con PostNord: para enviar paquetes necesitas tu contrato habitual de cliente de PostNord, por ejemplo MyPack Collect o MyPack Home.

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 PostNord 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. Pega la API key de PostNord, elige tu Agreement country, rellena los Country prices (véase Configuración) y haz clic en Save.

Al instalarse, el módulo crea dos transportistas. PostNord entrega en un punto de servicio, con el texto de tiempo de entrega Delivery to a PostNord service point. Está activado. PostNord Home delivery entrega en la dirección, con el texto PostNord home delivery. Está desactivado hasta que actives Home delivery. Ambos transportistas están asignados a las zonas de Suecia, Dinamarca, Noruega y Finlandia y a todos los grupos de clientes. Puedes cambiar las zonas, los grupos de clientes, el texto del tiempo de entrega, el logotipo y los límites de tamaño en Shipping > Carriers. No configures 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 PostNord > Configure. Cada sección tiene su propio botón Save, que guarda toda la página. Cada guardado también borra las listas de puntos de servicio en caché.

Encima de los ajustes, la página avisa cuando todavía no hay clave de API, cuando todavía no hay precio, cuando se ha eliminado un transportista de PostNord o cuando el módulo no reconoce la unidad de peso de la tienda. En ese caso, los pesos de los productos se toman como kg. Usa kg, g, lb u oz en International > Localization (Local units).

General

Enable/Disable: activa o desactiva el transportista de punto de servicio. Es el mismo interruptor que el estado del transportista en Shipping > Carriers.

Name: el nombre del transportista de punto de servicio en la finalización de compra, por ejemplo «PostNord MyPack Collect». Por defecto: PostNord. Obligatorio.

Home delivery: ofrece también la entrega a domicilio de PostNord. Es el segundo transportista, sin punto de servicio. Desactivado por defecto.

Home delivery name: el nombre del transportista de entrega a domicilio en la finalización de compra, por ejemplo «PostNord MyPack Home». Por defecto: PostNord Home delivery. Obligatorio.

Tax status: None significa que los precios de abajo son definitivos. Taxable: seguido de una regla de impuesto significa que PrestaShop añade el impuesto de envío de esa regla a los precios. Se aplica a ambos transportistas.

API de PostNord (selector de puntos de servicio)

API key: la clave de API de tu aplicación en developer.postnord.com. Solo se envía a PostNord desde tu servidor, nunca al navegador, y nunca se escribe en el registro. 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.

Remove the saved API key: márcalo y haz clic en Save para eliminar la clave guardada.

Test mode: usa el entorno de prueba de PostNord (atapi2.postnord.com). Solo para claves emitidas para el entorno de prueba.

Agreement country: el país de tu contrato de cliente de PostNord: Suecia, Dinamarca, Noruega o Finlandia. Decide qué puntos de servicio se ofrecen. Same as the delivery country (por defecto) usa el país del cliente.

Precios

El título de la sección muestra la moneda predeterminada de tu tienda. Los precios están en esa moneda, sin impuestos, y son los mismos para ambos transportistas. PostNord no tiene una API pública de precios, así que tú defines tus propios precios, normalmente los de tu contrato con PostNord. El orden es: umbral de envío gratis, después la tabla por país y, por último, el coste alternativo.

Calculation type: Per order cobra el precio una sola vez. Per item (price x number of items) lo multiplica por el número de artículos del carrito.

Country prices: un precio por país de destino y peso del carrito. Haz clic en Add country para añadir una fila y en el icono de papelera para eliminar una. Cada fila tiene un Price y columnas de peso: XS hasta 1 kg, S hasta 2 kg, M hasta 3 kg, L hasta 5 kg y XL por encima de 5 kg. Una columna de peso con 0 usa la columna Price, y un Price de 0 significa envío gratis. El país * All other countries cubre todos los países sin fila propia. Decimales con coma o punto (9,99 o 9.99). Una fila nueva empieza como * All other countries con todos los precios en 0. Elige el país e introduce los precios antes de guardar, o elimina la fila. Una celda vacía se guarda como 0. Una celda que no es un número se guarda como 0, con un mensaje.

Fallback cost: se usa cuando la tabla de países no tiene fila para el destino ni fila *. Déjalo vacío para ocultar los transportistas de esos países.

Free shipping from: el subtotal del carrito (productos que requieren envío, después de descuentos, sin impuestos) a partir del cual PostNord es gratis. Se comprueba antes que la tabla por país, así que también se aplica a un país sin fila de precio. Déjalo vacío para no ofrecer nunca envío gratis.

Disponibilidad

Min weight (kg): oculta los transportistas cuando el carrito pesa menos. Los pesos de los productos se convierten desde la unidad de peso de tu tienda. 0 significa sin límite.

Max weight (kg): oculta los transportistas cuando el carrito pesa más. Por defecto: 30. 0 significa sin límite. Revisa el límite de peso de tu servicio de PostNord: las taquillas aceptan menos que los puntos de servicio. Un Min weight (kg) mayor que Max weight (kg) se rechaza con un error y no se guarda nada.

Minimum subtotal: muestra los transportistas solo si el subtotal del carrito (productos que requieren envío, después de descuentos, sin impuestos) es al menos este importe. Déjalo vacío para mostrarlos siempre.

Ignore shipping zones: cuando está activado, PostNord se ofrece para los países de abajo aunque las zonas de sus transportistas no los incluyan. Los transportistas se vinculan a todas las zonas activas, y una zona que crees más adelante se vincula de inmediato. Al desactivarlo, los transportistas recuperan las zonas que tenían antes. Desactivado, los transportistas solo se ofrecen en sus propias zonas.

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

Los importes y los pesos aceptan coma o punto. Un valor que no sea un número de 0 o más no se guarda, y se muestra un mensaje.

Avanzado

Debug log: escribe los cálculos de tarifas y las llamadas a la API en logs/vfd_ptnd_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. La clave de API nunca se registra. Desactiva el registro cuando termines.

Log: muestra el tamaño y las entradas más recientes del registro de depuración. Haz clic en Clear log para vaciarlo.

Remove data on uninstall: cuando está activado, al desinstalar el módulo se borran los ajustes y los transportistas de PostNord. Cuando está desactivado, desinstalar solo desactiva los transportistas. Los puntos de servicio guardados en los pedidos siempre se conservan.

Cómo funciona en la finalización de compra

En el paso de envío, PrestaShop pide al módulo el precio de cada transportista de PostNord. Solo cuentan los productos físicos: los productos virtuales no suman peso ni se incluyen en el subtotal. El módulo comprueba el peso del carrito y el subtotal mínimo. Si se aplica el envío gratis, el precio es 0. Si no, el precio sale de la tabla por país y, después, del coste alternativo. Si no hay precio, el transportista se oculta. El precio se calcula en la moneda predeterminada de tu tienda y después se muestra en la moneda del carrito del cliente.

Para el transportista de punto de servicio y una dirección de entrega en Suecia, Dinamarca, Noruega o Finlandia, tu servidor pide a la API Business Location de PostNord los 10 puntos de servicio más cercanos al código postal de entrega. Envía el país y el código postal de entrega, y el país del contrato. El tiempo de espera de la API es de 10 segundos. Las listas se guardan en caché durante 6 horas por código postal, y las respuestas «sin puntos» durante 1 hora. Los errores de la API se guardan en caché durante 5 minutos, para que una caída de PostNord no ralentice cada actualización del paso de entrega. El paso de entrega nunca espera a PostNord: si la lista todavía no está en caché, se carga cuando el cliente selecciona el transportista.

Para otros destinos, los transportistas pueden seguir ofreciéndose con tus precios, sin selector. El transportista de entrega a domicilio nunca muestra un selector.

Si editas un 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 no solicita precios en tiempo real de PostNord y no crea etiquetas de envío, no reserva envíos (EDI), no proporciona números de seguimiento ni envía correos de seguimiento. No hay vista de mapa. Para los envíos usa PostNord Portal, Skicka Direkt Business o una herramienta de etiquetas; esas herramientas necesitan el ID del punto de servicio guardado.

Puntos de recogida

Cuando el cliente selecciona el transportista de punto de servicio, aparece debajo una lista de PostNord service point con los puntos más cercanos, agrupados por ciudad con la distancia. Antes de introducir un código postal, el cliente ve «Introduce tu código postal para elegir un punto de servicio de PostNord.» La elección se guarda con el carrito y se mantiene al actualizar el paso de entrega.

Cuando la lista está cargada, es obligatorio elegir un punto. Si no se elige ninguno, Continue se detiene con el mensaje «Selecciona un punto de servicio de PostNord.» El punto elegido se comprueba en el servidor con la lista de PostNord para la dirección de entrega. Un punto elegido para otro código postal no se usa.

El selector nunca bloquea una venta. Si la lista no se puede cargar (todavía no hay clave de API, la API de PostNord no responde o no hay puntos cerca del código postal), el cliente ve un aviso y puede hacer el pedido igualmente. PostNord entonces entrega en el punto de servicio más cercano a la dirección.

Pantalla de pedido del back office: un bloque PostNord service point con el nombre, la dirección y el Service point ID. Si no se eligió ningún punto, aparece el texto «no seleccionado: PostNord entrega en el punto de servicio más cercano a la dirección de envío».

Confirmación del pedido y detalles del pedido del cliente: PostNord service point: con el nombre y la dirección.

Correos electrónicos del pedido: la confirmación del pedido al cliente y la alerta de nuevo pedido a la tienda muestran el nombre, la dirección y el ID del punto junto al nombre del transportista. La alerta de la tienda también muestra «not selected» cuando no hay punto.

Clave de licencia

El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox PostNord es el primer bloque de Modules > Module Manager > VibeFox PostNord > 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-postnord 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 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, los transportistas de PostNord no se muestran a los clientes en la finalización de compra y no se calcula ningún precio de envío. La tienda de PrestaShop no sabe que has iniciado sesión en el back office, así que los transportistas también se ocultan 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 el módulo elimina siempre la clave de licencia y el estado de la licencia. Reset de este módulo no borra datos, así que la clave y el estado se conservan.

Solución de problemas

PostNord no aparece en la finalización de compra: comprueba que la licencia esté activa y que Enable/Disable (o Home delivery) esté activado. En Shipping > Carriers, comprueba que el transportista cubra la zona del país del cliente y su grupo, o activa Ignore shipping zones. Comprueba que haya un precio para el país (fila del país, fila * o Fallback cost), los límites de peso y el Minimum subtotal. Los productos también pueden estar limitados a ciertos transportistas en la página del producto.

El selector indica que no se pueden cargar los puntos de servicio: comprueba la API key y el ajuste Test mode. Una clave de producción no funciona en el entorno de prueba, y viceversa. Activa el Debug log, recarga la finalización de compra y mira el campo Log en la página del módulo. El pedido aún puede realizarse; PostNord entonces entrega en el punto de servicio más cercano.

Puntos de servicio inesperados: comprueba Agreement country. Decide qué puntos de servicio se ofrecen.

El envío sale gratis por error: revisa Country prices en busca de filas con un Price de 0, sobre todo una fila * añadida con Add country y dejada sin rellenar, y revisa Free shipping from.

Los puntos de servicio parecen desactualizados tras un cambio: haz clic en Save en la página del módulo. Así se borran las listas en caché.

La página indica que no se encontró un transportista de PostNord: 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 PostNord y elige Uninstall. La clave de licencia y el estado de la licencia siempre se eliminan. Desactivar el módulo solo borra las listas de puntos de servicio en caché. Al desinstalar, las listas en caché siempre se eliminan. Si Remove data on uninstall está activado, los transportistas se eliminan (los pedidos conservan su historial) y se borran los ajustes y el registro. Si está desactivado, los transportistas solo se desactivan y todos los ajustes se conservan. Volver a instalar el módulo devuelve a los transportistas guardados el estado que tenían. Los puntos de servicio guardados en los pedidos siempre se conservan.

PostNord es una marca comercial de su respectivo titular. Este módulo no está afiliado a PostNord ni cuenta con su aprobación.