VibeFox DPD Pickup 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.
Credenciales de DPD Baltic (Lituania, Letonia, Estonia): la lista de puntos de recogida procede del servicio web de DPD Baltic. Necesitas el nombre de usuario y la contraseña de la API que DPD facilita a sus clientes empresariales. Pídelos a tu gestor de cuenta de DPD o al servicio de atención al cliente de DPD de tu país. Una sola cuenta muestra los puntos de recogida de Lituania, Letonia y Estonia.
DPD Eslovaquia: la búsqueda pública de parcelshops de DPD Eslovaquia no necesita credenciales.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un solo 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_dpd_pickup a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox DPD Pickup, 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 tu API de DPD. Para DPD Lituania, Letonia o Estonia, introduce el nombre de usuario y la contraseña de la API. Introduce los precios por país y guarda los cambios. Haz clic en Refresh pickup points para comprobar la conexión (véase Configuración).
6. Añade VibeFox DPD Pickup a tus zonas de envío en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore shipping zones.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox DPD Pickup. Se aplican a todas las zonas de envío. Cuando añades el método a una zona, la ventana de la zona solo tiene un campo:
Title (zone): el nombre de esta opción en la finalización de compra para esta zona. Déjalo vacío para usar el Name general.
Las advertencias que aparecen encima de los ajustes te avisan cuando el nombre de usuario o la contraseña de DPD Baltic están vacíos y cuando no hay precios configurados. Cada vez que guardas los ajustes, se borra la caché de puntos de recogida.
General
Enable/Disable: activa o desactiva el método en todas las zonas a la vez.
Name: el nombre del método de envío que se muestra en la finalización de compra. Por defecto: DPD Pickup Point.
Tax status: Taxable añade el impuesto de WooCommerce al coste del envío, None no lo añade.
Lista de puntos de recogida de DPD
Los puntos de recogida se cargan desde DPD y se guardan en caché durante 24 horas.
DPD API: la empresa DPD con la que tienes la cuenta. Las cuentas Baltic usan el servicio web de su propio país.
API username (Baltic): tu nombre de usuario del servicio web de DPD Baltic. No es necesario para DPD Eslovaquia.
API password (Baltic): tu contraseña del servicio web de DPD Baltic. No es necesaria para DPD Eslovaquia.
Pickup points: el botón Refresh pickup points borra la caché y carga ahora los puntos de recogida de DPD: Lituania, Letonia y Estonia con la API Baltic, o una búsqueda de prueba en Bratislava para DPD Eslovaquia. Muestra el resultado por país. Guarda antes los ajustes.
Precios
Los precios de envío son fijos por país, en la moneda de la tienda. La API no solicita precios a DPD.
Country prices: una línea por país: CC:price, por ejemplo EE:3.50. Se admite la coma decimal. Por defecto: SK:3.50, LT:4.00, LV:4.00, EE:4.00.
Fallback cost: el precio para los países que no están en Country prices. Por defecto: 5.00. Déjalo vacío para ofrecer el método solo en los países de la lista.
Calculation type: Per order cobra el precio una sola vez. Per item (price x quantity) lo multiplica por el número de artículos del carrito.
Free shipping from: el envío es gratuito cuando el subtotal del pedido (después de los cupones) alcanza esta cantidad. Déjalo vacío para desactivarlo.
Disponibilidad
El método también se oculta cuando DPD no devuelve puntos de recogida para la dirección del cliente o cuando no se puede conectar con la API de DPD, porque un pedido no puede entregarse sin punto de recogida.
Min weight (kg): el peso mínimo del carrito. Los pesos de los productos se convierten desde la unidad de peso de tu tienda. Vacío o 0 significa sin límite.
Max weight (kg): los carritos más pesados no ven el método. Por defecto: 31.5. 0 significa sin límite. Consulta los límites de peso de paquete de los puntos de recogida y taquillas de DPD Pickup de tu país.
Minimum subtotal: muestra el método solo cuando el subtotal del pedido es al menos este importe. Déjalo vacío para mostrarlo siempre.
Excluded shipping classes: el método se oculta cuando el carrito contiene un producto de una de estas clases de envío de WooCommerce.
Ignore shipping zones: ofrece el método para los países indicados abajo, aunque la zona de envío del cliente no lo incluya. Desactivado significa que añades el método a las zonas de envío de la forma habitual.
Countries: los países de destino para ese modo. Déjalo vacío para todos los países. Solo se usa con Ignore shipping zones.
Selector de punto de recogida
City order: muestra primero las ciudades principales (Tallin, Riga, Vilna, Bratislava y otras). Activado por defecto.
City list width: el ancho CSS de la lista de ciudades, por ejemplo 100% o 300px. Por defecto: 100%.
Pickup point list width: el ancho CSS de la lista de puntos de recogida, por ejemplo 100% o 400px. Por defecto: 100%.
Avanzado
Debug log: registra las solicitudes a la API y los pasos de la finalización de compra en WooCommerce > Status > Logs, fuente vfd-dpd-pickup. Los errores de la API siempre se registran, aunque esta opción esté desactivada. Las credenciales nunca se registran.
Remove data on uninstall: si está activado, al eliminar el plugin se borran sus ajustes y los métodos de zona. Desactivar el plugin nunca borra los ajustes. El punto de recogida guardado en los pedidos siempre se conserva.
Funcionamiento en la finalización de compra
Cuando el cliente introduce una dirección de envío, WooCommerce pide al plugin un precio. El plugin comprueba el peso del carrito, el subtotal mínimo y las clases de envío excluidas, toma el precio del país (o el coste alternativo) y aplica el envío gratuito si el subtotal es suficientemente alto. Después carga los puntos de recogida de DPD para la dirección. Si DPD no devuelve ninguno, no se puede conectar con él o faltan las credenciales de Baltic, el método se oculta.
Una lista de puntos de recogida se guarda en caché durante 24 horas. Una solicitud fallida se recuerda durante 5 minutos, así que una caída de DPD nunca ralentiza la finalización de compra. El tiempo de espera de la API es de 15 segundos.
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 a DPD, no crea envíos de DPD, no imprime etiquetas, no crea manifiestos, no pide recogidas de mensajero, no hace seguimiento de paquetes ni muestra un mapa. Solo se admiten el servicio web de DPD Baltic y la búsqueda de parcelshops de DPD Eslovaquia.
Puntos de recogida
Cuando el cliente selecciona DPD Pickup, aparecen debajo del método una lista de ciudades y una lista de puntos de recogida. La ciudad de la dirección del cliente aparece preseleccionada. Con DPD Eslovaquia, el cliente introduce primero la ciudad y el código postal, y después ve los puntos cercanos. Es obligatorio elegir un punto de recogida. El servidor comprueba que el punto pertenece al país y a la dirección del cliente, así que una elección falsificada o desactualizada se rechaza.
El punto elegido se guarda en el pedido. Se muestra en la pantalla del pedido, debajo de la dirección de envío, en la página de agradecimiento, en My account > Orders y en los correos electrónicos del pedido (HTML y texto sin formato) como DPD pickup point. El nombre guardado en el pedido procede de DPD, no del navegador.
En la pantalla del pedido, haz clic en Edit junto al punto de recogida, elige una ciudad y otro punto. El punto se comprueba con la lista de DPD para la dirección del pedido. El pedido necesita una ciudad y un código postal de envío para poder cambiar el punto.
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 DPD Pickup. 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 solo dominio. Eliminar la clave de un sitio no libera su plaza de dominio. Libérala en tu cuenta de vibefox.net.
Sin una clave activa, DPD Pickup no se muestra a los clientes en la finalización de compra. Los gestores de la tienda con sesión iniciada sí lo ven, marcado 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
DPD Pickup 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 las advertencias de la parte superior de la página de ajustes y haz clic en Refresh pickup points. Revisa los límites de peso y de subtotal, las clases de envío excluidas y que el país tenga un precio (o un coste alternativo).
"Login failed" después de Refresh pickup points: DPD ha rechazado las credenciales de Baltic, así que no se puede cargar ningún punto de recogida. Comprueba el nombre de usuario y la contraseña de la API con DPD.
DPD Eslovaquia no muestra puntos: los puntos aparecen cuando el cliente ha introducido la ciudad y el código postal. DPD solo muestra los puntos a menos de 50 km de esa dirección.
Averiguar la causa: activa el Debug log. Cada decisión se escribe en WooCommerce > Status > Logs, fuente vfd-dpd-pickup. Los errores de la API siempre se registran. Los nombres de usuario y las contraseñas de la API nunca se escriben en el registro.
El bloque de licencia muestra un error: sigue el mensaje del bloque. Por ejemplo, si la clave ya está usada 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 conectar con el servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Desactivar el plugin conserva todos los ajustes. Solo borra la caché de puntos de recogida. Para eliminar el plugin, 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, al igual que la caché de puntos de recogida. Los ajustes y los métodos de zona solo se eliminan si Remove data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. El punto de recogida guardado en los pedidos nunca se borra, y los pedidos existentes conservan sus líneas de envío.
DPD es una marca comercial de su respectivo propietario. Este plugin no está afiliado a DPD ni cuenta con su aprobación.