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_idtitle→ Nombre del productodescription→ Descripción sin HTMLlink→ URL canónicaimage_link→ Imagen principalprice→ Precio + divisa (ej. 79.99 USD)availability→ in_stock / out_of_stock / preorderinventory_quantity→ Cantidad en stockenable_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",304. 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_pricedebe ser menor o igual quepricey requieresale_price_effective_date.- Si
availability = preorder, debe definirseavailability_dateen 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_producttitle→ ps_product_lang.namedescription→ ps_product_lang.descriptionlink→ ps_product_lang.link_rewriteimage_link→ ps_image.id_image (combinado con URL base)availability→ ps_stock_available.quantitybrand→ 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→ SKUtitle→ namedescription→ descriptionlink→ getProductUrl()image_link→ media/catalog/product + imageavailability→ stock (MSI)brand→ atributo personalizadoproduct_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.





