Errores de carrito, checkout, devoluciones y transportistas en PrestaShop

Cinco problemas recurrentes en el día a día de una tienda PrestaShop: el botón de añadir al carrito que deja de responder, las formas de pago que desaparecen en el checkout, un error de meta_title que bloquea la edición de productos, la devolución que no se puede tramitar, y la gestión de varios transportistas a la vez.

Todos comparten algo: la causa casi nunca está donde parece a primera vista.

El botón «Añadir al carrito» no hace nada (o tarda en reflejar la cantidad)

Si al pulsar añadir al carrito no pasa nada visible y solo se actualiza el contador al cambiar de página, el causante casi siempre es un módulo de terceros con un conflicto de JavaScript, no el núcleo de PrestaShop.

El método de diagnóstico que funciona:

• Activa el modo de depuración: en PrestaShop 8 y 9, ve a Parámetros avanzados > Rendimiento > Modo de depuración y actívalo. Si no tienes acceso al panel, edita config/defines.inc.php y cambia define('_PS_MODE_DEV_', false); por true.
• Con el modo debug activo, abre la consola del navegador (F12) al pulsar el botón: el error JavaScript exacto (por ejemplo, una función no definida en un archivo con hash de caché) señala qué módulo lo provoca.
• Desinstala los módulos añadidos recientemente uno a uno, no todos a la vez, y vuelve a probar tras cada desinstalación.

Recuerda desactivar el modo debug después de diagnosticar: dejarlo activo en producción expone rutas de archivos y detalles internos a cualquier visitante.

Desaparecen las formas de pago en el checkout (especialmente como invitado)

Cuando los métodos de pago desaparecen justo al introducir los datos de envío, revisa primero Módulos y servicios > Módulos de pago, y dentro de cada módulo de pago, la sección de restricciones por grupo de cliente.

Es habitual que un módulo de pago tenga marcada la restricción a un grupo concreto (por ejemplo, «Clientes registrados») y que el grupo «Invitado» quede fuera sin que nadie lo haya decidido así deliberadamente. Verifica también las restricciones por transportista y por país, que pueden solaparse y anular el método de pago para combinaciones concretas de envío.

No puedo modificar productos: «El campo meta_title no es válido»

Este error de validación de campo suele venir de un carácter especial en el título o meta_title del producto (comillas curvas pegadas desde Word, el símbolo >, o similares) que el validador de PrestaShop rechaza.

Revisa el campo carácter a carácter, especialmente si el texto se pegó desde otro documento.
Si el problema aparece de forma generalizada al usar URLs con acentos, en PrestaShop 8 puedes ajustar esto en Parámetros de la tienda > Tráfico y SEO, en el apartado de URL acentuada.

Si después de aislar el módulo o la configuración el problema persiste, podemos revisar la configuración de tu tienda como parte de nuestro servicio de soporte y ayuda para PrestaShop.

La devolución de un pedido no se puede tramitar

Si un pedido no permite seleccionar el artículo a devolver, comprueba el estado del pedido antes que cualquier otra cosa: en Parámetros de tienda > Estados de pedido, cada estado tiene configurado si permite o no iniciar una devolución.

Si usas un módulo de transportista con automatizaciones (Correos Express y similares), es habitual que el módulo cree sus propios estados personalizados (por ejemplo «Entregado CEX») que no hereden la configuración de devoluciones del estado «Entregado» estándar.

La solución es igualar en el estado personalizado las mismas propiedades (permitir devolución, enviar email, etc.) que tiene el estado equivalente del que depende tu operativa.

Gestionar varios transportistas sin perder el control

Si trabajas con más de un transportista y no quieres que el cliente elija (por ejemplo, porque repartes el volumen según capacidad diaria), la solución no es activar y desactivar transportistas cada día

El patrón que funciona: deja visible un único transportista «genérico» de cara al cliente, y usa un módulo de cambio de transportista dentro del pedido ya creado (hay varias opciones de pago único en Addons) para reasignar cada pedido al transportista real internamente, sin que el cliente tenga que elegir ni lo note en el proceso de compra.

Antes de escalarlo a soporte técnico

En los cinco casos, el primer paso rentable es siempre el mismo: activar el modo debug para ver el error real, y revisar las restricciones (por grupo, país o transportista) antes de sospechar de un fallo del núcleo de PrestaShop.