VibeFox Delhivery 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.
Token de API de Delhivery (solo para tarifas en tiempo real): inicia sesión en Delhivery One y abre Settings > API setup. El artículo de ayuda de Delhivery «API token generation» explica los pasos. Los tokens de prueba funcionan con el entorno de staging. También necesitas el código PIN de 6 dígitos de tu punto de recogida. Si solo usas precios fijos, no necesitas token.
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_delhivery a /wp-content/plugins/ por FTP.
2. Haz clic en Activate.
3. Abre los ajustes: WooCommerce > Settings > Shipping > VibeFox Delhivery, 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. Introduce el token de API y tu código PIN de origen, elige Express o Surface y Pre-paid o COD. Si la moneda de tu tienda no es INR, introduce el tipo de cambio. Opcionalmente, introduce precios fijos (consulta «Configuración»).
6. Añade VibeFox Delhivery a una zona de envío (por ejemplo, India) en WooCommerce > Settings > Shipping > Shipping zones, o activa Ignore zones y elige los países.
Configuración
Todos los ajustes están en una sola página: WooCommerce > Settings > Shipping > VibeFox Delhivery. 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 que ven los clientes en esta zona. Déjalo vacío para usar el Method title global.
Cada vez que guardas los ajustes, se borran las tarifas de Delhivery en caché. Los precios y los importes aceptan «9.99» y «9,99».
General
Enable/Disable: activa o desactiva el método en todas las zonas a la vez.
Method title: el nombre del método de envío que se muestra en la finalización de compra. Por defecto: Delhivery. Una zona puede sustituirlo por su propio Title.
Tax status: Taxable añade el impuesto de WooCommerce sobre el coste del envío; None no lo añade.
Cuenta de API de Delhivery (solo necesaria para tarifas en tiempo real)
Environment: Production (track.delhivery.com) (por defecto) o Staging / test account (staging-express.delhivery.com). Usa Staging solo con un token de prueba de Delhivery.
API token: tu token de API de Delhivery. Solo se envía en la cabecera de autorización y nunca se escribe en los logs.
Origin pincode: el código PIN de 6 dígitos de tu punto de recogida o almacén, por ejemplo 110001.
Tarifas en tiempo real
Se solicita una tarifa en tiempo real para destinos de la India con un código PIN de 6 dígitos válido, para envíos directos (entregados).
Shipping mode: el modo de facturación de Delhivery que se usa para la tarifa: Express (por defecto) o Surface.
Payment type: el tipo de pago que se envía a Delhivery: Pre-paid (por defecto) o COD (pago contra reembolso; Delhivery añade su cargo COD). El plugin no lo cambia según el método de pago que elija el cliente.
Rate amount: Delhivery devuelve el cargo con y sin GST.
INR to (store currency) conversion rate: las tarifas de Delhivery están en rupias indias. Si la moneda de tu tienda no es INR, introduce cuántas unidades de tu moneda vale una rupia, por ejemplo 0.011. Si lo dejas vacío, no se usarán las tarifas en tiempo real, se aplicarán los precios fijos y se mostrará un aviso encima de los ajustes. No es necesario si la moneda de tu tienda es INR.
Precios fijos (se usan cuando no hay una tarifa en tiempo real)
Los precios fijos se usan cuando todavía no hay token ni código PIN, cuando el destino está fuera de la India, cuando el código PIN no tiene servicio de envío o cuando la API devuelve un error. Están en la moneda de tu tienda.
Prices per country: uno por línea, con el formato COUNTRY_CODE:price, por ejemplo IN:120. Se comprueba antes que el precio de reserva.
Fallback price: se usa cuando no se aplica ni una tarifa en tiempo real ni un precio por país. Déjalo vacío para ocultar el método. 0 significa gratis.
Fixed price is charged: Per order cobra el precio una sola vez. Per item (price × quantity) lo multiplica por el número de artículos del carrito. Una tarifa en tiempo real de Delhivery siempre corresponde al peso total del paquete.
Condiciones
Free shipping from: el envío es gratis si el subtotal del carrito es al menos este importe. No se envía ninguna solicitud a Delhivery. Déjalo vacío para desactivarlo.
Show from subtotal: muestra el método solo si el subtotal del carrito es al menos este importe. Déjalo vacío para mostrarlo siempre.
Min weight (kg): el peso mínimo del carrito para mostrar el método. 0 significa sin límite.
Max weight (kg): oculta el método si el carrito pesa más. Por defecto: 30. 0 significa sin límite.
Los pesos de los productos se convierten a kg desde la unidad de peso de tu tienda. La tarifa usa el peso real del carrito (la suma de los pesos de los productos), sin peso volumétrico ni cajas.
Excluded shipping classes: oculta el método si algún artículo del carrito pertenece a una de estas clases de envío de WooCommerce.
Disponibilidad sin zonas de envío
Ignore zones: ofrece Delhivery sin añadirlo a una zona de envío, para los países indicados abajo.
Countries: los países de destino para ese modo. Déjalo vacío para usar todos los países a los que envías. Solo se usa cuando Ignore zones está activado.
Avanzado
Debug log: registra los cálculos de tarifas en WooCommerce > Status > Logs, origen vfd_delhivery. Los errores de la API siempre se registran, aunque esta opción esté desactivada. Los tokens y los códigos PIN completos de los clientes nunca se registran.
Remove data on uninstall: si está activado, al eliminar el plugin se borran todos sus ajustes, métodos de zona y tarifas en caché. Desactivar el plugin nunca borra nada.
Cómo funciona en la finalización de compra
Cuando el cliente introduce una dirección de envío, WooCommerce pide una tarifa al plugin. El plugin comprueba primero el peso del carrito, el subtotal y las clases de envío excluidas. Si se aplica el envío gratis, el cliente recibe el envío sin coste y no se envía ninguna solicitud a Delhivery.
Para una dirección de la India con un código PIN de 6 dígitos válido, el plugin envía a Delhivery los códigos PIN de origen y de destino, el peso del carrito en gramos, el modo de envío y el tipo de pago, y muestra el importe devuelto convertido a la moneda de tu tienda. Cada respuesta se guarda en caché durante 1 hora. Una solicitud fallida se guarda en caché durante 10 minutos, para que la finalización de compra no espere a Delhivery en cada actualización. El tiempo de espera de la API es de 10 segundos.
Si no hay tarifa en tiempo real, se usa el precio del país o el precio de reserva. Si no hay ninguno, el método se oculta. El cliente nunca ve un error de la API.
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 calcula las tarifas y muestra un enlace de seguimiento. No crea envíos ni guías, no imprime etiquetas, no solicita recogidas ni manifiestos, no comprueba la cobertura de los códigos PIN, no estima fechas de entrega, no sincroniza los estados de seguimiento y no cotiza tarifas internacionales de Delhivery. Fuera de la India solo se usan los precios fijos.
Pedidos y seguimiento
En la pantalla del pedido, debajo de la dirección de envío, el bloque Delhivery muestra el modo de envío (Express o Surface) y el origen del precio: tarifa en tiempo real de Delhivery, precio fijo o umbral de envío gratis.
Crea el envío en Delhivery One, pega después su AWB en el campo Delhivery AWB / tracking number y guarda el pedido. Aparece un enlace Track on delhivery.com en el panel de administración. El cliente ve Delhivery tracking con un enlace en la página del pedido en Mi cuenta y en los correos electrónicos del pedido (HTML y texto plano). El AWB se guarda antes que el estado del pedido, así que el correo «Pedido completado» ya incluye el AWB si completas el pedido en el mismo guardado.
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 Delhivery. 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. Libérala en tu cuenta de vibefox.net.
Sin una clave activa, Delhivery no se muestra a los clientes en la finalización de 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 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 una renovación. El estado se vuelve a comprobar automáticamente en segundo plano.
Solución de problemas
Delhivery 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 zones esté activado y el país permitido). Revisa los límites de peso, Show from subtotal y Excluded shipping classes. Sin tarifa en tiempo real, hace falta un precio por país o un Fallback price.
Las tarifas en tiempo real no aparecen: comprueba el token de API, un Origin pincode válido y, en una tienda que no use INR, el tipo de cambio. El cliente debe introducir un código PIN indio válido de 6 dígitos. Activa Debug log y abre WooCommerce > Status > Logs, origen vfd_delhivery, para ver los errores de la API, por ejemplo un código PIN sin cobertura.
Se cobra el GST dos veces: el importe total de Delhivery ya incluye el GST. Cambia Rate amount a Gross amount (excluding GST) o Tax status a None.
Pruebas: usa Environment Staging con un token de prueba de Delhivery.
Las tarifas parecen desactualizadas tras un cambio: guarda la página de ajustes. Esto borra las tarifas de Delhivery 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 en 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 datos. 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. Los ajustes, los métodos de zona y las tarifas en caché se eliminan solo si Remove data on uninstall estaba activado. Si no, se conservan para una reinstalación posterior. Los números AWB se quedan en los pedidos, y los pedidos existentes conservan sus líneas de envío.
Delhivery es una marca comercial de su respectivo titular. Este plugin no está afiliado a Delhivery ni cuenta con su aprobación.