Llegó catálogo: conoce cómo adaptar tu integración

Ahora, los vendedores pueden competir por el primer lugar de los resultados de búsqueda. Para eso, deben crear sus publicaciones de catálogo.
Participar es gratis y el vendedor que ofrece las mejores condiciones de venta, como precio y forma de envío, ganará.

¿Dónde encuentran los compradores esta publicación?

Encontrarán la publicación ganadora en este lugar, y una vez que ingresen a la publicación, verán toda la oferta que existe del producto reunida en la Página de producto. Ahí agrupamos todas las publicaciones de catálogo relacionadas al mismo producto. Por ejemplo, los distintos colores y capacidades que existen en el mercado para un modelo de celular.
Conoce más detalles sobre catálogo.

Contenidos

Publicaciones elegibles para catálogo
Ítem de Catálogo
¿Cómo puedo ver la relación entre ambas publicaciones?
¿Cómo reconozco cada publicación?
¿Cómo se gestionan las preguntas de las publicaciones de catálogo?

Publicaciones elegibles para catálogo

Los vendedores podrán ver en el sitio qué publicaciones son elegibles y relacionarlas con un producto de nuestro catálogo.
Nota: Por el momento, solo podrán participar algunos celulares que tengan sus publicaciones productizadas. Conoce más detalles sobre ítems productizados.
Además, en primera instancia, solo se podrán crear publicaciones de catálogo a través del sitio. Estamos trabajando para que lo puedan hacer vía API.

Una vez que el vendedor relaciona su publicación elegible con un producto de catálogo, se crea su publicación de catálogo. Esto quiere decir que se duplica automáticamente el ítem, pero con un ID propio y único.
Al crearse el nuevo ítem de catálogo, recibirás notificaciones tanto de creación como de modificación, de la manera que ya conoces.


Ejemplo acotado de ítem original o “de marketplace”:

Llamada:

GET https://api.mercadolibre.com/items/items/<item_id>?access_token=<access_token> 

Ejemplo:

 GET https://api.mercadolibre.com/items/MLA784477582?access_token=access_token

Respuesta:

{
"variations": [
  {
"id": 36296213011,
"price": 50.00,
"attribute_combinations": [
  {
"id": "COLOR",
"name": "Color",
"value_id": "52014",
"value_name": "Verde",

},
  {
"id": "SIZE",
"name": "Talle",
"value_id": null,
"value_name": "8 litros",
}
],
"available_quantity": 2,
"sold_quantity": 0,
"sale_terms": [],
"picture_ids": [
  "937728-MLB26910896929_1111111",
  "911601-MLB26910896930_1111111",
  "762115-MLB26910896931_1111111",
  "827037-MLB26910896928_1111111"
],
"seller_custom_field": null,
"catalog_product_id": null,
"attributes": [
  {
"id": "T_SHIRT_SIZE",
"name": "Talle de la remera",
"value_id": "5727532",
"value_name": "6XL",
}
],

"item_relations": [
  {
"id": "MLA784479661",
"variation_id": null,
"stock_relation": 1
}
],
}
]

"catalog_listing": false,
"item_relations": [],
}


Ejemplo acotado de ítem de Catálogo:

Llamada:

 GET https://api.mercadolibre.com/items/<item_id>?access_token=access_token

Ejemplo:

GET https://api.mercadolibre.com/items/MLA784479661?access_token=access_token

Respuesta

{
"variations": [],
"catalog_listing": true,
"item_relations": [
  {
"id": "MLA784477582",
"variation_id": 36296213006,
"stock_relation": 1
}
],
}

 

¿Cómo puedo ver la relación entre ambas publicaciones?

Para conocer la relación, podrás consultar el campo item_relations en el recurso /items realizando la llamada con access token.
El único dato que estará compartido en ambas publicaciones será el stock. Por eso, cuando el vendedor reciba una venta o modifique la cantidad en una publicación, se modificará en ambas automáticamente.

¿Cómo reconozco cada publicación?

Para entender cuál es la publicación de catálogo y cuál la original (o de Marketplace) sumamos un campo al recurso /ítems denominado “catalog_listing”. Si este tiene valor “true”, es una publicación de Catálogo. Si tiene valor “false” es el ítem originial. Recuerda siempre utilizar el access token para tener la información completa del ítem.
Algunos datos sobre el ítem de catálogo...

  • Se podrán modificar las condiciones de venta como el precio, la forma de envío y la condición. A su vez, estas pueden ser distintas a las de la publicación original.

  • No se podrán modificar las imágenes, los títulos, las descripciones y las fichas técnicas dado que son datos normalizados por Mercado Libre. Tampoco la condición del producto.

  • Los ítems de catálogo no tendrán variantes. De todas formas, como en la Página de producto se agruparán distintas publicaciones de catálogo, el comprador verá las distintas opciones del producto, como colores y capacidades, de todos los vendedores ganadores.

Algunos datos sobre el ítem original o “de Marketplace”

  • Será el ítem original.

  • Tendrá el ID del ítem de Catálogo dentro de la variación correspondiente.

Importante: Si eliminas o pausas una variante de un ítem de marketplace relacionada a un ítem de catálogo, la relación entre las publicaciones se perderá, pero no se desactivará el ítem de catálogo. Si eliminas el ítem de catálogo, el de marketplace seguirá activo.

¿Cómo se gestionan las preguntas de las publicaciones de catálogo?

Cuando se realiza una pregunta en la Página de producto, la consulta queda asociada al vendedor que está ganando en ese momento.
Si el vendedor cambia porque hay un nuevo ganador, el comprador seguirá hablando con quien habló inicialmente.
Las preguntas de catálogo se gestionarán igual que las de los ítems de marketplace.

Forma parte de nuestra comunidad