PrestaShop Module

AI Merchant Pro for PrestaShop

Complete documentation for installing, configuring, and using AI Merchant Pro to connect your PrestaShop store to ChatGPT Shopping and Google Merchant Center.

Version 2.0.0 Updated 2025-12-23

Overview

AI Merchant Pro for PrestaShop is a powerful module that generates AI-ready product feeds for ChatGPT Shopping and Google Merchant Center. It creates dual-format feeds (XML + JSON) from your PrestaShop catalog, making your products discoverable by 300M+ ChatGPT users and traditional shopping platforms.

Dual Feed Generation

Generate both XML (Google) and JSON ACP (ChatGPT) feeds simultaneously from your catalog.

Learn more

Automated Feed Generation

Automatically update your product feeds with cron jobs for real-time inventory sync.

Learn more

Carrier Integration

Automatically exports your PrestaShop carrier settings to feed shipping rules.

Learn more

Multi-Language Support

Generate separate feeds for each language and currency in your store.

Learn more

ChatGPT Integration

Direct compatibility with ChatGPT Shopping for conversational commerce.

Learn more

High Performance

Works with 10,000+ products with optimized batch processing and caching.

Learn more

System Requirements

Minimum Requirements
  • PrestaShop 1.7.x or 8.x
  • PHP 7.4 or higher (8.0+ recommended)
  • MySQL 5.6 or higher
  • Cron Jobs Required for automatic feed generation
  • HTTPS SSL certificate installed (required)
  • Memory Limit 256MB minimum (512MB recommended)
For Large Catalogs (10K+ products)
  • PHP 8.0 or higher
  • 512MB memory limit
  • 300 seconds max execution time
  • OPcache enabled
  • Redis or Memcached recommended

Quick Start Checklist

  • PrestaShop 1.7.x or 8.x installed and active
  • Products with images, prices, and descriptions
  • SSL certificate installed (HTTPS)
  • Cron jobs capability on your server

Installation

1

Download the Module

Purchase and download AI Merchant Pro for PrestaShop from your account dashboard. You'll receive a ZIP file named aimerchantpro.zip.

2

Upload to PrestaShop

In your PrestaShop admin, navigate to Modules → Module Manager → Upload a module. Click "select file" and choose the ZIP file, then wait for installation to complete.

3

Install the Module

After upload, click "Install" on the AI Merchant Pro module. The installation process will create the necessary database tables and register feed endpoints.

4

Configure the Module

Click "Configure" to access the module settings. The configuration panel allows you to customize feed generation, product filters, and advanced options.

5

Activate Your License

In the module configuration, enter your license key from your purchase and click "Activate License" to unlock all premium features and automatic updates.

Installation Complete!

Your feeds are now available at:

  • XML Feed: https://yoursite.com/modules/aimerchantpro/feed.php?format=xml
  • JSON Feed: https://yoursite.com/modules/aimerchantpro/feed.php?format=json

Module Configuration

Configure AI Merchant Pro from Modules → Module Manager → AI Merchant Pro → Configure.

General Settings

The General Settings tab controls basic module behavior and feed generation options.

Setting Description Default
Enable Module Turn feed generation on/off globally Enabled
Feed Cache Duration How long to cache generated feeds (hours) 1 hour
Default Language Primary language for product data Store default
Default Currency Primary currency for pricing Store default

Feed Settings

Control which products are included in your feeds and how they're formatted.

Option Description Recommended
include_combinations Include product combinations as separate items Enabled
include_out_of_stock Include products with zero quantity Disabled
include_inactive Include inactive products Disabled
include_description Use full description (vs short description) Enabled
image_size Image size to use (large, medium, small) Large

Product Filters

Filter which products appear in your feeds by category, manufacturer, or supplier.

Use category filters to create specialized feeds for different platforms or to exclude certain product types from AI shopping platforms.

Advanced Options

Advanced settings for performance optimization and multi-store setups.

Setting Purpose When to Use
Batch Size Products processed per batch Large catalogs (5000+)
Multi-Shop Mode Generate separate feeds per shop Multi-store installations
Cron Secret Key Security token for cron endpoints Always (auto-generated)
Debug Mode Log detailed feed generation info Troubleshooting only

Feed URLs

After installation, your product feeds are generated dynamically at these URLs:

XML Feed (Google Merchant Center)

The XML feed follows the Google Merchant Center RSS 2.0 specification with Google Shopping namespace extensions.

https://yoursite.com/modules/aimerchantpro/feed.php?format=xml

JSON ACP Feed (ChatGPT Shopping)

The JSON feed uses the AI Commerce Protocol (ACP) format optimized for ChatGPT and other AI shopping assistants.

https://yoursite.com/modules/aimerchantpro/feed.php?format=json

Feed URL Parameters

Customize feed output with these optional URL parameters:

