| Identidad y variantes |
|---|
item_idObligatorio · único y estableidObligatorio · ≤ 50 caracteresID del ítem | Catálogo | products.id + products.variants.idUna fila por variante visible: <id de producto>-<id de variante> de Tiendanube. Estable entre syncs y sin : (Google lo usa de separador). | 100 %100 % |
group_idCondicional · + listing_has_variationsitem_group_idCondicional · + item_group_titleGrupo de variantes | Catálogo | products.id · products.nameSólo si el producto tiene más de una variante visible: el id de producto agrupa a sus variantes (distinto del id de cada fila). | 82 %82 % |
variant_dictCondicionalvariant_optionOpcional · ≤ 30 pares nombre:valorOpciones de la variante | Catálogo | products.variants.optionsLas opciones de Tiendanube tal cual (Color: Hueso, Talle: 36). | 82 %82 % |
gtinOpcional · 8, 12, 13 o 14 dígitosgtinRecomendado · GS1 válidoGTIN (código de barras) | Falta | products.variants.barcode (no sincronizado)Se mandaría tal cual, validando el dígito verificador.Para llenarlo: Tiendanube guarda un código de barras por variante: sumarlo al sync (variants.barcode) y que el merchant lo cargue. Sin GTIN, Google pide mpn + brand. | 0 %0 % |
mpnOpcionalmpnCondicional · si no hay GTIN · ≤ 70MPN | Catálogo | products.variants.skuEl SKU de la variante. Es un MPN legítimo cuando la marca es la propia tienda (fabricante); para un revendedor hace falta el GTIN. | 93 %93 % |
| Contenido |
|---|
titleObligatorio · ≤ 150 caracterestitleObligatorio · ≤ 150 caracteresTítulo | Catálogo | products.name + variants.optionsEl nombre sin mayúsculas gritadas y, si hay variantes, las opciones de esta (Sábana 2 plazas - Hueso / 36). Cortado en ≤ 150 por palabra. | 100 %100 % |
descriptionObligatorio · ≤ 5.000, texto planodescriptionObligatorio · ≤ 5.000, texto planoDescripción | IA | content.products[id].answerLa respuesta corta de la PDP (≤ 150 palabras), escrita por IA sobre la ficha del merchant y validada; texto plano. Si no hay, la descripción de Tiendanube sin HTML. | 100 %100 % |
brandObligatorio · una marca realbrandObligatorio · ≤ 70 caracteresMarca | Catálogo | products.brand → stores.nameLa marca de Tiendanube; si está vacía o es un placeholder (SI, N/A), el nombre de la tienda: casi todas venden marca propia. | 100 %100 % |
conditionOpcionalconditionOpcional · obligatorio sólo si es usadoCondición | Derivado | políticaSiempre new: las 14 tiendas venden productos nuevos. | 100 %100 % |
product_categoryOpcional · ruta con >google_product_categoryOpcional · id de la taxonomíaCategoría (taxonomía de Google) | Derivado | departamento + products.categories + products.nameReglas por rubro sobre el nombre y las categorías del merchant → un nodo de la taxonomía de Google (2021-09-21). Google recibe el id; OpenAI, la ruta en inglés. | 100 %100 % |
product_typeOpcional · ≤ 750 caracteresTipo de producto (del merchant) | Catálogo | products.categoriesLas categorías del merchant que describen el producto (sin promociones ni «Todos los productos»), unidas con >. | No existe en esta spec97 % |
materialOpcionalmaterialOpcional · ≤ 200 caracteresMaterial | IA | content.products[id].attributes (Material, Composición, Tejido)El atributo que la IA extrajo de la ficha del merchant (nunca inventado: si la ficha no lo dice, no hay atributo). | 71 %71 % |
colorOpcionalcolorCondicional · en indumentariaColor | Catálogo | products.variants.options[Color]La opción Color de la variante. | 60 %60 % |
sizeOpcionalsizeCondicional · en indumentaria · ≤ 100Talle | Catálogo | products.variants.options[Talle|Número|Tamaño|Medida|Plazaje]La opción de talle o medida de la variante. | 74 %74 % |
genderOpcionalgenderCondicional · en indumentariaGénero | Derivado | products.categories + products.nameSólo en indumentaria: male/female/unisex cuando el merchant lo dice en una categoría o en el nombre (Hombre, Mujer, Unisex); si no, no se manda. | 15 %15 % |
adultCondicional · obligatorio si es +18Contenido para adultos | Derivado | departamentoyes para el rubro Lencería y juguetes (+18). En OpenAI esos productos van con is_eligible_search: false: su política no los admite. | No existe en esta spec6,3 % |
product_detailOpcional · ≤ 100 · conversacionalCaracterísticas | IA | content.products[id].attributesLos atributos que la IA extrajo de la ficha (material, medidas, cuidados…), como Características:Nombre:Valor. | No existe en esta spec100 % |
question_and_answerOpcional · ≤ 30 · conversacionalPreguntas y respuestas | IA | content.products[id].faqLas 3–5 preguntas frecuentes de la PDP, respondidas con la ficha del merchant. | No existe en esta spec100 % |
dimensions + weightOpcionalproduct_weight + product_length…OpcionalMedidas y peso | Falta | products.variants.{weight,width,height,depth} (no sincronizado)Se mandarían como dimensions + weight (OpenAI) y product_length/width/height/weight (Google).Para llenarlo: Tiendanube guarda peso y medidas por variante para cotizar envíos: sumarlos al sync. | 0 %0 % |
| Links e imágenes |
|---|
urlObligatorio · https, públicalinkObligatorio · en el dominio reclamadoLink al producto | Derivado | stores.slug + products.handleLa PDP de Agentplace (agentplace.crossup.ai/<tienda>/<handle>): el dominio que reclamamos nosotros. En el feed de cada tienda (CrossUp) va la PDP del merchant en Tiendanube (canonicalUrl). | 100 %100 % |
image_urlObligatorio · JPEG o PNGimage_linkObligatorio · ≥ 500 × 500 pxImagen principal | Catálogo | products.variants.imageUrl → products.images[0]La foto de la variante o, si no tiene, la primera del producto, en el CDN de Tiendanube (1024 × 1024). | 93 %100 % |
additional_image_urlsOpcionaladditional_image_linkOpcional · hasta 10Imágenes adicionales | Catálogo | products.images[1…]El resto de la galería, sin repetir la principal, hasta 10. | 94 %94 % |
| Tienda, envíos y devoluciones |
|---|
seller_name + seller_urlObligatorioVendedor | Tienda | stores.name · stores.storeUrlLa tienda que vende y despacha, con su sitio. Agentplace no vende: la compra es en la tienda. | 100 %No existe en esta spec |
is_eligible_searchOpcional · default trueElegible para búsqueda | Derivado | política + departamentotrue: queremos que ChatGPT lo muestre. false para +18, que la política de OpenAI no admite. | 100 %No existe en esta spec |
is_eligible_checkoutCondicional · pide privacidad + TyCCheckout en ChatGPT | Derivado | políticafalse: la compra, el pago y el envío son de cada tienda (ChatGPT manda al link). Activarlo pide ACP y las políticas de abajo. | 100 %No existe en esta spec |
seller_privacy_policy + seller_tosCondicionalPrivacidad y términos de la tienda | Falta | páginas de la tienda (no sincronizadas)Las URLs de política de privacidad y términos de cada tienda.Para llenarlo: Sólo hacen falta para checkout dentro de ChatGPT. Tiendanube no las expone por API: se piden en el onboarding. | 0 %No existe en esta spec |
shipping_priceOpcionalshippingOpcional · no obligatorio en AREnvío | Catálogo | products.freeShippingSi el producto tiene envío gratis: costo 0 a Argentina. Si no, se omite (OpenAI lo lee como desconocido, no gratis).Para llenarlo: Las tarifas de envío de la tienda: Tiendanube las cotiza por código postal en el checkout. Con una tabla por zona del merchant se llena para todos. | 0,7 %0,7 % |
accepts_returns + return_deadline_in_daysOpcionalDevoluciones | Derivado | Ley 24.240, art. 34Toda compra a distancia en Argentina se puede revocar en 10 días corridos: es el piso legal. Si la tienda ofrece más, se toma de su política.Para llenarlo: La URL de la política de cambios y devoluciones de cada tienda (return_policy), que se pide en el onboarding. | 100 %No existe en esta spec |
review_count + star_ratingOpcionalproduct ratings (programa aparte)OpcionalReseñas | Falta | —Cantidad de reseñas y promedio de estrellas del producto.Para llenarlo: Una fuente real de reseñas (la app de reseñas de cada tienda). Nunca se inventan. | 0 %0 % |
store_country + target_countriesOpcional · requiere habilitar el mercadoPaís de la tienda | Tienda | stores.countryAR. OpenAI pide configurar el mercado: la carga estándar hoy es sólo para Estados Unidos. | 100 %No existe en esta spec |