Feeds de productos para ChatGPT: revisión y adaptación del catálogo

Guía para adaptar un catálogo de e-commerce al Product Feed Spec de OpenAI Commerce y habilitar productos en ChatGPT.

Ejemplos históricos y contrato vigente

Revisión del 31 de octubre de 2026. Conservo el código, CSV y mapeos originales como ejemplos del proceso de transformación. Sus campos no deben usarse como contrato vigente sin adaptación. La aceptación y la disponibilidad comercial dependen del programa y de la especificación aplicable.

De tu catálogo a un feed de productos: revisión, mapeo y validación

En esta guía explico cómo revisar y transformar los datos de una tienda antes de una integración de catálogo. Los ejemplos originales sirven para entender el proceso; no sustituyen el contrato vigente de OpenAI ni demuestran que un feed haya sido aceptado.

Antes de preparar una entrega, comprueba la disponibilidad, los requisitos y el proceso de incorporación en la documentación oficial de Commerce. Solicitar acceso no equivale a tener una integración aprobada ni garantiza ventas o aparición de productos.

1. Auditoría inicial de tu catálogo

Antes de exportar cualquier información, realiza una revisión exhaustiva de tu catálogo o ERP para conocer qué campos tienes disponibles y cuáles te faltan. Esto te permitirá anticiparte a errores comunes en la integración.

El feed es una pieza de la presencia de tu tienda. Para revisar cómo se presentan y documentan tus productos y contenidos, puedes consultar el servicio de SEO para IA aplicado a la visibilidad de tu negocio. Los requisitos de cada integración deben comprobarse en la documentación vigente de la plataforma.

  • ID único o SKU
  • Nombre del producto
  • Descripción (sin HTML)
  • URL del producto (PDP)
  • Precio y divisa
  • Stock disponible
  • Marca y categoría
  • Imágenes
  • Variantes (color, talla, etc.)
  • Políticas de devolución (si usarás checkout)

👉 Haz especial hincapié en este paso: una auditoría bien hecha evita pérdidas de tiempo en fases posteriores.

2. Mapeo de campos (source → spec)

El mapeo depende de la versión del contrato que vaya a recibir el feed. El inventario siguiente corresponde al ejemplo histórico del artículo. Contrástalo con la especificación vigente de carga de productos antes de usarlo.

Campos del ejemplo original, pendientes de adaptación al contrato actual:

  • id → SKU o product_id
  • title → Nombre del producto
  • description → Descripción sin HTML
  • link → URL canónica
  • image_link → Imagen principal
  • price → Precio + divisa (ej. 79.99 USD)
  • availability → in_stock / out_of_stock / preorder
  • inventory_quantity → Cantidad en stock
  • enable_search, enable_checkout

Otros campos del ejemplo:

  • brand, product_category, weight

Las políticas del vendedor, devoluciones y condiciones de checkout dependen del programa y de su versión. Comprueba los requisitos aplicables antes de habilitar esas funciones.


3. Ejemplo histórico de transformación a CSV

enable_search,enable_checkout,id,title,description,link,image_link,price,availability,inventory_quantity,brand,product_category,weight,seller_name,seller_url,return_policy,return_window
true,false,SKU12345,"Men's Trail Running Shoes Black","Waterproof trail shoe with cushioned sole","https://example.com/product/SKU12345","https://example.com/images/skሴ5.jpg","79.99 USD",in_stock,25,OpenAI,"Apparel & Accessories > Shoes","1.5 lb","Example Store","https://example.com/store","https://example.com/returns",30

4. Ejemplo histórico de transformación a JSON

{
  "enable_search": "true",
  "enable_checkout": "false",
  "id": "SKU12345",
  "title": "Men's Trail Running Shoes Black",
  "description": "Waterproof trail shoe with cushioned sole",
  "link": "https://example.com/product/SKU12345",
  "image_link": "https://example.com/images/skሴ5.jpg",
  "price": "79.99 USD",
  "availability": "in_stock",
  "inventory_quantity": 25,
  "brand": "OpenAI",
  "product_category": "Apparel & Accessories > Shoes",
  "weight": "1.5 lb"
}