Parameter Values Example
format xml, json ?format=json
lang Language ISO code ?format=json&lang=en
currency Currency ISO code ?format=json¤cy=EUR
limit Number of products ?format=json&limit=100
shop_id Shop ID (multi-store) ?format=json&shop_id=2
Feed Security
Feed URLs are public by design - Google and ChatGPT need to crawl them. Do not include sensitive information in product descriptions or custom fields.

ChatGPT Merchant Compatibility

AI Merchant Pro for PrestaShop generates feeds that are 100% compatible with ChatGPT Shopping's AI Commerce Protocol (ACP) specification.

What Makes It Compatible?

ACP Format

JSON feeds follow the official AI Commerce Protocol structure required by ChatGPT Shopping.

Required Fields

All mandatory product fields (title, URL, price, image) are automatically included.

Shipping Data

PrestaShop carrier settings are exported as shipping rules in the ACP format.

Validation Ready

Feeds pass ChatGPT's validation checks for product data quality.

Submitting to ChatGPT Shopping

1

Generate Your Feed

Ensure your JSON feed is accessible at:
https://yoursite.com/modules/aimerchantpro/feed.php?format=json

2

Validate Your Feed

Test your feed with the built-in validator or external ACP validation tools to identify any issues before submission.

3

Submit to OpenAI

Visit the OpenAI Merchant Portal and submit your JSON feed URL for review.

4

Await Approval

OpenAI will crawl and verify your feed. Approval typically takes 3-7 business days. Monitor your email for updates.

Feed Validation

The module includes a built-in validator accessible from the configuration panel. Run validation to check for:

  • Missing required fields - Products without title, price, or image
  • Invalid URLs - Broken product or image links
  • Price issues - Zero or negative prices
  • Image quality - Images below minimum size (500x500px)
  • Description length - Descriptions that are too short or too long
Validation Passed?
If your feed passes validation with zero critical errors, you're ready to submit to ChatGPT Shopping!

Google Merchant Center Compatibility

Use the XML feed format for traditional Google Merchant Center campaigns and Shopping Ads.

Setting Up Google Merchant Center

1

Create Merchant Account

Sign up for Google Merchant Center and verify your website ownership.

2

Add Product Feed

In Merchant Center, go to Products → Feeds → Add Feed. Choose "Scheduled fetch" and enter your XML feed URL.

https://yoursite.com/modules/aimerchantpro/feed.php?format=xml
3

Set Fetch Schedule

Configure Google to fetch your feed daily (recommended) or weekly. Most stores update daily to keep inventory in sync.

4

Review Products

After the first fetch, review product status in Merchant Center. Fix any disapprovals before launching Shopping campaigns.

Required Product Data

The module automatically includes these Google-required fields:

Field PrestaShop Source Required
id Product ID Yes
title Product name Yes
description Product description Yes
link Product URL Yes
image_link Cover image URL Yes
price Product price (with tax) Yes
availability Stock status Yes
brand Manufacturer name Recommended
gtin EAN13 or UPC Recommended

Common Google Merchant Issues

Missing GTIN (EAN/UPC)

Google requires unique product identifiers. In PrestaShop:

  1. Edit the product in your catalog
  2. Go to Options tab
  3. Enter the EAN-13, UPC, or ISBN code
  4. Save and regenerate your feed
Price Mismatch

Feed price must exactly match the price on your product page:

  • Clear PrestaShop cache after price changes
  • Ensure tax calculation is correct
  • Check for dynamic pricing plugins that might affect display
  • Regenerate feed and verify the XML output
Image Quality Issues

Google requires high-quality images (minimum 100x100, recommended 800x800):

  • Upload larger product images
  • Set image size to "large" in module settings
  • Avoid watermarks or promotional text on images
  • Use white or neutral backgrounds

Testing & Validation

Before submitting your feeds to ChatGPT or Google, thoroughly test them to ensure product data quality and compliance.

Built-in Feed Validator

The module includes a validator accessible from the configuration panel. Click "Validate Feed" to scan your catalog for issues.

Critical Must fix

Products will be rejected if these issues exist:

  • Missing product title or description
  • No product URL or broken links
  • Price is zero, negative, or missing
  • No product images
  • Invalid image URLs (404 errors)
Warning Should fix

These may cause reduced visibility:

  • Description too short (<50 characters)
  • Missing manufacturer/brand
  • No GTIN/EAN code
  • Images below 500x500 pixels
  • Missing category assignments
Info Optimize

Recommendations to improve performance:

  • Add more product images (2-5 recommended)
  • Include product features and specifications
  • Add customer reviews if available
  • Use all product attribute fields

External Testing Tools

Use these tools to validate your feeds before submission:

  • Google Merchant Center Feed Tester - Test XML feeds for Google Shopping compliance
  • ACP Validator - Validate JSON feeds against ChatGPT Shopping requirements
  • Feed Viewer - View your feed in a browser to check formatting
Testing Workflow
  1. Run built-in validator first to catch obvious issues
  2. Fix all critical errors and most warnings
  3. Test with external tools for platform-specific validation
  4. Submit to platform and monitor approval status

