Solución de Problemas
Problemas Comunes
La Vista Previa No Muestra Productos
Problema: El botón de vista previa devuelve "No se encontraron productos".
Causas:
- Filtros demasiado restrictivos
- La categoría seleccionada está vacía
- Ningún producto coincide con tu combinación de filtros
Soluciones:
- Elimina algunos filtros e inténtalo de nuevo
- Comprueba si la categoría seleccionada tiene productos
- Cambia "Tiene Vídeos" a "Todos"
- Verifica que el fabricante tiene productos en la categoría seleccionada
La Vista Previa Muestra Productos Incorrectos
Problema: La vista previa incluye productos inesperados.
Causas:
- Múltiples categorías seleccionadas (se incluyen productos en CUALQUIER categoría)
- Lógica de filtros mal entendida (usa lógica AND)
- Estado activo no configurado correctamente
Soluciones:
- Añade filtros de uno en uno mientras previsualizas para ver qué hace cada uno
- Comprueba que todos los filtros están configurados como se pretende
- Recuerda: los productos deben cumplir TODOS los filtros
No Puedo Ejecutar la Operación
Problema: El botón Ejecutar no funciona o muestra un error.
Causas:
- No has hecho vista previa todavía (la vista previa es obligatoria)
- No hay productos en la vista previa
- Faltan campos obligatorios (por ejemplo, URL de vídeo para la acción Añadir)
Soluciones:
- Haz clic primero en "Previsualizar Productos Afectados"
- Verifica que la vista previa muestra productos
- Comprueba que todos los campos obligatorios están rellenos
- Para la acción Añadir, asegúrate de que se ha proporcionado la URL del vídeo
Error de URL de Vídeo No Válida
Problema: Error "URL de vídeo no válida" al añadir vídeos.
Causas:
- Formato de URL incorrecto
- Proveedor de vídeo no configurado en los ajustes del módulo
- URL no pertenece a una plataforma compatible
Soluciones:
- Verifica el formato de la URL (consulta los ejemplos en la guía de Acciones Masivas)
- Prueba la URL en un navegador primero
- Para vídeos que no sean de YouTube/Vimeo, configura el proveedor en los ajustes del módulo
- Asegúrate de que la URL es completa y válida
La Operación Excede el Tiempo de Espera
Problema: La operación tarda demasiado o supera el tiempo de espera.
Causas:
- Demasiados productos (200+)
- Recursos del servidor limitados
- Operaciones grandes durante horas de tráfico pico
Soluciones:
- Divide la operación en lotes más pequeños (50-100 productos a la vez)
- Ejecuta las operaciones en horas de baja actividad
- Filtra más específicamente para reducir el número de productos
Los Vídeos No Aparecen en el Frontend
Problema: Los vídeos se añadieron correctamente pero no aparecen en las páginas de producto.
Causas:
- Caché no limpiada
- Vídeo restringido a usuarios registrados (y no has iniciado sesión)
- La plantilla no soporta vídeos de producto
- Configuración incorrecta del proveedor de vídeo
Soluciones:
- Limpia la caché de PrestaShop (ajustes de Rendimiento)
- Limpia la caché del navegador
- Comprueba si el vídeo está configurado como "Solo Registrados"
- Verifica que tu tema soporta vídeos de producto
- Prueba con un producto diferente
No Puedo Eliminar Vídeos
Problema: La operación de eliminar no funciona.
Causas:
- El filtro no muestra productos con vídeos
- Filtro "Tiene Vídeos" configurado en "Sin Vídeos"
Soluciones:
- Configura "Tiene Vídeos" en "Con Vídeos"
- Haz vista previa para verificar que los productos tienen vídeos
- Comprueba si los productos realmente tienen vídeos adjuntos
Los Cambios se Aplicaron en la Tienda Incorrecta
Problema: Los vídeos se añadieron/actualizaron en el contexto de tienda incorrecto.
Causas:
- Trabajando en entorno multitienda
- Contexto de tienda incorrecto seleccionado
Soluciones:
- Comprueba el selector de tienda antes de ejecutar
- Cambia al contexto de tienda correcto
- Haz vista previa de nuevo para verificar
- En multitienda, los vídeos son específicos por tienda
Mensajes de Error
"Se requiere al menos un filtro"
Significado: Debes establecer al menos un filtro.
Solución: Selecciona una categoría, fabricante, estado activo o filtro de Tiene Vídeos.
"Se requiere URL de vídeo"
Significado: La acción Añadir necesita una URL de vídeo.
Solución: Rellena el campo URL de Vídeo con una URL válida.
"Ningún producto coincide con tus filtros"
Significado: Tu combinación de filtros no devuelve ningún producto.
Solución: Amplía tus filtros o comprueba si la categoría tiene productos.
"Proveedor no configurado"
Significado: La plataforma de vídeo no está configurada en los ajustes del módulo.
Solución: Ve a la configuración del módulo y añade el proveedor de vídeo.
Mejores Prácticas
Para Evitar Problemas:
- Haz siempre vista previa antes de ejecutar
- Prueba con 2-3 productos primero cuando estés aprendiendo
- Comprueba los filtros con cuidado para operaciones de Eliminar
- Trabaja en lotes para operaciones grandes (50-100 productos)
- Verifica el contexto de tienda en entornos multitienda
- Limpia la caché después de las operaciones si los vídeos no aparecen
- Documenta las operaciones para referencia futura
- Prueba las URLs de vídeo en el navegador antes de añadirlas
¿Sigues Teniendo Problemas?
Si sigues experimentando problemas:
- Comprueba que la configuración del módulo es correcta
- Verifica que tienes los permisos adecuados
- Consulta los registros de errores del servidor para información detallada
- Prueba con un solo producto manualmente para aislar el problema
- Contacta con soporte con los mensajes de error específicos
Preguntas Frecuentes
¿Puedo deshacer una operación masiva?
No. Las operaciones son permanentes, especialmente Eliminar. Haz siempre vista previa con cuidado.
¿Cuántos productos puedo procesar a la vez?
Técnicamente 500+, pero se recomienda mantenerse por debajo de 200 por operación para un mejor rendimiento y control.
¿Qué ocurre si cierro el navegador durante la ejecución?
La operación puede quedar parcialmente completa. Comprueba los productos manualmente y vuelve a ejecutar si es necesario con filtros ajustados.
¿Por qué no puedo seleccionar múltiples fabricantes?
Por diseño, solo UN fabricante a la vez. Ejecuta operaciones separadas para cada fabricante.
¿Las operaciones funcionan en todos los idiomas?
Sí. Las operaciones se aplican a todos los idiomas, aunque los nombres de los productos en la vista previa se muestran en el idioma seleccionado.
¿Por qué los vídeos no aparecen en la tienda después de una operación masiva exitosa?
La causa más común es que no se ha limpiado la caché de PrestaShop. Ve a Parámetros Avanzados, luego Rendimiento, y haz clic en Limpiar caché. Limpia también la caché del navegador. Si los vídeos están configurados como Solo Registrados, debes haber iniciado sesión para verlos.
¿Por qué no funciona el botón ejecutar?
Debes hacer clic en Vista Previa de Productos Afectados antes de que Ejecutar esté disponible. Si la vista previa no muestra productos, ajusta los filtros. Asegúrate también de que todos los campos obligatorios estén rellenos, como la URL del vídeo para una operación de Añadir.
Obtuve un error de URL de vídeo no válida al usar Añadir. ¿Qué hago?
Primero verifica que la URL es correcta abriéndola en el navegador. Para plataformas distintas de YouTube y Vimeo, comprueba que el proveedor está configurado en los ajustes del módulo. Asegúrate de que la URL está completa y copiada directamente de la plataforma de vídeo.
La operación agotó el tiempo de espera. ¿Cómo gestiono catálogos grandes?
Divide la operación en lotes más pequeños de 50 a 100 productos ajustando los filtros, y ejecuta las operaciones en horas de baja actividad para reducir la carga del servidor.
Consulta las otras guías para información detallada sobre filtros, acciones y ejecución.
Última actualización: 2025-12-16