5. Comprobaciones que debes adaptar a la especificación

  • sale_price debe ser menor o igual que price y requiere sale_price_effective_date.
  • Si availability = preorder, debe definirse availability_date en el futuro.
  • Las variantes deben compartir item_group_id.
  • Todas las URLs deben devolver un código HTTP 200.
  • La frecuencia de entrega debe respetar los mecanismos y límites documentados y la necesidad real de actualizar precio o stock.

Estas comprobaciones locales detectan problemas de datos. La aceptación debe confirmarse con el validador, contrato y proceso del receptor; un archivo que parsea correctamente puede incumplirlos.

6. Script de transformación en Python

Ejemplo original de transformación a CSV y JSONL. Antes de ejecutarlo en producción, adapta los campos, tipos y enumeraciones a la versión acordada y pruébalo con una muestra.

import csv, json, html, re

with open("catalogo.csv", newline="", encoding="utf-8") as f:
    reader = csv.DictReader(f)
    feed = []
    for row in reader:
        item = {
            "enable_search": "true",
            "enable_checkout": "false",
            "id": row["sku"],
            "title": row["title"],
            "description": html.unescape(re.sub("<[^>]*>", "", row["description"])),
            "link": row["url"],
            "image_link": row["image"],
            "price": f"{row['price']} USD",
            "availability": "in_stock" if int(row["stock"]) > 0 else "out_of_stock",
            "inventory_quantity": int(row["stock"]),
            "brand": row.get("brand", ""),
            "product_category": row.get("category", ""),
            "weight": row.get("weight", "0.5 kg")
        }
        feed.append(item)

with open("openai_feed.jsonl", "w", encoding="utf-8") as out:
    for item in feed:
        out.write(json.dumps(item) + "\n")

7. Exportar el feed desde PrestaShop

En PrestaShop, el catálogo se reparte entre productos, idiomas, stock, imágenes y marcas. La consulta siguiente ilustra una extracción parcial; no genera por sí sola URLs finales, variantes y campos válidos para una integración actual.

Mapeo de campos clave

  • id → ps_product.id_product
  • title → ps_product_lang.name
  • description → ps_product_lang.description
  • link → ps_product_lang.link_rewrite
  • image_link → ps_image.id_image (combinado con URL base)
  • availability → ps_stock_available.quantity
  • brand → ps_manufacturer.name

Ejemplo en SQL

sql
SELECT p.id_product AS id,
pl.name AS title,
pl.description AS description,
CONCAT('https://tu-dominio.com/', pl.link_rewrite, '.html') AS link,
CONCAT('https://tu-dominio.com/img/p/', i.id_image, '-large_default.jpg') AS image_link,
FORMAT(p.price, 2) AS price_raw,
IF(s.quantity > 0, 'in_stock', 'out_of_stock') AS availability,
s.quantity AS inventory_quantity,
m.name AS brand
FROM ps_product p
JOIN ps_product_lang pl ON p.id_product=pl.id_product AND pl.id_lang=1
LEFT JOIN ps_stock_available s ON s.id_product=p.id_product
LEFT JOIN ps_manufacturer m ON m.id_manufacturer=p.id_manufacturer
LEFT JOIN ps_image i ON i.id_product=p.id_product AND i.cover=1
WHERE p.active=1;

8. Exportar el feed desde Magento 2

En Magento 2 (Adobe Commerce), lo más recomendable es usar el stack nativo de Magento en lugar de SQL crudo, ya que trabaja con un modelo EAV.

Mapeo de campos clave

  • id → SKU
  • title → name
  • description → description
  • link → getProductUrl()
  • image_link → media/catalog/product + image
  • availability → stock (MSI)
  • brand → atributo personalizado
  • product_category → nombres de categorías