Best Practices

Follow these recommendations to maximize product visibility and approval rates on AI shopping platforms.

Product Optimization

High-Quality Images

Use 800x800+ images with white backgrounds. Include multiple angles. Avoid text overlays or watermarks.

Descriptive Titles

Include brand, product type, key features. Keep under 150 characters. Be specific and accurate.

Detailed Descriptions

Write 150-500 character descriptions. Focus on benefits and use cases. Avoid keyword stuffing.

Complete Attributes

Fill in all product attributes (size, color, material). Add EAN/UPC codes. Include manufacturer name.

Feed Maintenance

  • Set up automated feed generation - Configure cron jobs to regenerate feeds daily
  • Monitor feed health - Check validator results weekly for new issues
  • Keep products updated - Remove discontinued items, update prices regularly
  • Test after changes - Validate feed after major catalog updates or module configuration changes

Performance Tips

For large catalogs (5000+ products):
  • Enable caching with 6-12 hour TTL
  • Reduce batch size to 250-500 products
  • Run feed generation during off-peak hours
  • Consider excluding low-value or inactive products

Troubleshooting

Feed URL returns blank page or error

Solution: Check module installation and PHP errors.

  1. Verify module is installed and enabled
  2. Check PHP error logs for fatal errors
  3. Increase PHP memory_limit to 512MB
  4. Increase max_execution_time to 300 seconds
  5. Enable debug mode in module settings
Some products missing from feed

Products may be excluded if they:

  • Are inactive or not published
  • Have zero quantity (if "exclude out of stock" is enabled)
  • Belong to excluded categories
  • Have no price set
  • Have no images assigned

Check product settings and module filter configuration.

Feed generation is very slow

For large catalogs:

  1. Enable feed caching in module settings
  2. Reduce batch size to 250-500
  3. Increase PHP memory_limit and max_execution_time
  4. Use cron-based generation instead of on-demand
  5. Enable OPcache and object caching (Redis/Memcached)
Images not appearing in feed

Check the following:

  • Products have cover images assigned
  • Image files exist in /img/p/ directory
  • Your site uses HTTPS (required for feeds)
  • Image URLs are publicly accessible (not protected)
  • .htaccess allows image access
Currency or language issues

For multi-language/multi-currency stores:

  • Generate separate feeds per language: ?lang=en, ?lang=fr
  • Generate separate feeds per currency: ?currency=EUR, ?currency=USD
  • Verify language and currency codes are correct in PrestaShop
  • Check that products have translations for all languages
Still Need Help?

Enable Debug Mode in module advanced settings to log detailed feed generation information to PrestaShop logs.

Frequently Asked Questions

How often should I regenerate my feed?

For most stores, daily regeneration is sufficient. If you have frequent inventory changes, set up cron jobs to regenerate every 4-6 hours. Google typically crawls feeds once daily.

Can I use this with PrestaShop 1.6?

This module requires PrestaShop 1.7.x or 8.x. For PrestaShop 1.6, contact support about legacy version availability.

Does it work with multi-store setups?

Yes! Enable multi-shop mode in advanced settings and generate separate feeds per shop using the shop_id parameter:

  • ?format=json&shop_id=1
  • ?format=json&shop_id=2
How do I set up automated feed generation?

Set up a cron job on your server:

0 2 * * * curl -s "https://yoursite.com/modules/aimerchantpro/cron.php?token=YOUR_SECRET_KEY"

This regenerates feeds daily at 2 AM. Find your secret key in module advanced settings.

Can I exclude specific products from feeds?

Yes, two methods:

  1. Category exclusion: In module settings, exclude entire categories from feeds
  2. Product-level: Mark specific products as inactive or move them to an excluded category
Is my product data sent to external servers?

Your product data stays on your server. The module only communicates externally for license verification. Feed URLs are public by design since Google and ChatGPT need to crawl them.

Support & Updates

Get help and stay updated with the latest module improvements.

Documentation

Access complete guides, tutorials, and best practices on our documentation portal.

Email Support

Contact our support team for technical assistance and configuration help.

Automatic Updates

Module updates are delivered automatically through PrestaShop's module manager.

Knowledge Base

Search our knowledge base for answers to common questions and troubleshooting guides.

Need Help?

Can't find what you're looking for? Contact our support team:

  • Email: support@aimerchantpro.com
  • Response Time: Within 24 hours (business days)
  • Include: PrestaShop version, module version, and detailed description of the issue

Module Updates

The module checks for updates automatically. When an update is available:

  1. You'll see a notification in PrestaShop module manager
  2. Click "Upgrade" to install the latest version
  3. Your configuration settings are preserved during updates
  4. Feeds continue to work without interruption
Stay Informed
Subscribe to our newsletter for update notifications, new feature announcements, and PrestaShop e-commerce tips.

Need Help?

Can't find what you're looking for? Our support team is here to help.