VibeFox PostNord for WooCommerce — Ayuda

Requisitos

WordPress: 5.8 o posterior.

WooCommerce: 7.0 o posterior, instalado y activo. El plugin no se activa sin él.

PHP: 8.0 o posterior.

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, el método sigue 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 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_postnord a /wp-content/plugins/ por FTP.

2. Haz clic en Activate.

3. Abre la configuración: WooCommerce > Settings > Shipping > VibeFox PostNord, 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. Pega la API key de PostNord, elige tu Agreement country y rellena los Country prices (ver Configuración).

6. Añade VibeFox PostNord a las zonas de envío de Suecia, Dinamarca, Noruega o Finlandia en WooCommerce > Settings > Shipping > Shipping zones. En la configuración del método, define su Title y su Delivery type. O activa Ignore shipping zones.

Configuración

Todos los ajustes, salvo el título y el tipo de entrega, están en una sola página: WooCommerce > Settings > Shipping > VibeFox PostNord. Se aplican a todas las zonas de envío. Cuando añades el método a una zona, la ventana de la zona tiene dos campos:

Title (zone): el nombre de esta opción en la finalización de compra, por ejemplo "PostNord MyPack Collect". Déjalo vacío para usar el Name global.

Delivery type (zone): Same as global setting (predeterminado), Service point / parcel locker o Home delivery. Añade dos métodos de PostNord a una zona para ofrecer ambos.

Encima de los ajustes, la página avisa cuando todavía no hay clave de API o ningún precio. Cada vez que guardas los ajustes, se borran las listas de puntos de servicio guardadas en caché.

General

Enable/Disable: si no está marcado, el método se oculta en todas partes, también en las zonas de envío.

Name: el nombre del método de envío que se muestra en la finalización de compra. Un método de zona puede sustituirlo por su propio Title. Predeterminado: PostNord.

Delivery type: el valor predeterminado para todos los métodos de PostNord; cada método de zona puede elegir el suyo.

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

API de PostNord (selector de punto 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 registra.

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. Determina qué puntos de servicio se ofrecen. Same as the delivery country (predeterminado) usa el país del cliente.

Precios

Los precios están en la moneda de la tienda. 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: primero la tabla por países y después el coste alternativo; el envío gratis se aplica solo donde alguno de los dos da un precio.

Calculation type: Per order cobra el precio una sola vez. Per item (price × 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 la cruz para eliminar una. Cada fila tiene una columna 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. 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, lo que significa envío gratis. Elige el país e introduce los precios antes de guardar, o elimina la fila. Una celda que no sea un número se guarda como 0, y aparece un aviso.

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

Free shipping from: el subtotal del carrito (después de descuentos, sin impuestos) a partir del cual PostNord es gratis. Se aplica solo donde hay un precio: una fila de país, la fila * o el coste alternativo. Déjalo vacío para no ofrecer nunca envío gratis.

Disponibilidad

Min weight (kg): oculta el método 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 el método cuando el carrito pesa más. Predeterminado: 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.

Minimum subtotal: muestra el método solo si el subtotal del carrito es al menos este importe. Déjalo vacío para mostrarlo siempre.

Disabled shipping classes: oculta el método cuando el carrito contiene un producto de cualquiera de estas clases de envío de WooCommerce.

Ignore shipping zones: si está activado, PostNord se ofrece para los países indicados abajo con los ajustes globales, aunque no esté añadido a una zona de envío. Si está desactivado, solo en las zonas de envío donde lo añadiste.

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

Los importes y los pesos admiten coma o punto. Un número no válido no se guarda y aparece un aviso.

Avanzado

Debug log: escribe los cálculos de tarifas y las llamadas a la API en WooCommerce > Status > Logs (origen "vfd-postnord"). Los errores de la API siempre se registran. La clave de API nunca se registra. Desactiva el registro cuando termines.

Remove data on uninstall: si está activado, al eliminar el plugin se borran los ajustes de PostNord y los métodos de zona. Desactivarlo nunca borra los ajustes. Los puntos de servicio guardados en los pedidos siempre se conservan.

Cómo funciona en la finalización de compra

Cuando el cliente introduce una dirección de entrega, WooCommerce pide al plugin una tarifa. El plugin comprueba las condiciones: peso del carrito, subtotal mínimo y clases de envío desactivadas. El precio sale de la tabla de países y, después, del coste alternativo. Si no hay precio, el método se oculta. Si se aplica el envío gratis, el cliente ve el método sin coste.

En el caso de un método 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 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 de la finalización de compra.

Para otros destinos, el método puede seguir ofreciéndose con tus precios, sin selector.

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 no solicita precios de PostNord en tiempo real 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. Usa PostNord Portal, Skicka Direkt Business o un plugin de etiquetas para los envíos; el ID del punto de servicio guardado es lo que necesitan esas herramientas.

Puntos de recogida

Cuando el cliente selecciona un método de punto de servicio, debajo aparece 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 el mensaje "Enter your postcode to choose a PostNord service point.". La elección se mantiene durante las actualizaciones de la finalización de compra.

Cuando se carga la lista, hay que elegir un punto. Si no, la finalización de compra se detiene con "Please select a PostNord service point.". El punto elegido se comprueba en el servidor contra la lista, tanto en la finalización de compra clásica como en la de bloques.

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 administrador: PostNord service point con el nombre, la dirección y el Service point ID, debajo de la dirección de envío. Si no se eligió ningún punto, aparece "not selected — PostNord delivers to the service point nearest to the shipping address".

Página de agradecimiento y vista de pedido de Mi cuenta: PostNord service point: con el nombre y la dirección.

Correos de pedido: el nombre, la dirección y el ID del punto en los correos HTML y de texto plano.

En la base de datos, el punto se guarda en los metadatos del pedido _vfd_ptnd_servicepoint_id, _vfd_ptnd_servicepoint_name y _vfd_ptnd_servicepoint_address.

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 PostNord. 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 eliminarla de este sitio. El enlace Manage licenses and domains in your account abre tu cuenta de vibefox.net.

Una clave funciona en un dominio. Eliminar la clave de un sitio no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.

Sin una clave activa, PostNord no se muestra a los clientes en la finalización de compra. Los gestores de la tienda que han iniciado sesión siguen viéndolo, 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 requieren renovarla. El estado se vuelve a comprobar automáticamente en segundo plano.

Solución de problemas

PostNord 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). Comprueba que hay un precio para el país (fila del país, fila * o Fallback cost), los límites de peso, Minimum subtotal y Disabled shipping classes.

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 con el entorno de prueba, y viceversa. Activa Debug log y revisa WooCommerce > Status > Logs, origen "vfd-postnord". El pedido se puede hacer igualmente; PostNord entonces entrega en el punto de servicio más cercano.

Puntos de servicio inesperados: revisa Agreement country. Determina qué puntos de servicio se ofrecen.

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

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 ajustes y solo borra las listas de puntos de servicio guardadas en caché. 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, junto con las listas de puntos de servicio en caché. Los ajustes y los métodos de zona 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 y el punto de servicio guardado.

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