Ejemplo en PHP

use Magento\Framework\App\Bootstrap;
require __DIR__ . '/app/bootstrap.php';
$params = $_SERVER;
$bootstrap = Bootstrap::create(BP, $params);
$obj = $bootstrap->getObjectManager();
$state = $obj->get('Magento\Framework\App\State'); 
$state->setAreaCode('frontend');

$productCollection = $obj->create('Magento\Catalog\Model\ResourceModel\Product\CollectionFactory')->create();
$productCollection->addAttributeToSelect(['sku','name','description','price','brand','weight','image']);

$fp = fopen(__DIR__.'/openai_feed.csv','w');
fputcsv($fp,['enable_search','enable_checkout','id','title','description','link','image_link','price','availability','inventory_quantity','brand','product_category','weight']);

foreach($productCollection as $p){
  $sku = $p->getSku();
  $name = $p->getName();
  $desc = strip_tags($p->getDescription());
  $url = $p->getProductUrl();
  $img = $baseUrl.'media/catalog/product'.$p->getImage();
  $price = number_format((float)$p->getPrice(),2,'.','').' EUR';
  ...
}

9. Validación final del feed

Primero valida estructura, tipos y datos con una muestra. El script siguiente conserva una comprobación local del ejemplo histórico; no sustituye el esquema ni el validador oficial del receptor.

import csv, sys
req = {'id','title','description','link','image_link','price','availability','inventory_quantity'}
with open('openai_feed.csv', newline='', encoding='utf-8') as f:
  r = csv.DictReader(f)
  for i,row in enumerate(r, start=2):
    missing = [k for k in req if not row.get(k)]
    if missing:
      print(f'Fila {i}: faltan campos {missing}')
      sys.exit(1)
print('Feed OK')

10. Buenas prácticas para tu feed

  • Usa IDs estables (evita cambiar SKUs una vez lanzado).
  • Limpia las descripciones de HTML y elimina tags innecesarios.
  • Incluye divisa en el precio y unidades en medidas.
  • Automatiza las actualizaciones según los cambios de stock y precio y los límites de la integración. Registra fallos, reintentos y fecha de la última entrega aceptada.
  • Prueba primero con un feed de muestra reducido antes de exportar el catálogo completo.

Estas buenas prácticas mejoran la calidad, fiabilidad y velocidad de integración.

Conclusiones finales

El trabajo consiste en conocer los datos de origen, contrastar el contrato de destino y documentar qué se transforma, qué se pierde y qué hay que completar.

Auditar → Mapear → Normalizar → Validar → Exportar → Refrescar.

Antes de ampliar al catálogo completo, valida una muestra y comprueba la aceptación real. La calidad del feed es una condición técnica de la integración; no garantiza visibilidad ni ventas.

Antes de entregar el catálogo

Confirma el programa y la versión de la especificación, revisa campos y enumeraciones, genera una muestra y registra los errores devueltos por el receptor.

Si necesitas ayuda, puedo revisar la calidad de los datos y el proceso de transformación. El alcance dependerá de tu plataforma y de los requisitos de la integración.

Conserva un registro de entregas aceptadas y comprueba que precio, disponibilidad y variantes siguen correspondiéndose con la tienda.

Yago Vázquez Gómez

Sobre el autor

Consultor SEO técnico. Trabajo con arquitectura web, SEO local, datos y automatización para investigar problemas de visibilidad y definir mejoras comprobables.

Fundador de Syvat Sistemas. En YaggoSEO comparto guías y estudios sobre SEO, entidades y sistemas con IA, con sus observaciones y límites.

Comprueba cómo se accede a tu contenido.

Reviso acceso, identidad y fuentes y preparo una muestra de respuestas cuando forma parte del alcance. Cada propuesta debe indicar qué mejora y cómo podemos comprobarla.

Sigue investigando.