VibeFox DHL Packstation 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.
DHL API key: la lista de ubicaciones procede de la API gratuita DHL Location Finder. Regístrate en el portal para desarrolladores de DHL (developer.dhl.com), crea una aplicación, añade la API "Location Finder - Unified" y copia la clave de API de la aplicación. Para esta API no hace falta un contrato comercial con DHL. Sin la clave, el método no aparece en la finalización de compra. Ten en cuenta el límite de solicitudes de tu aplicación de DHL: cada búsqueda de un código postal o una ciudad nueva es una solicitud a la API.
VibeFox license key: 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_dhl_packstation a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Shipping > DHL Packstation, 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 clave de API de DHL, guarda, haz clic en Test API key, elige los tipos de ubicación e introduce los precios por país (consulta Configuración).
6. Añade DHL Packstation a una zona de envío (por ejemplo Alemania) 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 > DHL Packstation. Se aplican a todas las zonas de envío. Cuando añades el método a una zona, la ventana de la zona tiene un único campo:
Title (zone): el nombre de esta opción de envío en la finalización de compra para esta zona. Déjalo vacío para usar el Name global.
Los avisos sobre los ajustes te indican cuándo la clave de API de DHL está vacía y cuándo las entradas de precios por país no tienen el formato correcto. Cada vez que guardas los ajustes, se borra la caché de ubicaciones.
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 ve el cliente. Por defecto: DHL Packstation. Una zona puede sustituirlo con su propio Title.
Tax status: Taxable añade el impuesto de WooCommerce al coste del envío; None no lo añade.
DHL Location Finder API
DHL API key: la clave de API de tu aplicación en developer.dhl.com. Sin ella, el método no aparece en la finalización de compra.
Connection test: el botón Test API key busca las ubicaciones cercanas a 53113 Bonn con la clave guardada y borra la caché de ubicaciones. Guarda antes los ajustes. Muestra cuántas ubicaciones se han encontrado o que DHL ha rechazado la clave (401/403).
Puntos de recogida
Location types: las ubicaciones de DHL que el cliente puede elegir: Packstation (parcel locker), Post Office (Postfiliale) y DHL Parcel Shop (Paketshop). Por defecto, las tres. Si no se selecciona ninguna, el método se oculta. En el caso de un Packstation, el cliente debe introducir su DHL Postnummer.
Search radius (meters): el radio alrededor del código postal o la ciudad buscados. Por defecto: 5000. DHL permite hasta 25000 m.
Max results: el número máximo de ubicaciones que se muestran por búsqueda. Por defecto: 20. DHL permite hasta 50.
Shipping address: usa la ubicación elegida como dirección de envío del pedido. Activado por defecto. La línea de dirección 1 pasa a ser, por ejemplo, "Packstation 105"; la línea 2, "Postnummer" con el número, además del código postal y la ciudad de la ubicación, para que las etiquetas impresas desde el pedido lleguen al lugar correcto. El Postnummer también se guarda como _shipping_dhl_postnum, el campo que lee el plugin oficial "DHL Shipping Germany for WooCommerce".
Precios
Country prices: el precio por país de destino en la moneda de la tienda, con el formato CC:PRECIO, separado por comas o saltos de línea. Por defecto: DE:4.99, AT:5.99. También funciona la coma decimal (DE:4,99).
Other countries: el precio para un país de destino que no está en Country prices. Por defecto: 5.99. Déjalo vacío para ocultar el método en esos países.
Calculation: 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 subtotal del carrito a partir del cual este envío es gratuito. Déjalo vacío si nunca es gratuito.
Disponibilidad
Min weight (kg): el peso mínimo del carrito. Los pesos de los productos se convierten desde la unidad de tu tienda. 0 significa sin límite.
Max weight (kg): el método se oculta por encima de este peso del carrito. Por defecto: 31.5, porque un Packstation admite paquetes de hasta 31,5 kg. 0 significa sin límite.
Minimum subtotal: muestra el método solo si el subtotal del carrito es de al menos este valor. Déjalo vacío para mostrarlo siempre.
Excluded shipping classes: el método se oculta si 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 correspondiente no lo incluya.
Countries (ignore zones): los países de destino para ese modo. Déjalo vacío para todos los países. Solo se usa con Ignore shipping zones.
Avanzado
Debug log: registra las solicitudes a la API y los pasos de la finalización de compra en WooCommerce > Status > Logs, origen vfd-dhl-packstation. Los errores de la API siempre se registran, aunque esta opción esté desactivada. La clave de API, el Postnummer y las direcciones de los clientes nunca se registran.
Remove data on uninstall: si está activada, al eliminar el plugin se borran sus ajustes y sus métodos de zona. Desactivarlo nunca borra nada. Las ubicaciones elegidas se mantienen en los pedidos.
Cómo funciona 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 de destino (o el precio de otros países) y aplica el envío gratuito si el subtotal es lo bastante alto.
El método funciona en la finalización de compra clásica y en los bloques de Carrito y Finalizar compra. Es compatible con WooCommerce High-Performance Order Storage (HPOS).
El plugin no crea envíos de DHL, no imprime etiquetas ni hace seguimiento de paquetes. Usa el portal de clientes comerciales de DHL o un plugin de etiquetas: el pedido ya contiene la dirección del Packstation y el Postnummer en el formato que esperan. El plugin no calcula tarifas de DHL en tiempo real y no muestra mapa. Si no se puede acceder a la API de DHL, el cliente ve un mensaje y no puede usar este método hasta que vuelva a funcionar. No es posible introducir a mano un número de Packstation.
Puntos de recogida
Cuando el cliente selecciona DHL Packstation, aparece un selector debajo de la opción de envío. Se cargan las ubicaciones de DHL cercanas al código postal o la ciudad de envío. El cliente puede buscar otro código postal o ciudad. Las ubicaciones se agrupan por tipo (Packstation, Post Office, Parcel Shop) y se ordenan por distancia.
En el caso de un Packstation, el cliente debe introducir el DHL Postnummer, su número de cliente de DHL de 6 a 12 dígitos, que aparece en la app o en la cuenta de DHL. En las demás ubicaciones es opcional. El pedido no se puede realizar sin una ubicación ni con un Postnummer no válido. Esto se comprueba en el servidor, también en la finalización de compra con bloques.
Los resultados de búsqueda se guardan en caché durante 12 horas. Una búsqueda fallida se guarda en caché durante 10 minutos, para que la finalización de compra no espere a DHL en cada actualización. El tiempo de espera de la API es de 12 segundos.
La ubicación (ID, tipo, número, nombre, dirección) y el Postnummer se guardan en el pedido. Se muestran 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 del pedido (HTML y texto sin formato) como DHL pickup location y DHL Postnummer.
En la pantalla del pedido, haz clic en Edit junto a la ubicación, busca por código postal o ciudad, elige otra ubicación, cambia el Postnummer y haz clic en Save location. Cada cambio añade una nota al pedido. Si Shipping address está activado, también se actualiza la dirección de envío. Recarga la página para verla.
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 > DHL Packstation. 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, DHL Packstation 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 recordatorio en la página de 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 necesitan una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
DHL Packstation 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 la DHL API key está rellenada, que al menos un tipo de ubicación está seleccionado, que el país de destino tiene un precio (o que Other countries está definido) y que las reglas de peso, subtotal y clase de envío no lo ocultan.
No se muestran ubicaciones: haz clic en Test API key. Si DHL rechaza la clave (401/403), revisa la clave y que tu aplicación tenga la API "Location Finder - Unified". Activa Debug log y abre WooCommerce > Status > Logs, origen vfd-dhl-packstation. Comprueba que no has alcanzado el límite de solicitudes de tu aplicación de DHL.
No hay ubicaciones cerca de una dirección: aumenta el Search radius (meters) o el Max results, o deja que el cliente busque otro código postal o ciudad.
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 la dirección del sitio ha cambiado, haz clic en Check now para activar la clave para el nuevo dominio. Si no se puede acceder al servidor de licencias, el plugin sigue funcionando con el último estado conocido.
Desinstalación
Desactivar el plugin mantiene todos los ajustes. Solo borra la caché de ubicaciones. 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 ubicaciones. 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. Las ubicaciones elegidas se mantienen en los pedidos, y los pedidos existentes conservan sus líneas de envío.
DHL y Packstation son marcas comerciales de sus respectivos propietarios. Este plugin no está afiliado a DHL ni cuenta con su aprobación.