VibeFox Delhivery for PrestaShop — Ayuda
Requisitos
PrestaShop: 8.0 a 9.x.
PHP: 8.0 o posterior. El módulo no se instala en versiones anteriores de PHP.
Token de API de Delhivery (solo para las 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. Ambos enlaces están en la página del módulo. 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 un token.
Clave de licencia de VibeFox: se compra en vibefox.net. Una clave funciona en un dominio.
Instalación
1. En el back office ve a Modules > Module Manager y haz clic en Upload a module. Elige el archivo ZIP del módulo.
2. Cuando termine la subida, haz clic en Configure, o busca VibeFox Delhivery más tarde en la lista de módulos y haz clic en Configure.
3. Introduce tu clave de licencia de VibeFox en License key del bloque de licencia de la parte superior de la página Configure y haz clic en Activate (ver Clave de licencia).
4. Introduce el token de API y tu código PIN de origen, elige Express o Surface y Pre-paid o COD. Si la moneda predeterminada de tu tienda no es INR, introduce el tipo de cambio. Opcionalmente, introduce precios fijos (véase Configuración). Haz clic en Save.
Al instalarse, el módulo crea el transportista Delhivery con el texto del tiempo de entrega Courier delivery (India) y la página de seguimiento de Delhivery como URL de seguimiento. El transportista se asigna a todas las zonas y a todos los grupos de clientes. Puedes cambiar las zonas, los grupos de clientes, el tiempo de entrega, el logotipo y los límites de tamaño en Shipping > Carriers. No configures precios allí: el precio siempre procede del módulo.
Configuración
Todos los ajustes están en la página del módulo: Modules > Module Manager > VibeFox Delhivery > Configure. Se aplican a todas las zonas. Cada sección tiene su propio botón Save, que guarda toda la página. Cada guardado también borra las tarifas de Delhivery en caché. Los importes admiten «9.99» y «9,99». Si un campo numérico no contiene un número no negativo, se muestra un error y no se guarda nada.
Si la moneda predeterminada de tu tienda no es INR, hay un token de API guardado y no se ha introducido ningún tipo de cambio, una advertencia encima del formulario recuerda que las tarifas en tiempo real no se usan hasta que introduzcas el tipo de cambio. Si la unidad de peso de tu tienda no es una unidad estándar (kg, g, lb u oz), una advertencia te pide configurarla en International > Localization (Local units), porque, de lo contrario, los pesos de los productos se leen como kilogramos.
General
Enable Delhivery: activa o desactiva el transportista. Es el mismo interruptor que el estado del transportista en Shipping > Carriers.
Method title: el nombre del transportista que se muestra en el carrito y en la finalización de compra. Predeterminado: Delhivery. Obligatorio, máximo 64 caracteres.
Tax: la regla de impuesto del transportista, o No tax. Con una regla, PrestaShop añade el impuesto sobre el coste de envío.
Cuenta de API de Delhivery (necesaria solo para las tarifas en tiempo real)
Environment: Production (track.delhivery.com) (predeterminado) 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. Se envía solo en la cabecera de autorización y nunca se escribe en los logs. Después de guardar, el campo queda vacío y muestra Saved — leave empty to keep it. Escribe un valor nuevo solo si quieres cambiarlo.
Remove saved token: activa esta opción y guarda para eliminar el token guardado. Entonces solo se usan los precios fijos.
Origin pincode: el código PIN de 6 dígitos de tu punto de recogida o almacén, por ejemplo 110001. Si no tiene 6 dígitos, se muestra una advertencia y no se solicitan tarifas en tiempo real hasta que se corrija.
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 (entregas).
Shipping mode: el modo de facturación de Delhivery que se usa para la tarifa: Express (predeterminado) o Surface.
Payment type: el tipo de pago que se envía a Delhivery: Pre-paid (predeterminado) o COD (cash on delivery — Delhivery adds its COD charge). El módulo no lo cambia según el método de pago que elija el cliente.
Rate amount: Delhivery devuelve el importe con y sin GST.
INR to (shop currency) conversion rate: la etiqueta muestra la moneda predeterminada de tu tienda. Las tarifas de Delhivery están en rupias indias. Si la moneda predeterminada no es INR, introduce cuántas unidades de tu moneda vale una rupia, por ejemplo 0.011. El tipo de cambio debe ser mayor que 0. Si lo dejas vacío, las tarifas en tiempo real no se usan y se aplican los precios fijos. No es necesario si la moneda predeterminada es INR.
Precios fijos (se usan cuando no hay una tarifa en tiempo real disponible)
Los precios fijos se usan cuando todavía no hay token o código PIN, cuando el destino está fuera de la India, cuando el código PIN no tiene cobertura o cuando la API devuelve un error. Están en la moneda predeterminada de tu tienda, sin impuestos.
Prices per country: uno por línea en el formato COUNTRY_CODE:price, por ejemplo IN:120. Se comprueban antes que el precio de reserva. Las líneas con otro formato se eliminan al guardar y una advertencia las enumera.
Fallback price: se usa cuando no se aplican ni una tarifa en tiempo real ni un precio por país. Déjalo vacío para ocultar el transportista. 0 significa gratis.
Fixed price is charged: Per order cobra el precio una 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 (productos que requieren envío, después de descuentos y antes de impuestos) es al menos este importe. No se envía ninguna solicitud a Delhivery. Déjalo vacío para desactivarlo.
Show from subtotal: muestra el transportista solo si el subtotal del carrito es al menos este importe. Déjalo vacío para mostrarlo siempre.
Min weight: el peso mínimo del carrito en kg para mostrar el transportista. 0 significa sin límite.
Max weight: oculta el transportista si el carrito pesa más, en kg. Predeterminado: 30. 0 significa sin límite; un campo vacío significa 30 kg. Min weight no puede ser mayor que Max weight: la página muestra un error y no se guarda nada.
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.
Disponibilidad sin zonas de envío
Ignore zones: cuando está desactivado, los países se definen por las zonas del transportista en Shipping > Carriers. Cuando está activado, el transportista se asocia a todas las zonas (también a las que crees más adelante) y se ofrece para los países indicados abajo. Al desactivarlo, el transportista recupera sus zonas anteriores.
Countries: los países de destino para ese modo, elegidos entre tus países activos. 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: escribe los cálculos de tarifas en logs/vfd_dlv_debug.log.php, en la carpeta del módulo. El archivo no se puede abrir desde la web. Los errores de la API siempre se registran, incluso cuando esta opción está desactivada. Los tokens y los códigos PIN completos de los clientes nunca se registran.
Log: muestra el tamaño y las últimas entradas del registro. Haz clic en Clear log para vaciarlo.
Remove data on uninstall: cuando está activado, al desinstalar el módulo se eliminan los ajustes de Delhivery, el transportista, las tarifas en caché, los datos de los pedidos y los registros. Cuando está desactivado, todo se conserva para una reinstalación. Los números AWB de los pedidos nunca se eliminan.
Cómo funciona en la finalización de compra
En el paso de envío, PrestaShop pide al módulo el precio de Delhivery. Solo cuentan los productos físicos: los productos virtuales no añaden peso y no se incluyen en el subtotal. El módulo comprueba primero los países (cuando Ignore zones está activado), el peso del carrito y Show from subtotal. Si se aplica el envío gratis, el precio es 0 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 módulo 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. El importe devuelto se convierte de INR a la moneda predeterminada de tu tienda y después se muestra en la moneda del carrito del cliente. 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 de los dos, el transportista se oculta. El cliente nunca ve un error de la API. El motivo se escribe en el registro.
Si editas el transportista en Shipping > Carriers después de que tenga pedidos, PrestaShop lo guarda como una nueva versión del transportista. El módulo sigue la nueva versión automáticamente.
El módulo calcula las tarifas y da a los clientes un enlace de seguimiento. No crea envíos ni guías, no imprime etiquetas, no solicita recogidas ni manifiestos, no comprueba la cobertura de códigos PIN, no estima fechas de entrega, no sincroniza los estados de seguimiento y no calcula tarifas internacionales de Delhivery. Fuera de la India solo se usan los precios fijos.
Pedidos y seguimiento
Cuando se realiza un pedido con Delhivery, el módulo guarda con el pedido el modo de envío y el origen del precio. En la página del pedido en el administrador, el bloque Delhivery muestra Mode: (Express o Surface), Price: (tarifa en tiempo real de Delhivery, precio fijo o umbral de envío gratis) y el Delhivery AWB / tracking number, o Not entered yet.
Crea el envío en Delhivery One y luego introduce su AWB como número de seguimiento del pedido en el bloque Carriers de la página del pedido (Edit). El bloque Delhivery muestra entonces un enlace Track on delhivery.com. El cliente ve un enlace de seguimiento en el historial del pedido y recibe el correo electrónico «En tránsito» de PrestaShop.
Clave de licencia
El módulo funciona con una clave de licencia de VibeFox de vibefox.net. El bloque de licencia License — VibeFox Delhivery es el primero de la página Modules > Module Manager > VibeFox Delhivery > Configure, encima de los ajustes. Introduce la clave en License key y haz clic en Activate. Después, el bloque muestra la clave enmascarada, el estado (por ejemplo, la fecha hasta la que la licencia está activa y tu dominio) y los botones Check now para volver a comprobar el estado, Change key para introducir otra clave y Remove key para eliminar la clave de esta tienda. Debajo aparecen la línea Product: presta-shipping-delhivery y el enlace Manage licenses and domains in your account, que abre tu cuenta de vibefox.net. Solo los empleados con el permiso Configure del módulo pueden cambiar la clave. Los textos del bloque siguen el idioma del back office (se incluyen inglés y ruso).
Si la clave no se acepta, el bloque indica el motivo, por ejemplo Key not found, This key belongs to another product, Domain limit reached o License expired on seguido de una fecha. Después de cambiar la dirección de la tienda, o después de liberar una plaza de dominio en tu cuenta, haz clic en Check now. Si no se puede conectar con el servidor de licencias, el módulo sigue funcionando con el último estado conocido.
Una clave funciona en un dominio: el dominio de la tienda principal, también en una configuración multitienda. Eliminar la clave de la tienda no libera su plaza de dominio. Libera la plaza en tu cuenta de vibefox.net.
Sin una clave activa, el transportista Delhivery no se muestra a los clientes en la finalización de compra y no se calcula ninguna tarifa. La tienda de PrestaShop no sabe que has iniciado sesión en el back office, así que el transportista también se oculta para ti: puedes configurar el módulo antes de comprar una clave, pero no probarlo en la finalización de compra. Aparece un recordatorio en Modules > Module Manager, en la pestaña Alerts. Los pedidos existentes no se ven afectados.
Cuando una licencia caduca, el módulo sigue funcionando, pero las actualizaciones y el soporte necesitan una renovación. El estado se vuelve a comprobar automáticamente mientras trabajas en el back office: una vez al día durante los primeros 14 días después de introducir la clave, y después una vez a la semana. No se necesita ninguna tarea cron. Desinstalar o restablecer el módulo elimina siempre la clave de licencia y el estado de la licencia.
Solución de problemas
Delhivery no aparece en la finalización de compra: comprueba que la licencia esté activa y que Enable Delhivery esté activado. En Shipping > Carriers comprueba que el transportista cubra la zona del país del cliente y el grupo del cliente, o activa Ignore zones y revisa Countries. Revisa los límites de peso y Show from subtotal. Sin tarifa en tiempo real, hace falta un precio por país o un Fallback price. Los productos también se pueden limitar a determinados transportistas en la página del producto.
Las tarifas en tiempo real no aparecen: comprueba el token de API, un Origin pincode válido y, si la moneda predeterminada no es INR, el tipo de cambio. El cliente debe introducir un código PIN indio válido de 6 dígitos. Activa Debug log, recarga la finalización de compra y mira el campo Log en la página del módulo. Muestra el motivo, por ejemplo un código PIN sin cobertura o un error HTTP de Delhivery.
El GST se cobra dos veces: el importe total de Delhivery ya incluye el GST. Pon Rate amount en Gross amount (excluding GST) o pon Tax en No tax.
Pruebas: pon Environment en Staging y usa un token de prueba de Delhivery.
Las tarifas parecen desactualizadas tras un cambio: haz clic en Save en la página del módulo. Así se borran las tarifas de Delhivery en caché.
La página indica que no se encontró el transportista de Delhivery: el transportista se eliminó en Shipping > Carriers. Restablece el módulo en Modules > Module Manager para volver a crearlo.
Para desarrolladores: el módulo ejecuta los hooks actionVfdDlvApiUrl y actionVfdDlvApiTimeout, que pueden cambiar la dirección de la API y el tiempo de espera.
Desinstalación
Ve a Modules > Module Manager, abre el menú junto a VibeFox Delhivery y elige Uninstall. La clave de licencia, el estado de la licencia y las tarifas en caché siempre se eliminan. Si Remove data on uninstall está activado, el transportista recupera sus zonas anteriores y se elimina (los pedidos conservan su historial), y se eliminan los ajustes, el registro y los datos de Delhivery de los pedidos (modo y origen del precio). Si está desactivado, el transportista solo se desactiva y se conservan todos los ajustes. Al volver a instalar el módulo, el transportista se restaura con el estado que tenía antes. Los números AWB permanecen en los pedidos.
Delhivery es una marca comercial de su respectivo titular. Este módulo no está afiliado ni respaldado por Delhivery.