VibeFox DHL Africa for WooCommerce — Ayuda
Requisitos
WordPress: 5.8 o posterior.
WooCommerce: 5.0 o posterior, instalado y activo. El plugin no se activa sin él.
PHP: 8.0 o posterior.
Cuenta de DHL Express (solo para tarifas en tiempo real): las tarifas en tiempo real usan la API MyDHL. Necesitas tu número de cuenta de DHL Express y las credenciales de la API MyDHL: una clave API y un secreto API. Solicítalas en el Portal para desarrolladores de DHL (MyDHL API, "Get access") o a tu gestor de cuenta de DHL Express. Las cuentas que todavía tienen credenciales de DHL XML Services (Site ID y contraseña) pueden usarlas en su lugar. Si solo usas precios alternativos, no necesitas credenciales de DHL.
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_dhl_africa a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre la configuración: WooCommerce > Settings > Shipping > DHL Express Africa, 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 la API de DHL, introduce la clave API, el secreto API y tu número de cuenta de DHL. Mantén Test mode activado mientras uses credenciales de prueba. Introduce la dirección Ship from. Si tu cuenta de DHL no se factura en la moneda de tu tienda, configura DHL quote currency y Exchange rate. Opcionalmente, configura precios por país y un coste alternativo (consulta Configuración).
6. Añade DHL Express Africa a tus zonas de envío en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore shipping zones y elige los países.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > DHL Express Africa. Se aplican a todas las zonas de envío. Cuando añades el método a una zona, la ventana de la zona tiene solo un campo:
Title (zone): el nombre de esta opción en la compra para esta zona. Déjalo vacío para usar el Name global.
Las advertencias encima de los ajustes te indican cuándo las tarifas en tiempo real están desactivadas por faltar credenciales u origen, y cuándo hay una moneda de cotización sin tipo de cambio. Cada vez que guardas los ajustes, se borran las cotizaciones de DHL en caché. Los precios y los pesos admiten coma o punto decimal.
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 compra. Por defecto: DHL Express.
Tax status: Taxable (con los impuestos de WooCommerce activados) toma la tarifa de DHL sin el impuesto que cotiza DHL, y WooCommerce añade su propio impuesto. None cobra la tarifa de DHL tal como se cotiza, con el impuesto incluido.
Cuenta de DHL Express (necesaria solo para tarifas en tiempo real)
DHL API: la interfaz de DHL que se usa. Solo se muestran los campos de la API elegida.
API key: tu nombre de usuario de MyDHL API (clave API).
API secret: tu contraseña de MyDHL API (secreto API).
XML Site ID: tu Site ID de DHL XML Services (solo para la API heredada).
XML password: tu contraseña de DHL XML Services (solo para la API heredada).
DHL account number: tu número de cuenta de DHL Express (9 dígitos). La API MyDHL lo requiere. Con XML Services devuelve las tarifas de tu cuenta en lugar de las tarifas publicadas.
Test mode: usa el entorno de pruebas de DHL. Activado por defecto. Las credenciales de prueba solo funcionan en el entorno de pruebas, y las de producción solo en producción. Desactívalo cuando pases a producción.
Dirección de origen
La dirección desde la que DHL recoge los paquetes. La tarifa depende de ella.
Origin country: el país desde el que envías.
Origin city: la ciudad desde la que envías, por ejemplo Johannesburgo. La API MyDHL la requiere.
Origin postcode: déjalo vacío en los países sin códigos postales (por ejemplo Kenia, Nigeria, Ghana).
Tarifas
Todos los precios están en la moneda de tu tienda. La tarifa en tiempo real es el producto DHL Express más económico para el paquete. Si DHL no está configurado, falla o no tiene servicio para la ruta, se usa el precio del país y, después, el coste alternativo. Si no hay ninguno de los dos, el método se oculta.
DHL quote currency: DHL cotiza en la moneda del país de tu cuenta de DHL (por ejemplo ZAR, NGN o KES). Si DHL no devuelve un importe en la moneda de tu tienda, la tarifa en tiempo real se convierte desde esta moneda con el tipo de cambio de abajo. Si no, no se usa.
Exchange rate: cuánto vale 1 unidad de la moneda de cotización de DHL en la moneda de tu tienda, por ejemplo 1 ZAR = 0.05. Déjalo vacío para no convertir. El tipo de cambio es un ajuste manual.
Fallback cost: un coste fijo cuando no hay tarifa en tiempo real ni precio por país. Déjalo vacío para ocultar el método.
Country prices: un precio alternativo por país de destino, uno por línea: CC:Precio, por ejemplo ZA:25.00. Se usa cuando no hay tarifa en tiempo real.
Fallback price basis: Per order cobra el precio una vez. Per item (multiplied by the cart quantity) lo multiplica por el número de artículos. Se aplica solo al precio por país y al coste alternativo. La tarifa en tiempo real de DHL siempre es para el paquete completo.
Free shipping from: el subtotal del carrito a partir del cual este método es gratuito. No se consulta a DHL. Déjalo vacío para que nunca sea gratuito.
Condiciones
Minimum weight (kg): oculta el método por debajo de este peso del carrito. 0 significa sin límite.
Maximum weight (kg): oculta el método por encima de este peso del carrito. Por defecto: 70. 0 significa sin límite.
Minimum subtotal: muestra el método solo si el subtotal del carrito es al menos este importe. Déjalo vacío para mostrarlo siempre.
Excluded shipping classes: oculta el método si el carrito contiene un producto de una de estas clases de envío de WooCommerce.
Disponibilidad sin zonas de envío
Ignore shipping zones: ofrece el método para los países indicados abajo, aunque la zona de envío correspondiente no lo incluya.
Countries: los países de destino para ese modo. Déjalo vacío para usar todos los países a los que envías. Se usa solo con Ignore shipping zones.
Avanzado
Debug log: registra los cálculos de tarifas en WooCommerce > Status > Logs, origen vfd-dhl-africa. Los errores de DHL se registran siempre, incluso con esta opción desactivada. Las credenciales y las direcciones de los clientes nunca se registran.
Remove data on uninstall: si está activado, al eliminar el plugin se borran sus ajustes y sus métodos de zona. Desactivar el plugin nunca borra datos.
Cómo funciona al finalizar la compra
Cuando el cliente introduce una dirección de entrega, WooCommerce pide al plugin una tarifa. Primero el plugin comprueba el peso del carrito, el subtotal mínimo y las clases de envío excluidas. Si se aplica el envío gratuito, el cliente obtiene la entrega gratuita y no se envía ninguna solicitud a DHL.
Si no, el plugin envía a DHL el origen y el destino (país, ciudad, código postal), el peso del carrito convertido a kg (mínimo 0.5 kg) y una caja creada a partir de las dimensiones de los productos en cm: la longitud mayor, la anchura mayor y las alturas apiladas. Los productos sin dimensiones no suman nada. Si ningún producto tiene dimensiones, se usa una caja de 10 x 10 x 10 cm. Los envíos internacionales se declaran como mercancía, con el subtotal del carrito como valor declarado, para que DHL cotice productos de paquete. Los envíos nacionales no se declaran. La tarifa en tiempo real se solicita solo después de que el cliente haya introducido una ciudad (con XML Services, una ciudad o un código postal).
El producto DHL Express más económico se muestra como una sola tarifa con tu título. El cliente no ve el producto de DHL ni un plazo de entrega. El nombre del producto (por ejemplo "EXPRESS WORLDWIDE (P)") se guarda como DHL product en la línea de envío del pedido, para que sepas qué reservar.
Cada cotización se guarda en caché durante 1 hora por paquete y ruta. Una solicitud fallida se guarda en caché durante 10 minutos, para que la compra no espere a DHL en cada actualización. El tiempo de espera de la API es de 12 segundos. Si DHL devuelve un error o no tiene servicio, el cliente no ve ningún error: se usa el precio alternativo o el método se oculta.
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 solo calcula tarifas. No crea envíos de DHL, no imprime etiquetas ni facturas comerciales, no reserva recogidas, no rastrea paquetes, no ofrece puntos de servicio de DHL, no permite al cliente elegir entre productos de DHL, no empaqueta varias cajas, no añade seguro y no cotiza aranceles ni impuestos. La cotización es solo por el envío. Los aranceles e impuestos de importación los paga el destinatario.
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 Express Africa. 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 comprobar el estado de nuevo, 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. Libérala en tu cuenta de vibefox.net.
Sin una clave activa, DHL Express no se muestra a los clientes en la compra. Los gestores de la tienda que hayan iniciado sesión 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
DHL Express no aparece en la 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 los límites de peso, Minimum subtotal y Excluded shipping classes. Sin tarifa en tiempo real, el método aparece solo si hay un precio por país o un coste alternativo.
Las tarifas en tiempo real no aparecen: revisa las advertencias de la parte superior de la página de ajustes (faltan credenciales u origen). Activa Debug log y abre WooCommerce > Status > Logs, origen vfd-dhl-africa. Los errores de DHL, como credenciales incorrectas, falta de servicio para la ruta o un problema de moneda, siempre quedan registrados. Comprueba que Test mode coincida con tus credenciales.
DHL devuelve la tarifa en ZAR, NGN o KES, pero mi tienda usa otra moneda: configura DHL quote currency con esa moneda e introduce el Exchange rate. Sin ello, la tarifa en tiempo real no se usa y se aplican los precios alternativos.
Tengo credenciales antiguas de DHL XML Services: elige XML Services (legacy) en DHL API. Cambia a la API MyDHL cuando recibas credenciales de MyDHL.
El impuesto se cobra dos veces en el envío: pon Tax status en Taxable para que la tarifa de DHL se tome sin el IVA de DHL, o en None para cobrar el importe de DHL tal como se cotiza.
Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Así se borran las cotizaciones de DHL en caché.
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 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 conserva todos los ajustes. Solo borra las cotizaciones de DHL en caché. 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 las cotizaciones 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 nunca se modifican, y los pedidos existentes conservan sus líneas de envío.
DHL es una marca comercial de su respectivo propietario. Este plugin no está afiliado a DHL ni cuenta con su respaldo.