Resumen
AI Merchant Pro para PrestaShop es un módulo potente que genera feeds de productos listos para IA para ChatGPT Shopping y Google Merchant Center. Crea feeds en doble formato (XML + JSON) desde tu catálogo de PrestaShop, haciendo que tus productos sean descubribles por más de 300M de usuarios de ChatGPT y plataformas de compra tradicionales.
Generación de Feed Doble
Genera simultáneamente feeds XML (Google) y JSON ACP (ChatGPT) desde tu catálogo.
Learn moreGeneración Automática de Feeds
Actualiza automáticamente tus feeds de productos con cron jobs para sincronización de inventario en tiempo real.
Learn moreIntegración de Transportistas
Exporta automáticamente la configuración de transportistas de PrestaShop a reglas de envío del feed.
Learn moreIntegración con ChatGPT
Compatibilidad directa con ChatGPT Shopping para comercio conversacional.
Learn moreAlto Rendimiento
Funciona con más de 10.000 productos con procesamiento por lotes optimizado y caché.
Learn moreRequisitos del Sistema
Requisitos Mínimos
- PrestaShop 1.7.x u 8.x
- PHP 7.4 o superior (8.0+ recomendado)
- MySQL 5.6 o superior
- Cron Jobs Requerido para generación automática de feeds
- HTTPS Certificado SSL instalado (requerido)
- Límite de Memoria 256MB mínimo (512MB recomendado)
Para Catálogos Grandes (10K+ productos)
- PHP 8.0 o superior
- Límite de memoria de 512MB
- 300 segundos de tiempo máximo de ejecución
- OPcache activado
- Redis o Memcached recomendado
Checklist de Inicio Rápido
- PrestaShop 1.7.x u 8.x instalado y activo
- Productos con imágenes, precios y descripciones
- Certificado SSL instalado (HTTPS)
- Capacidad de cron jobs en tu servidor
Instalación
Descargar el Módulo
Compra y descarga AI Merchant Pro para PrestaShop desde el panel
de tu cuenta. Recibirás un archivo ZIP llamado
aimerchantpro.zip.
Subir a PrestaShop
En el admin de PrestaShop, ve a Módulos → Gestor de módulos → Subir un módulo. Haz clic en "seleccionar archivo", elige el ZIP y espera a que termine la instalación.
Instalar el Módulo
Tras subirlo, haz clic en "Instalar" en el módulo AI Merchant Pro. El proceso de instalación creará las tablas necesarias en la base de datos y registrará los endpoints de feed.
Configurar el Módulo
Haz clic en "Configurar" para acceder a los ajustes del módulo. El panel de configuración te permite personalizar la generación de feeds, filtros de producto y opciones avanzadas.
Activar tu Licencia
En la configuración del módulo, introduce tu clave de licencia de la compra y haz clic en "Activar Licencia" para desbloquear todas las funciones premium y actualizaciones automáticas.
¡Instalación completada!
Tus feeds ya están disponibles en:
- Feed XML:
https://yoursite.com/modules/aimerchantpro/feed.php?format=xml - Feed JSON:
https://yoursite.com/modules/aimerchantpro/feed.php?format=json
Configuración del Módulo
Configura AI Merchant Pro desde Módulos → Gestor de módulos → AI Merchant Pro → Configurar.
Ajustes Generales
La pestaña de Ajustes Generales controla el comportamiento básico del módulo y las opciones de generación de feeds.
| Ajuste | Descripción | Predeterminado |
|---|---|---|
| Activar Módulo | Activar/desactivar globalmente la generación de feeds | Activado |
| Duración de Caché del Feed | Cuánto tiempo cachear los feeds generados (horas) | 1 hora |
| Idioma Predeterminado | Idioma principal para datos de producto | Predeterminado de la tienda |
| Moneda Predeterminada | Moneda principal para precios | Predeterminada de la tienda |
Ajustes de Feed
Controla qué productos se incluyen en tus feeds y cómo se formatean.
| Opción | Descripción | Recomendado |
|---|---|---|
include_combinations | Incluir combinaciones de producto como ítems separados | Activado |
include_out_of_stock | Incluir productos con cantidad cero | Desactivado |
include_inactive | Incluir productos inactivos | Desactivado |
include_description | Usar descripción completa (vs descripción corta) | Activado |
image_size | Tamaño de imagen a usar (large, medium, small) | Large |
Filtros de Producto
Filtra qué productos aparecen en tus feeds por categoría, fabricante o proveedor.
Opciones Avanzadas
Ajustes avanzados para optimización de rendimiento y configuraciones multi-tienda.
| Ajuste | Propósito | Cuándo usarlo |
|---|---|---|
| Tamaño de Lote | Productos procesados por lote | Catálogos grandes (5000+) |
| Modo Multi-Tienda | Generar feeds separados por tienda | Instalaciones multi-store |
| Clave Secreta de Cron | Token de seguridad para endpoints cron | Siempre (auto-generada) |
| Modo Debug | Registrar información detallada de generación de feed | Solo para solución de problemas |
URLs de Feed
Después de la instalación, tus feeds de productos se generan dinámicamente en estas URLs:
Feed XML (Google Merchant Center)
El feed XML sigue la especificación RSS 2.0 de Google Merchant Center con extensiones del espacio de nombres de Google Shopping.
https://yoursite.com/modules/aimerchantpro/feed.php?format=xml Feed JSON ACP (ChatGPT Shopping)
El feed JSON usa el formato AI Commerce Protocol (ACP) optimizado para ChatGPT y otros asistentes de compra con IA.
https://yoursite.com/modules/aimerchantpro/feed.php?format=json Parámetros de URL del Feed
Personaliza la salida del feed con estos parámetros opcionales:
| Parámetro | Valores | Ejemplo |
|---|---|---|
format | xml, json | ?format=json |
lang | Código ISO de idioma | ?format=json&lang=en |
currency | Código ISO de moneda | ?format=json¤cy=EUR |
limit | Número de productos | ?format=json&limit=100 |
shop_id | ID de tienda (multi-store) | ?format=json&shop_id=2 |
Seguridad de Feed
Compatibilidad con ChatGPT Merchant
AI Merchant Pro para PrestaShop genera feeds 100% compatibles con la especificación AI Commerce Protocol (ACP) de ChatGPT Shopping.
¿Qué lo hace compatible?
Formato ACP
Los feeds JSON siguen la estructura oficial de AI Commerce Protocol requerida por ChatGPT Shopping.
Campos Requeridos
Todos los campos obligatorios del producto (título, URL, precio, imagen) se incluyen automáticamente.
Datos de Envío
Los ajustes de transportistas de PrestaShop se exportan como reglas de envío en formato ACP.
Listo para Validación
Los feeds superan las validaciones de ChatGPT para calidad de datos de producto.
Envío a ChatGPT Shopping
Genera tu Feed
Asegúrate de que tu feed JSON sea accesible en:
https://yoursite.com/modules/aimerchantpro/feed.php?format=json
Valida tu Feed
Prueba tu feed con el validador integrado o herramientas externas de validación ACP para identificar problemas antes del envío.
Envíalo a OpenAI
Visita el Portal de Comerciantes de OpenAI y envía la URL de tu feed JSON para revisión.
Espera la Aprobación
OpenAI rastreará y verificará tu feed. La aprobación suele tardar entre 3 y 7 días hábiles. Revisa tu correo para ver actualizaciones.
Validación de Feed
El módulo incluye un validador integrado accesible desde el panel de configuración. Ejecuta la validación para comprobar:
- Campos requeridos faltantes - Productos sin título, precio o imagen
- URLs inválidas - Enlaces rotos de producto o imagen
- Problemas de precio - Precios en cero o negativos
- Calidad de imagen - Imágenes por debajo del tamaño mínimo (500x500px)
- Longitud de descripción - Descripciones demasiado cortas o largas
¿Validación aprobada?
Compatibilidad con Google Merchant Center
Usa el formato de feed XML para campañas tradicionales de Google Merchant Center y anuncios de Shopping.
Configuración de Google Merchant Center
Crea tu Cuenta Merchant
Regístrate en Google Merchant Center y verifica la propiedad de tu sitio web.
Añade el Feed de Productos
En Merchant Center, ve a Productos → Feeds → Añadir feed. Elige "Recuperación programada" e introduce la URL de tu feed XML.
https://yoursite.com/modules/aimerchantpro/feed.php?format=xml Define el Horario de Recuperación
Configura Google para recuperar tu feed a diario (recomendado) o semanalmente. La mayoría de tiendas actualizan a diario para mantener sincronizado el inventario.
Revisa los Productos
Después de la primera recuperación, revisa el estado de los productos en Merchant Center. Corrige cualquier rechazo antes de lanzar campañas de Shopping.
Datos de Producto Requeridos
El módulo incluye automáticamente estos campos requeridos por Google:
| Campo | Origen en PrestaShop | Requerido |
|---|---|---|
id | ID del producto | Sí |
title | Nombre del producto | Sí |
description | Descripción del producto | Sí |
link | URL del producto | Sí |
image_link | URL de la imagen de portada | Sí |
price | Precio del producto (con impuestos) | Sí |
availability | Estado de stock | Sí |
brand | Nombre del fabricante | Recomendado |
gtin | EAN13 o UPC | Recomendado |
Problemas Comunes en Google Merchant
Falta GTIN (EAN/UPC)
Google requiere identificadores únicos de producto. En PrestaShop:
- Edita el producto en tu catálogo
- Ve a la pestaña Opciones
- Introduce el código EAN-13, UPC o ISBN
- Guarda y regenera tu feed
Precio no Coincide
El precio del feed debe coincidir exactamente con el precio de tu página de producto:
- Limpia la caché de PrestaShop después de cambios de precio
- Asegura que el cálculo de impuestos sea correcto
- Revisa plugins de precios dinámicos que puedan afectar la visualización
- Regenera el feed y verifica la salida XML
Problemas de Calidad de Imagen
Google requiere imágenes de alta calidad (mínimo 100x100, recomendado 800x800):
- Sube imágenes de producto de mayor tamaño
- Configura el tamaño de imagen en "large" en ajustes del módulo
- Evita marcas de agua o texto promocional en las imágenes
- Usa fondos blancos o neutros
Pruebas y Validación
Antes de enviar tus feeds a ChatGPT o Google, pruébalos a fondo para asegurar calidad de datos y cumplimiento.
Validador de Feed Integrado
El módulo incluye un validador accesible desde el panel de configuración. Haz clic en "Validar Feed" para escanear tu catálogo en busca de problemas.
Los productos serán rechazados si existen estos problemas:
- Falta título o descripción del producto
- No hay URL de producto o hay enlaces rotos
- El precio es cero, negativo o falta
- No hay imágenes de producto
- URLs de imagen inválidas (errores 404)
Esto puede reducir la visibilidad:
- Descripción demasiado corta (<50 caracteres)
- Falta fabricante/marca
- Sin código GTIN/EAN
- Imágenes por debajo de 500x500 píxeles
- Faltan asignaciones de categoría
Recomendaciones para mejorar el rendimiento:
- Añade más imágenes de producto (se recomiendan 2-5)
- Incluye características y especificaciones del producto
- Añade reseñas de clientes si están disponibles
- Usa todos los campos de atributos del producto
Herramientas Externas de Prueba
Usa estas herramientas para validar tus feeds antes del envío:
- Google Merchant Center Feed Tester - Prueba feeds XML para cumplimiento con Google Shopping
- ACP Validator - Valida feeds JSON contra los requisitos de ChatGPT Shopping
- Feed Viewer - Visualiza tu feed en un navegador para revisar el formato
Flujo de Pruebas
- Ejecuta primero el validador integrado para detectar problemas evidentes
- Corrige todos los errores críticos y la mayoría de advertencias
- Prueba con herramientas externas para validación específica por plataforma
- Envía a la plataforma y monitorea el estado de aprobación
Mejores Prácticas
Sigue estas recomendaciones para maximizar la visibilidad de producto y las tasas de aprobación en plataformas de compra con IA.
Optimización de Producto
Imágenes de Alta Calidad
Usa imágenes de 800x800+ con fondo blanco. Incluye múltiples ángulos. Evita superposición de texto o marcas de agua.
Títulos Descriptivos
Incluye marca, tipo de producto y características clave. Mantén menos de 150 caracteres. Sé específico y preciso.
Descripciones Detalladas
Escribe descripciones de 150-500 caracteres. Enfócate en beneficios y casos de uso. Evita sobrecargar de palabras clave.
Atributos Completos
Completa todos los atributos del producto (talla, color, material). Añade códigos EAN/UPC. Incluye nombre del fabricante.
Mantenimiento del Feed
- Configura generación automática de feeds - Configura tareas cron para regenerar feeds diariamente
- Monitorea la salud del feed - Revisa semanalmente los resultados del validador para detectar nuevos problemas
- Mantén los productos actualizados - Elimina artículos descatalogados y actualiza precios regularmente
- Prueba después de cambios - Valida el feed después de actualizaciones importantes de catálogo o cambios de configuración del módulo
Consejos de Rendimiento
- Activa caché con TTL de 6-12 horas
- Reduce el tamaño de lote a 250-500 productos
- Ejecuta la generación del feed en horas valle
- Considera excluir productos de bajo valor o inactivos
Solución de Problemas
La URL del feed devuelve página en blanco o error
Solución: Revisa la instalación del módulo y los errores de PHP.
- Verifica que el módulo esté instalado y activado
- Revisa logs de errores de PHP por errores fatales
- Aumenta `memory_limit` de PHP a 512MB
- Aumenta `max_execution_time` a 300 segundos
- Activa el modo debug en ajustes del módulo
Faltan algunos productos en el feed
Los productos pueden excluirse si:
- Están inactivos o no publicados
- Tienen cantidad cero (si "excluir fuera de stock" está activado)
- Pertenecen a categorías excluidas
- No tienen precio configurado
- No tienen imágenes asignadas
Revisa la configuración del producto y los filtros del módulo.
La generación del feed es muy lenta
Para catálogos grandes:
- Activa caché de feed en ajustes del módulo
- Reduce el tamaño de lote a 250-500
- Aumenta `memory_limit` y `max_execution_time` de PHP
- Usa generación por cron en lugar de bajo demanda
- Activa OPcache y caché de objetos (Redis/Memcached)
Las imágenes no aparecen en el feed
Comprueba lo siguiente:
- Los productos tienen imagen de portada asignada
- Los archivos de imagen existen en el directorio /img/p/
- Tu sitio usa HTTPS (requerido para feeds)
- Las URLs de imagen son públicamente accesibles (sin protección)
- .htaccess permite el acceso a imágenes
Problemas de moneda o idioma
Para tiendas multiidioma/multimoneda:
- Genera feeds separados por idioma:
?lang=en,?lang=fr - Genera feeds separados por moneda:
?currency=EUR,?currency=USD - Verifica que códigos de idioma y moneda sean correctos en PrestaShop
- Comprueba que los productos tengan traducciones en todos los idiomas
¿Aún necesitas ayuda?
Activa el Modo Debug en ajustes avanzados del módulo para registrar información detallada de generación de feed en los logs de PrestaShop.
Preguntas Frecuentes
¿Con qué frecuencia debo regenerar mi feed?
Para la mayoría de tiendas, regenerar diariamente es suficiente. Si tienes cambios frecuentes de inventario, configura cron para regenerar cada 4-6 horas. Google normalmente rastrea feeds una vez al día.
¿Puedo usar esto con PrestaShop 1.6?
Este módulo requiere PrestaShop 1.7.x u 8.x. Para PrestaShop 1.6, contacta a soporte sobre disponibilidad de versión legacy.
¿Funciona con configuraciones multi-tienda?
¡Sí! Activa el modo multi-shop en ajustes avanzados y genera
feeds separados por tienda usando el parámetro shop_id:
?format=json&shop_id=1?format=json&shop_id=2
¿Cómo configuro la generación automática de feeds?
Configura una tarea cron en tu servidor:
0 2 * * * curl -s "https://yoursite.com/modules/aimerchantpro/cron.php?token=YOUR_SECRET_KEY" Esto regenera feeds diariamente a las 2 AM. Encuentra tu clave secreta en los ajustes avanzados del módulo.
¿Puedo excluir productos específicos de los feeds?
Sí, tienes dos métodos:
- Exclusión por categoría: En ajustes del módulo, excluye categorías completas de los feeds
- A nivel de producto: Marca productos específicos como inactivos o muévelos a una categoría excluida
¿Mis datos de producto se envían a servidores externos?
Tus datos de producto se mantienen en tu servidor. El módulo solo se comunica externamente para verificación de licencia. Las URLs de feed son públicas por diseño, ya que Google y ChatGPT necesitan rastrearlas.
Soporte y Actualizaciones
Obtén ayuda y mantente al día con las últimas mejoras del módulo.
Documentación
Accede a guías completas, tutoriales y mejores prácticas en nuestro portal de documentación.
Soporte por Email
Contacta a nuestro equipo de soporte para asistencia técnica y ayuda de configuración.
Actualizaciones Automáticas
Las actualizaciones del módulo se entregan automáticamente a través del gestor de módulos de PrestaShop.
Base de Conocimiento
Busca en nuestra base de conocimiento respuestas a preguntas comunes y guías de solución de problemas.
¿Necesitas ayuda?
¿No encuentras lo que buscas? Contacta a nuestro equipo de soporte:
- Email: support@aimerchantpro.com
- Tiempo de Respuesta: Dentro de 24 horas (días hábiles)
- Incluye: Versión de PrestaShop, versión del módulo y descripción detallada del problema
Actualizaciones del Módulo
El módulo comprueba actualizaciones automáticamente. Cuando hay una disponible:
- Verás una notificación en el gestor de módulos de PrestaShop
- Haz clic en "Actualizar" para instalar la última versión
- Tus ajustes de configuración se conservan durante las actualizaciones
- Los feeds siguen funcionando sin interrupciones