Esta guía reúne las soluciones oficiales a las dudas técnicas más frecuentes al operar Modal COD Form en entornos de producción con alto tráfico publicitario.

1. Configuración Recomendada para Plugins de Caché (LiteSpeed Cache, WP Rocket, Cloudflare)

Como todas las acciones del formulario modal utilizan WordPress Nonces (_wpnonce) por seguridad, si un plugin de caché guarda el HTML estático de tus páginas de producto durante más de 12 o 24 horas, el nonce impreso en la página caducará y las peticiones AJAX devolverán error de validación.

Solución definitiva en 3 pasos:

1. Ajusta el TTL de Caché a 8 o 10 horas: En WP Rocket → Caché → Vida útil de la caché o en LiteSpeed Cache → Caché → TTL, establece el tiempo de vida máximo en 8 horas (28800 segundos).
2. Excluye de la función «Retrasar ejecución de JavaScript» (Delay JS Execution): Si usas la opción Delay JS de WP Rocket o LiteSpeed, añade estas exclusiones para que el botón abra el modal en el primer toque sin demoras:

   cod-form-custom.js
   cod-create-order.js
   cod-upsell.js
   modalcodf-form-custom.js
   modalcodf-create-order.js

3. No cachear peticiones a admin-ajax.php: Asegúrate de que Cloudflare o tu WAF no cacheen respuestas POST dirigidas a /wp-admin/admin-ajax.php.

2. Mis Pedidos con Upsells no se Sincronizan en una Sola Orden en Dropi

Si al vender un producto principal junto con un Upsell 1-Tick o 1-Click ves en el registro de Dropify el error Exception creando la orden: Producto no posee stock en ninguna de sus bodegas:

• Causa: El producto principal y el producto del Upsell pertenecen a diferentes proveedores o bodegas dentro de Dropi.
• Solución: Asegúrate de que los productos configurados en tus campañas de Upsell pertenezcan a la misma tienda/bodega que el producto principal, y verifica que la opción Activar sincronización con Dropify esté encendida en WooCommerce → Ajustes → Modal COD Form → Dropify (ver guía completa de Dropify).

3. Cómo Diagnosticar Entregas de Webhooks o Validaciones de Google Maps

En Modal COD Form PRO v5.0 no necesitas revisar archivos de log en el servidor FTP para saber si n8n, Make o Google Maps respondieron correctamente:

• Para Webhooks: Ve a WooCommerce → Ajustes → Modal COD Form → Webhook, marca la casilla Habilitar registro de entregas (cod_form_webhook_enable_log) y haz un pedido de prueba. En la tabla inferior verás el código HTTP exacto (200 OK, 404, 500), el tiempo de respuesta en milisegundos y la respuesta del servidor remoto. Recuerda desactivar el log cuando termines tus pruebas.
• Para Google Maps API: Ve a la pestaña Fraud Prevention y activa temporalmente Habilitar registro de peticiones (cod_google_maps_enable_log) para inspeccionar las últimas 10 consultas enviadas a Google Cloud.

4. El Selector de Variaciones Nativo o el Selector de Cantidad Aparece Duplicado

• Cuando creas una Oferta por Cantidad para un producto variable, el plugin oculta automáticamente la tabla de variaciones externa y muestra los selectores de talla/color por cada unidad dentro del modal.
• Si tu tema o una plantilla personalizada de Elementor sigue mostrando el selector de cantidad externo, ve a WooCommerce → Ajustes → Modal COD Form → General y marca Desactivar selector de cantidad de producto (cod_form_disable_quantity_selection = 'yes').

¿Necesitas más ayuda?

• 📚 Regresa al índice principal en ¿Qué es Modal COD Form? Comparativa y Guía General.
• 🏠 Visita la página oficial de Modal COD Form PRO.