Conoce cómo adaptar tu desarrollo a catálogo

Ahora los vendedores pueden crear vía API publicaciones de catálogo a partir de sus publicaciones actuales, o de forma directa sin contar con una publicación para asociar y así competir para ganar la exposición en la página de producto, las cuales estarán posicionadas en los primeros lugares de los resultados de búsqueda.

Antes de empezar, no olvides leer la documentación de "Dominios y Productos", te ayudará a tener los items con la información correcta.

¡Empieza a preparar tu desarrollo siguiendo esta guía!


¿Cómo funciona catálogo?

Tradicionalmente en Mercado Libre las publicaciones fueron creadas exclusivamente por los vendedores y eran éstos quienes debían proveer la descripción de qué están vendiendo (títulos, fotos y descripciones) así como las condiciones de venta (precio, envío, financiación, etc.).

A partir de ahora, además de esta forma tradicional de publicar, es posible crear publicaciones de catálogo donde Mercado Libre provee el contenido de la publicación (títulos, fotos, descripciones y ficha técnica) y distintos vendedores crean publicaciones que se venden a través de una página de producto unificada en la cual las ventas son dirigidas hacia el o los vendedores que den las mejores condiciones de venta y experiencia a los compradores.


¿Dónde encuentran los compradores las publicaciones de catálogo?

Al momento de realizar la búsqueda, los compradores verán en los primeros lugares del listado los productos de catálogo. Al ingresar a ver un producto, el vendedor que ofrezca las mejores condiciones de venta y precio obtendrá la posibilidad de vender ese producto. En la página de producto además habrá un link para conocer la lista completa de todos los vendedores que ofrecen ese mismo producto y destacaremos a quienes ofrezcan el producto en otras condiciones de venta relevantes para el comprador (por ejemplo: “con envio gratis” o “en el día”).
A diferencia de las publicaciones tradicionales que tienen su propia fila en los listados, las publicaciones de catálogo no tienen una fila exclusiva en los listados sino que obtienen sus visitas y ventas a través de las filas destinadas a productos de catálogo, los cuales aparecen al principio del listado.
Conoce más detalles sobre catálogo.


En resumen:

  • Hasta ahora los vendedores siempre debían crear y mantener las publicaciones generando su contenido y estableciendo sus condiciones de venta.
  • A partir de ahora, además de la forma tradicional de publicar es posible publicar en catálogo a través de un producto creado y mantenido por Mercado Libre.
  • Los vendedores obtienen las ventas de los productos compitiendo con otros vendedores que buscan dar las mejores condiciones de compra y experiencia.
  • Los productos aparecerán en las primeras posiciones de las búsquedas y recomendaciones del sitio.
  • Según el país y el dominio donde se publique, catálogo tiene beneficios en los cargos por venta de hasta el 23%.

 

Contenidos

→Cómo publicar en catálogo
    ↳Publicar directamente en catálogo vs. a partir de una publicación existente
      ↳¿Cuáles son las diferencias?
      ↳¿Qué ocurre si modifico, pauso o elimino mi publicación de catálogo enlazada con una tradicional?
      ↳ ¿Hay algo más que saber acerca de la administración de las publicaciones de catálogo?
      ↳¿Es posible publicar cualquier ítem en catálogo?
      ↳¿Qué pasa si por error asocio un ítem a un producto equivocado?
    ↳Pasos para publicar en catálogo a partir de una publicación existente
    ↳Pasos para publicar en catálogo en forma directa sin una publicación enlazada
→Verificar que una publicación es elegible para catálogo
    ↳Elegibilidad de una publicación existente sin catalog_product_id asociado
   ↳Elegibilidad de una publicación existente con catalog_product_id asociado
      ↳Consideraciones
      ↳Descripción de campos
    ↳Filtrado de ítems por vendedor
→Determinar el producto exacto a vender
      ↳Productos parent y children
      ↳Eligiendo el producto específico para mi publicación
→Publicar en catálogo a partir de una publicación existente
→Publicación directa en catálogo: buscador de productos
→Crear la publicación de catálogo en forma directa
→Compitiendo para ganar las ventas
      ↳Cómo conocer el precio para ganar [BETA]
      ↳Cómo conocer el listado de publicaciones para un Producto [BETA]
→Más sobre las publicaciones de catálogo
      ↳Cómo reconocer la publicación de catálogo y la original
      ↳Cómo conocer la relación entre publicaciones enlazadas
      ↳Cómo gestionar las preguntas de las publicaciones de catálogo
      ↳Cómo gestionar las orders, visitas, etc.
      ↳Cómo gestionar las ventas de las publicaciones de catálogo
      ↳Ciclo de vida de las publicaciones enlazadas
      ↳Qué se puede modificar sobre una publicación de catálogo



Existen dos formas de crear publicaciones de catálogo:

  • Creando una publicación de catálogo a partir de una publicación tradicional.
  • Publicando directamente en catálogo.

 

¿Cuáles son las diferencias?

Las publicaciones de catálogo que son creadas a partir de una publicación tradicional comparten stock con esa publicación. Es decir que si a través del ítem MLA1234 generamos la publicación de catálogo cuyo ítem es MLA1235, la venta de cualquiera de esos dos ítems producirá un decremento de stock en la otra ya que éste está sincronizado.
Las publicaciones enlazadas permiten que el vendedor comience a vender en catálogo mientras continúa vendiendo a través de sus publicaciones tradicionales.
Las publicaciones de catálogo creadas directamente en catálogo sin ser enlazadas con una publicación tradicional son completamente independientes y no comparten stock con ninguna publicación actual.

Excepto por el stock, las publicaciones de catálogo son ítems independientes de las publicaciones tradicionales y es posible alterar sus condiciones de venta y administrar su ciclo de vida en forma independiente. En caso de eliminar la publicación de catálogo se pierde el enlace con la publicación tradicional y para volver a publicar en catálogo se debe repetir el proceso de publicación en catálogo. Ten en cuenta que para que se pierda la relación el status del item de catálogo deberá ser “delete”.


¿Hay algo más que saber acerca de la administración de las publicaciones de catálogo?

Dado que el contenido de las publicaciones de catálogo es administrado por Mercado Libre, los campos editoriales como title, pictures, description y atributos de la ficha técnica del recurso /items no pueden ser editados en publicaciones de catálogo.


Los campos correspondientes a las condiciones de venta (por ejemplo price) siguen siendo administrados por los vendedores. En las siguientes secciones te explicaremos más acerca de los recursos que dispones para administrar eficientemente las condiciones de venta.

No, actualmente los requerimientos son:

  • Productos nuevos (no reacondicionados ni usados).
  • Vendedores con reputación verde.
  • En el dominio CELLPHONES sólo está permitido publicar teléfonos liberados (que funcionan en cualquier compañía telefónica).

Importante:

  • Para que podamos asignar un catalog_product_id es esencial que el vendedor complete la ficha técnica del ítem.
  • Si el vendedor incluye un identificador de producto universal en la publicación aumenta las posibilidades de que podamos asociar tu ítem a un catalog_product_id.
  • Cuando cuentes con ítems sin catalog_product_id asociado, puedes realizar la búsqueda del mismo a través del "buscador de productos”, el cual te permitirá identificar el catalog_product_id correcto para sumarlo en el POST al momento de realizar el OPTIN.

Estas condiciones pueden ir cambiando en el tiempo y por eso en la siguiente sección encontrarás las herramientas necesarias para conocer si una publicación es elegible para catálogo.


¿Qué pasa si por error asocio un ítem a un producto equivocado?

En las publicaciones de catálogo es extremadamente importante que no haya ninguna discrepancia entre el producto de catálogo y la oferta.
Dado que el contenido de los productos es aportado por Mercado Libre, cualquier discrepancia entre el producto descripto y la oferta publicada por el vendedor producirían que un comprador reciba algo distinto a lo esperado.
En caso de haber detectado un error es esencial dar de baja la publicación de catálogo, realizando el flujo normal como con una publicación de marketplace. En primera instancia, debes realizar un PUT con status=”closed” y luego, otro PUT con delete=”true” sobre el ítem de catálogo para dar de baja la publicación.
Tanto al vendedor como al integrador pueden ser responsables por errores en la publicación en catálogo y están expuestos a sanciones que van desde la afectación en la reputación hasta la inhabilitación para operar en la plataforma.


Pasos para publicar en catálogo a partir de una publicación existente

  1. Verificamos que la publicación sea elegible para catálogo con el recurso /items/{item_id}/catalog_listing_eligibility.
  2. Dependiendo si el ítem cuenta con un catalog_product_id asociado con el recurso /items/{item_id}/catalog_listing_eligibility verificaremos si es elegible o no.
  3. Si el ítem no cuenta con un catalog_product_id asociado, debemos buscar en el recurso /products/search el catalog_product_id que coincide exactamente con el producto que se quiere vender.
  4. Comprobamos que la publicación sin catalog_product_id asociado sea elegible para catálogo con el recurso /items/{item_id}/catalog_listing_eligibility?catalog_product_id={catalog_product_id}&variation_id={variation_id}.
  5. Realizamos un POST con el recurso /items/catalog_listings para crear la publicación de catálogo enlazada con una publicación existente.


Pasos para publicar en catálogo en forma directa sin una publicación enlazada

  1. Buscar en el recurso /products/search el catalog_product_id que coincide exactamente con el producto que quiere vender.
  2. Generar el JSON del recurso /items incluyendo catalog_listing=true y el catalog_product_id validado con el recurso catalog_listing_eligibility.
  3. Utilizar el recurso /items para crear la publicación de catálogo en forma directa.

En las siguientes secciones mostramos en detalle cómo seguir estos pasos.

Importante:
Este recurso se encuentra disponible en Argentina, México y Brasil.

Como contamos en la sección previa, en este momento sólo pueden participar de catálogo ciertas publicaciones que cumplen con algunos requisitos como ser nuevas, de vendedores de buena reputación y en el dominio CELLPHONES es necesario que el teléfono sea liberado.
Para validar y conocer la elegibilidad para catálogo de una publicación en cualquier dominio deberás utilizar la API catalog_listing_eligibility. Ten en cuenta que la respuesta será diferente dependiendo si la publicación tiene o no variaciones.
Además, puedes verificar si una publicación sin catalog_product_id asociado es elegible para publicar en catálogo usando el mismo recurso catalog_listing_eligibility y sumando los parámetros de catalog_product_id y variation_id, dependiendo las características del ítem. Ten en cuenta que para identificar el catalog_product_id correcto deberás seguir los pasos correspondientes detallados en la sección buscador de productos.


Elegibilidad de una publicación existente sin catalog_product_id asociado

Ejemplo sin variación:

curl -X GET https://api.mercadolibre.com/items/MLA123456788/catalog_listing_eligibility?catalog_product_id=MLA6352027&access_token={ACCESS_TOKEN}

Respuesta:

{
   "id": "MLA123456788",
   "site_id": "MLA",
   "domain_id": "MLA-MICROWAVES",
   "status": "READY_FOR_OPTIN",
   "buy_box_eligible": true,
   "variations": []
}

Ejemplo con variación:

curl -X GET https://api.mercadolibre.com/items/MLA123456789/catalog_listing_eligibility?catalog_product_id=MLA9452524&variation_id=43278798243&access_token=$ACCESS_TOKEN

Respuesta:

{
  "id": "MLA123456789",
  "site_id": "MLA",
  "domain_id": "MLA-CELLPHONES",
  "status": null,
  "buy_box_eligible": null,
  "variations": [
    {
      "id": 43278798243,
      "status": "READY_FOR_OPTIN",
      "buy_box_eligible": true
    }
  ]
}

En caso que el ítem no cuente con un catalog_product_id y en el recurso de elegibilidad tampoco se envíe el parámetro con un valor de catalog_product_id correcto, la respuesta mencionará que el catalog_product_id es “null”.


Ejemplo sin parámetro:

curl -X GET https://api.mercadolibre.com/items/MLA123456789/catalog_listing_eligibility?access_token={ACCESS_TOKEN}

Respuesta:

{
   "id": "MLA123456789",
   "site_id": "MLA",
   "domain_id": "MLA-MICROWAVES",
   "status": "CATALOG_PRODUCT_ID_NULL",
   "buy_box_eligible": false,
   "variations": []
}


Elegibilidad de una publicación existente con catalog_product_id asociado

Los siguientes ejemplos muestran cómo validar la elegibilidad de una publicación existente para enlazar una nueva publicación de catálogo con stock sincronizado que cuente con un catalog_product_id asociado.


Llamada:

curl -X GET https://api.mercadolibre.com/items/{item_id}/catalog_listing_eligibility?access_token={ACCESS_TOKEN}

Ejemplo con variaciones:

curl -X GET https://api.mercadolibre.com/items/MLA1234/catalog_listing_eligibility?access_token={ACCESS_TOKEN}

Respuesta:

{
    "id": "MLA1234",
    "site_id": "MLA",
    "domain_id": "MLA-CELLPHONES",
    "status": null,
    "buy_box_eligible": null,
    "variations": [
        {
            "id": 1312323,
            "status": "READY_FOR_OPTIN",
            "buy_box_eligible": true
        },
        {
            "id": 1312444,
            "status": "READY_FOR_OPTIN",
            "buy_box_eligible": true
        }
    ]
}

Ejemplo sin variaciones:

curl -X GET https://api.mercadolibre.com/items/MLB1234/catalog_listing_eligibility?access_token={ACCESS_TOKEN}

Respuesta:

{
    "id": "MLB1234",
    "site_id": "MLB",
    "domain_id": "MLB-MICROWAVES",
    "status": "READY_FOR_OPTIN",
    "buy_box_eligible": true,
    "variations": []
}


Consideraciones:

  • Si el ítem no posee variaciones la elegibilidad quedará expresada a través del campo buy_box_eligible de primer nivel en el JSON de la respuesta y la sección variations estará vacía.
  • Si el ítem posee variaciones la elegibilidad de cada una de ellas quedará expresada dentro de la sección variations, la cual contendrá un array por variación con un campo buy_box_eligible para cada una de ellas.


Descripción de campos:

  • id: ID de la publicación que estamos consultando.
  • site_id: ID del sitio al cual corresponde el ítem.
  • domain_id: ID del dominio al cual pertenece el ítem.
  • buy_box_eligible: indica si el ítem/variación está habilitado o no para participar de catálogo.
  • variations: son todas las variaciones que tiene un ítem. Cada una tendrá asociada un status y un valor para el campo buy_box_eligible.
  • status: define la situación del ítem tradicional con respecto a catálogo. Los diferentes estados podrán ser:

Elegible:

  • READY_FOR_OPTIN: el ítem puede ser publicado en catálogo.
  • No elegibles:

    • ALREADY_OPTED_IN: el ítem tradicional que se consulta ya tiene un ítem de catálogo asociado.
    • CLOSED: el ítem está en un estado que ya no se puede vender más.
    • PRODUCT_INACTIVE: el ítem está asociado a un producto que todavía no ha sido habilitado para catálogo o el ítem aún no tiene catalog_product_id asignado.
    • NOT_ELIGIBLE: existe una regla de negocio que impide que el ítem aplique a catálogo. (ej: un celular usado, un celular sin liberar o un vendedor con reputación insuficiente).

    Ten en cuenta que si consultas por un ítem de catálogo que se encuentre compitiendo, el estado será COMPETING.


    Filtrado de ítems por vendedor

    Sumamos en el recurso de búsqueda de publicaciones de un vendedor un filtro que permitirá conocer las publicaciones que son de catálogo y aquellas que son tradicionales. Para eso deberás pasar en la búsqueda el parámentro "catalog_listing" con el valor true o false, dependiendo de lo que se desee consultar.
    En primer lugar identificamos todos los ítems de catálogo de un seller, ten en cuenta que deberás pasar el parámetro de status correspondiente en caso que quieras sumar un filtro como por ejemplo status=“active”.


    Llamada:

    curl -X GET https://api.mercadolibre.com/users/{user_id}/items/search?catalog_listing=true&access_token={ACCESS_TOKEN}
    

    Ejemplo:

    curl -X GET https://api.mercadolibre.com/users/123456789/items/search?catalog_listing=true&access_token={ACCESS_TOKEN}
    

    Respuesta acotada de ítems de catálogo:

    {
      "seller_id": "123456789",
      "query": null,
      "paging": {
        "limit": 50,
        "offset": 0,
        "total": 8
      },
      "results": [
        "MLA123456789",
        "MLA234567890",
        "MLA345678912",
        "MLA456789123",
        "MLA567891234",
        "MLA678912345",
        "MLA789123456",
        "MLA891234567"
      ],
      "filters": [
      ],
      "available_filters": [],
      "orders": [],
      "available_orders": []
    }
    
    

    Por otro lado, podrás realizar el mismo filtro para identificar todos los items de un seller que no son de catálogo.


    Llamada:

    curl -X GET https://api.mercadolibre.com/users/{user_id}/items/search?catalog_listing=false&access_token={ACCESS_TOKEN}
    

    Ejemplo:

    curl -X GET https://api.mercadolibre.com/users/123456789/items/search?catalog_listing=false&access_token={ACCESS_TOKEN}
    

    Respuesta acotada de ítems de marketplace:

    {
      "seller_id": "123456789",
      "query": null,
      "paging": {
        "limit": 50,
        "offset": 0,
        "total": 2902
      },
      "results": [
        "MLA987654321",
        "MLA123789456",
        "MLA456789123",
        "MLA132465798",
        "MLA978645312",
        "MLA312645978",
        "MLA654987321",
        "MLA123789654",
          ],
      "filters": [
      ],
      "available_filters": [],
      "orders": [],
      "available_orders": []
    }
    


    Determinar el producto exacto a vender

    Para que un ítem pueda ser publicado en catálogo y ser comprado, tiene que estar asociado a un producto suficientemente específico tal que el comprador pueda saber con precisión qué está comprando y para el cual Mercado Libre haya creado el contenido (productos con status=”active” en el recurso /products/{catalog_product_id})

    Importante:
    El contenido de la publicación de catálogo es provisto por Mercado Libre. Por lo tanto, el vendedor es responsable de confirmar que el producto a asociar coincida con las características específicas que se muestran en la plataforma.
    En caso que exista una diferencia entre lo que el usuario compre y el producto asociado es posible, que se generen reclamos y/o cancelaciones que impactarán negativamente en su reputación y como consecuencia de esto la inhabilitación para publicar en catálogo, llevando eventualmente a la suspensión de la cuenta.


    Productos parent y children

    En muchos dominios (no todos) existen dos niveles de productos:

    • Productos de nivel superior (“parents”) que agrupan productos específicos y no son en sí mismos aptos para ser comprados. Ejemplo: Motorola Moto G6 ⇐ ¡No tiene la capacidad ni el color especificado!
    • Productos de nivel terminal (“children”) suficientemente especificados para ser comprados. Ejemplo: Motorola G6 32 GB Índigo oscuro.

    Ejemplo de un producto parent (no es específico y no se puede comprar):

    curl -X GET https://api.mercadolibre.com/products/MLA9652753

    Respuesta:

    {
      "id": "MLA9652753",
      "status": "inactive",
      "domain_id": "MLA-CELLPHONES",
      "permalink": "https://www.mercadolibre.com.ar/p/MLA9652753",
      "name": "Motorola Moto G6",
      "buy_box_winner": null,
      "pickers": null,
      "pictures": null,
      "main_features": null,
      "attributes": [],
      "short_description": {},
      "parent_id": "",
      "children_ids": [
        "MLA9652754",
        "MLA9652755",
        "MLA9652756",
        "MLA9652757",
        "MLA9707910",
        "MLA9707911",
        "MLA9707912",
        "MLA9707913"
      ]
    }  


    Ejemplo de un producto children (específico y se puede usar para publicar y comprar si está activo):

    curl -X GET https://api.mercadolibre.com/products/MLA9652754

    Respuesta:

    {
      "id": "MLA9652754",
      "status": "active",
      "domain_id": "MLA-CELLPHONES",
      "permalink": "https://www.mercadolibre.com.ar/p/MLA9652754",
      "name": "Motorola G6 32 GB Índigo oscuro",
      "buy_box_winner": {},
      "pickers": [],
      "pictures": [],
      "main_features": [],
      "attributes": [],
      "short_description": {},
      "parent_id": "MLA9652753",
      "children_ids": [
      ]
    }
    

    Lo que nos interesa a los efectos de publicar es:

    • children_ids
      • Si el campo está vacío se trata de un producto children el cual es suficientemente específico para publicar.
      • Si este array contiene IDs de otros productos, quiere decir que el catalog_product_id actual corresponde a un producto parent (no completamente especificado). Para publicar en catálogo debemos buscar el producto específico entre sus children_ids.
    • status
      • Para poder crear una publicación de catálogo es necesario que el producto tenga status=”active”.
      • Los productos “parent” nunca tendrán status=”active” porque no son comprables.

    Eligiendo el producto específico para mi publicación

    Tu publicación y/o tus variaciones elegibles para catálogo poseerán un catalog_product_id que deberás verificar que es adecuado para publicar utilizando el recurso /products/{catalog_product_id}.


    Ejemplo de “catalog_product_id” en un ítem:

    curl -X GET  https://api.mercadolibre.com/items/MLA123456789?access_token={ACCESS_TOKEN}

    Respuesta acotada:

    {
        "id": "MLA123456789",
        "site_id": "MLA",
        "title": "ITEM DE TESTEO",
        "subtitle": null,
        "seller_id": 337011113,
        "category_id": "MLA22195",
        "price": 14330,
        "available_quantity": 50,
        "catalog_product_id": "MLA14793781",
        "domain_id": "MLA-AUTOMOTIVE_TIRES"
    }

    Al momento de crear una publicación de catálogo a partir de una publicación existente elegible, tendrás que verificar con nuestro recurso de Productos:

    • Si el catalog_product_id corresponde a un producto con status active, estás listo para publicar en catálogo utilizando ese catalog_product_id.
    • Si el catalog_product_id corresponde a un producto con status inactive.
      • Si el array children_ids está vacío quiere decir que la publicación o variación ya está asociada al producto más específico que tenemos y éste no está aún listo para publicarse en catálogo, por lo que no podrás crear la publicación de catálogo hasta que el producto esté editorializado por parte de Mercado Libre.
      • Si el array children_ids no está vacío, deberás buscar entre los productos children el que corresponde exactamente con lo que estás vendiendo.
    • Si encuentras un catalog_product_id children activo que corresponda exactamente con lo que quieres vender, puedes utilizarlo en el siguiente paso para crear tu publicación de catálogo.
    • Si entre los catalog_product_id children no encuentras tu producto exacto o lo encuentras pero no está activo, no podrás publicar en esta oportunidad ese producto en el catálogo y deberás esperar a que Mercado Libre cree el producto y lo editorialice.


    Publicar en catálogo a partir de una publicación existente

    Importante:
    Este recurso está habilitado en Argentina, México y Brasil para vendedores seleccionados.

    Una vez que valides que tu publicación existente es elegible para catálogo y hayas obtenido el catalog_product_id activo que corresponde exactamente a lo que estás publicando, deberás crear la publicación de catálogo a partir de un POST en el recurso /items/catalog_listings.


    Acerca de las variaciones

    • En los dominios donde actualmente existe catálogo, las publicaciones de catálogo no admiten variaciones porque ya están asociadas a un producto específico. Por tanto, si tu publicación original tenía variaciones, tendrás una publicación de catálogo por cada una de ellas. La información relevante de tus variaciones (por ejemplo el color del artículo) no se perderá sino que estará reflejada en los atributos del producto de catálogo. En el futuro es posible que existan dominios donde el producto nunca termine de especificar perfectamente lo que se vende (por ejemplo en ropa para el talle) y es factible que estén permitidas las variaciones. Te avisaremos cuando eso ocurra.
    • Si tu ítem existente contiene variaciones deberás hacer un POST por cada una de las mismas enviando el campo variation_id en el cuerpo del POST.

    Ejemplo sobre un ítem con variaciones:

    curl -X POST https://api.mercadolibre.com/items/catalog_listings?access_token={ACCESS_TOKEN}
    {
      "item_id":"MLA1234",
      "variation_id": 4321,
      "catalog_product_id":"MLA9876"
    }

    Ejemplo sobre un ítem sin variaciones:

    curl -X POST https://api.mercadolibre.com/items/catalog_listings?access_token={ACCESS_TOKEN}
    {
      "item_id":"MLA1234",
      "catalog_product_id":"MLA9876" 
    }

    Ejemplo acotado de respuesta a la creación de un ítem:

    Respuesta:

    {
        "id": "MLA1234",
        "site_id": "MLA",
        "title": "Samsung Galaxy J7 Prime 16 Gb Negro",
        "warranty": null,
        "catalog_product_id": "MLA9876",
        "domain_id": "MLA-CELLPHONES",
        "seller_custom_field": null,
        "parent_item_id": null,
        "differential_pricing": null,
        "deal_ids": [],
        "automatic_relist": false,
        "date_created": "2019-08-02T11:33:31.270Z",
        "last_updated": "2019-08-02T11:33:31.270Z",
        "total_listing_fee": null,
        "health": null,
        "catalog_listing": true,
        "item_relations": [
            {
                "id": "MLA123456789",
                "variation_id": null,
                "stock_relation": 1
            }
        ]
    }

    Además, ten en cuenta que:

    • Si el ítem es enviado sin variaciones cuando sí las tiene, el POST fallará devolviendo un error 400.
    • catalog_product_id es un campo obligatorio en el POST ya sea que el ítem cuente o no con variaciones.

    Para guiarte y realizar testeos, podrás utilizar un usuario de prueba, crear un ítem que cumpla todas las condiciones necesarias para que aplique a catálogo, reconocer cuál es el producto específico activo en catálogo al cual asociarlo y realizar el POST al recurso /items/catalog_listings.
    Aclaración: la publicación de prueba NO va a competir en catálogo.
    Pasos:

    1. Crear user de prueba y el ítem de prueba el cual no contará con catalog_product_id asociado.
    2. Validar con el ítem creado con el recurso de /products/search cual es el catalog_product_id correcto para el item.
    3. Una vez identificado el catalog_product_id, se podrá verificar la eligibilidad con el recurso /items/{item_id}/catalog_listing_eligibility pasando el parámetro catalog_product_id y variation dependiendo las características del ítem. De esta forma se verificarás si el ítem es elegibles para catálogo.
    4. Una vez identificado que el item con el catalog_product_id son elegibles, el próximo paso es realizar el OPTIN para terminar de asociar el ítem de test con un ítem de catálogo.
    5. Realizamos un POST con el recurso /items/catalog_listings para crear la publicación de catálogo enlazada con el ítem de test.


    Publicación directa en catálogo: buscador de productos

    Importante:
    Este recurso está disponible en Argentina, México y Brasil.

    Para realizar una publicación directa en catálogo es necesario ubicar el catalog_product_id que corresponde exactamente con la oferta que se quiere publicar. Con este recurso obtendrás una sugerencia de productos en base a ciertos parámetros de búsqueda.

    Importante:
    El contenido de la publicación de catálogo es provisto por Mercado Libre. Por lo tanto, el vendedor es responsable de confirmar que el producto a asociar coincida con las características específicas que se muestran en la plataforma.
    En caso que exista una diferencia entre lo que el usuario compre y el producto asociado es posible, que se generen reclamos y/o cancelaciones que impactarán negativamente en su reputación y como consecuencia de esto la inhabilitación para publicar en Catálogo, llevando eventualmente a la suspensión de la cuenta.

    Los parámetros del buscador de productos pueden ser el código universal o un conjunto de palabras clave, por ejemplo marca y modelo.

    Parámetros:

    • site_id: string que representa el país. Obligatorio.
    • status: puede ser que si bien el producto está identificado dentro de nuestro catálogo, aún no es elegible para asociar a una publicación.

    -status=active: devuelve aquellos productos que ya pueden elegirse para asociar a una publicación.

    -status=inactive: devuelve aquellos productos que todavía no son elegibles para asociar a una publicación.

    Aclaración: si no se envía este parámetro, por defecto traerá todos los resultados, tanto activos como inactivos.

    • q: string con palabras claves de búsqueda. Ejemplo: “Celular Samsung Galaxy S8” Obligatorio en caso no se envíe un product_identifier.
    • product_identifier: string con el código universal del producto. Ejemplo: EAN, UPC, ISBN, etc. Obligatorio en caso no se envíe una cadena de palabras claves.
    • domain_id: string con el dominio en el cual se quiere publicar. (Opcional)
    • offset: posición desde la que se devuelven los resultados de la búsqueda (Opcional)
    • limit: cantidad de resultados que devuelve la búsqueda (Opcional)

    Llamada con parámetro “q”:

    curl -X GET https://api.mercadolibre.com/products/search?status={status_id}&site_id={site_id}&q={q}

    Ejemplo con parámetro “q”:

    curl -X GET https://api.mercadolibre.com/products/search?status=active&site_id=MLA&q=Samsung%Galaxy%S8

    Respuesta con parámetro “q”:

    { 
      "q": "Samsung Galaxy S8", 
      "paging": {
        "total": 10, 
        "offset": 0, 
        "limit": 10 
       }, 
       "results": [ 
          {
            "id": "MLA6408699", 
            "status": "active", 
            "domain_id": "MLA-CELLPHONES", 
            "name": "Samsung Galaxy S8 64 GB Gris orquídea", 
            "description": "descripción", 
            "attributes": [ 
               { 
                 "id": "BRAND", 
                 "name": "Marca", 
                 "value_id": "206",
                 "value_name": "Samsung"
               }
             ], 
            "pictures": [ 
               { 
                 "id": "924348-MLA31003000895_062019",Ç
                 "url": "https://mla-s2-p.mlstatic.com/924348-MLA31003000895_062019-F.jpg" 
               }
            ]
          }
        ] 
     }
    
    

    Llamada con parámetros “q” y “domain_id”:

    curl -X GET https://api.mercadolibre.com/products/search?status={status_id}&site_id={site_id}&q={q}&domain_id={domain_id}

    Ejemplo con parámetros “q” y “domain_id”:

    curl -X GET https://api.mercadolibre.com/products/search?status=active&site_id=MLA&q=Samsung%20Galaxy%20S8&domain_id=MLA-CELLPHONES

    Respuesta con parámetros “q” y “domain_id”:

    {
      "q": "Samsung Galaxy S8",
      "domain_id":"MLA-CELLPHONES",
      "paging": {
        "total": 10,
        "offset": 0,
        "limit": 10
      },
      "results": [
        {
          "id": "MLA6408699",
          "status": "active",
          "domain_id": "MLA-CELLPHONES",
          "name": "Samsung Galaxy S8 64 GB Gris orquídea",
          "description": "descripción",
          "attributes": [
            {
              "id": "BRAND",
              "name": "Marca",
              "value_id": "206",
              "value_name": "Samsung"
            }
          ],
          "pictures": [
            {
              "id": "924348-MLA31003000895_062019",
              "url": "https://mla-s2-p.mlstatic.com/924348-MLA31003000895_062019-F.jpg"
            }
          ]
        }
      ]
    }
    

     

    Llamada con parámetro “product_identifier”:

    curl -X GET https://api.mercadolibre.com/products/search?status={status_id}&site_id={site_id}&product_identifier={product_identifier}

    Ejemplo con parámetro “product_identifier”:

    curl -X GET https://api.mercadolibre.com/products/search?status=active&site_id=MLA&product_identifier=0123456789

    Respuesta con parámetro “product_identifier”:

    { 
      "product_identifier": "0123456789", 
      "paging": {
          "total": 10, 
          "offset": 0, 
          "limit": 10 
       }, 
       "results": [ 
            { 
              "id": "MLA6408699", 
              "status": "active", 
              "domain_id": "MLA-CELLPHONES", 
              "name": "Samsung Galaxy S8 64 GB Gris orquídea", 
              "description": "descripción", 
              "attributes": [
                    { 
                       "id": "BRAND", 
                      "name": "Marca", 
                      "value_id": "206", 
                      "value_name": "Samsung" 
                    } 
               ], 
             "pictures": [ 
                  { 
                     "id": "924348-MLA31003000895_062019", 
                     "url": "https://mla-s2-p.mlstatic.com/924348-MLA31003000895_062019-F.jpg" 
                  } 
               ] 
            } 
         ] 
      }
    
    

    Consideraciones:

    • Dependiendo los parámetros utilizados para la búsqueda, obtendremos como resultado uno o varios productos como sugerencia.
    • Si se utiliza como parámetro un product_identifier, se obtendrá solo un producto.
    • Si se utiliza como parámetro una keyword, ya sea con o sin un dominio, se podrán obtener uno o varios productos que se relacionen a los valores ingresados.

     

    Crear la publicación de catálogo en forma directa

    Además de realizar publicaciones de catálogo con una publicación original, también puedes crear ítems de catálogo sin necesidad de contar con un ítem de marketplace para vincular. Ten en cuenta que para crear el ítem de catálogo deberás considerar los mismos requisitos expuestos en Publicar ítem en catálogo.
    Importante: Ten en cuenta que al momento de realizar el POST es necesario enviar los siguientes valores para que se cree la publicación de catálogo.

    • "catalog_product_id": este valor debe ser confirmado con el recurso de search/product.
    • "catalog_listing": true: es necesario envíar el valor en true para generar el ítem de catálogo.

    • Llamada:

      curl -X POST https://api.mercadolibre.com/items?access_token={ACCESS_TOKEN}

      Ejemplo:

      curl -X POST -H "Content-Type: application/json" -d
      '{
          "site_id": "MLA",
          "title": "Item de test no ofertar",
          "category_id": "MLA1055",
          "price": 10000000,
          "currency_id": "ARS",
          "available_quantity": 1,
          "buying_mode": "buy_it_now",
          "listing_type_id": "gold_special",
          "pictures": [],
          "attributes": [
              {
                  "id": "CARRIER",
                  "name": "Compañía telefónica",
                  "value_id": "298335",
                  "value_name": "Liberado",
                  "value_struct": null,
                  "attribute_group_id": "OTHERS",
                  "attribute_group_name": "Otros"
              },
              {
                  "id": "ITEM_CONDITION",
                  "name": "Condición del ítem",
                  "value_id": "2230284",
                  "value_name": "Nuevo",
                  "value_struct": null,
                  "attribute_group_id": "OTHERS",
                  "attribute_group_name": "Otros"
              }
          ],
          "catalog_product_id": "MLA6005934",
          "catalog_listing": true
      }'
      https://api.mercadolibre.com/items?access_token=$ACCESS_TOKEN
      

      Respuesta:

      {
          "id": "MLA811894603",
          "site_id": "MLA",
          "title": "Apple iPhone iPhone 3g 8 Gb Negro 128 Mb Ram",
          "subtitle": null,
          "seller_id": 464161506,
          "category_id": "MLA1055",
          "official_store_id": null,
          "price": 10000000,
          "base_price": 10000000,
          "original_price": null,
          "inventory_id": null,
          "currency_id": "ARS",
          "initial_quantity": 1,
          "available_quantity": 1,
          "sold_quantity": 0,
          "sale_terms": [],
          "buying_mode": "buy_it_now",
          "listing_type_id": "gold_special",
          "start_time": "2019-08-29T14:49:42.945Z",
          "historical_start_time": "2019-08-29T14:49:42.945Z",
          "stop_time": "2039-08-24T04:00:00.000Z",
          "end_time": "2039-08-24T04:00:00.000Z",
          "expiration_time": "2019-11-17T14:49:42.987Z",
          "condition": "new",
          "permalink": "http://articulo.mercadolibre.com.ar/MLA-811894603-apple-iphone-iphone-3g-8-gb-negro-128-mb-ram-_JM",
          "pictures": [
              {
                  "id": "675782-MLA31138875214_062019",
                  "url": "http://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-O.jpg",
                  "secure_url": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-O.jpg",
                  "size": "249x500",
                  "max_size": "598x1200",
                  "quality": ""
              },
              {
                  "id": "915001-MLA31138546867_062019",
                  "url": "http://mla-s2-p.mlstatic.com/915001-MLA31138546867_062019-O.jpg",
                  "secure_url": "https://mla-s2-p.mlstatic.com/915001-MLA31138546867_062019-O.jpg",
                  "size": "250x500",
                  "max_size": "600x1200",
                  "quality": ""
              },
              {
                  "id": "881441-MLA31138332972_062019",
                  "url": "http://mla-s2-p.mlstatic.com/881441-MLA31138332972_062019-O.jpg",
                  "secure_url": "https://mla-s2-p.mlstatic.com/881441-MLA31138332972_062019-O.jpg",
                  "size": "243x500",
                  "max_size": "585x1200",
                  "quality": ""
              },
              {
                  "id": "804666-MLA31139286536_062019",
                  "url": "http://mla-s1-p.mlstatic.com/804666-MLA31139286536_062019-O.jpg",
                  "secure_url": "https://mla-s1-p.mlstatic.com/804666-MLA31139286536_062019-O.jpg",
                  "size": "405x500",
                  "max_size": "836x1030",
                  "quality": ""
              }
          ],
          "video_id": null,
          "descriptions": [
              {
                  "id": "MLA811894603-2265773390"
              }
          ],
          "accepts_mercadopago": true,
          "non_mercado_pago_payment_methods": [],
          "shipping": {
              "mode": "not_specified",
              "local_pick_up": false,
              "free_shipping": false,
              "methods": [],
              "dimensions": null,
              "tags": [],
              "logistic_type": "not_specified",
              "store_pick_up": false
          },
          "international_delivery_mode": "none",
          "seller_address": {
              "id": 1061221617,
              "comment": "",
              "address_line": "Test Address 123",
              "zip_code": "1414",
              "city": {
                  "id": "",
                  "name": "Palermo"
              },
              "state": {
                  "id": "AR-C",
                  "name": "Capital Federal"
              },
              "country": {
                  "id": "AR",
                  "name": "Argentina"
              },
              "latitude": 38.11569,
              "longitude": 13.3614868,
              "search_location": {
                  "neighborhood": {
                      "id": "TUxBQlBBTDI1MTVa",
                      "name": "Palermo"
                  },
                  "city": {
                      "id": "TUxBQ0NBUGZlZG1sYQ",
                      "name": "Capital Federal"
                  },
                  "state": {
                      "id": "TUxBUENBUGw3M2E1",
                      "name": "Capital Federal"
                  }
              }
          },
          "seller_contact": null,
          "location": {},
          "geolocation": {
              "latitude": 38.11569,
              "longitude": 13.3614868
          },
          "coverage_areas": [],
          "attributes": [
              {
                  "id": "CARRIER",
                  "name": "Compañía telefónica",
                  "value_id": "298335",
                  "value_name": "Liberado",
                  "value_struct": null,
                  "attribute_group_id": "OTHERS",
                  "attribute_group_name": "Otros"
              },
              {
                  "id": "ITEM_CONDITION",
                  "name": "Condición del ítem",
                  "value_id": "2230284",
                  "value_name": "Nuevo",
                  "value_struct": null,
                  "attribute_group_id": "OTHERS",
                  "attribute_group_name": "Otros"
              },
              {
                  "id": "BRAND",
                  "name": "Marca",
                  "value_id": "9344",
                  "value_name": "Apple",
                  "value_struct": null,
                  "attribute_group_id": "OTHERS",
                  "attribute_group_name": "Otros"
              },
              {
                  "id": "LINE",
                  "name": "Línea",
                  "value_id": "58993",
                  "value_name": "iPhone",
                  "value_struct": null,
                  "attribute_group_id": "OTHERS",
                  "attribute_group_name": "Otros"
              },
              {
                  "id": "MODEL",
                  "name": "Modelo",
                  "value_id": "14605",
                  "value_name": "iPhone 3G",
                  "value_struct": null,
                  "attribute_group_id": "OTHERS",
                  "attribute_group_name": "Otros"
              },
              {
                  "id": "IS_DUAL_SIM",
                  "name": "Es Dual SIM",
                  "value_id": "242084",
                  "value_name": "No",
                  "value_struct": null,
                  "attribute_group_id": "OTHERS",
                  "attribute_group_name": "Otros"
              },
              {
                  "id": "COLOR",
                  "name": "Color",
                  "value_id": "52049",
                  "value_name": "Negro",
                  "value_struct": null,
                  "attribute_group_id": "OTHERS",
                  "attribute_group_name": "Otros"
              },
              {
                  "id": "INTERNAL_MEMORY",
                  "name": "Memoria interna",
                  "value_id": "59566",
                  "value_name": "8 GB",
                  "value_struct": {
                      "number": 8,
                      "unit": "GB"
                  },
                  "attribute_group_id": "OTHERS",
                  "attribute_group_name": "Otros"
              },
              {
                  "id": "RAM",
                  "name": "Memoria RAM",
                  "value_id": "366239",
                  "value_name": "128 MB",
                  "value_struct": {
                      "number": 128,
                      "unit": "MB"
                  },
                  "attribute_group_id": "OTHERS",
                  "attribute_group_name": "Otros"
              },
              {
                  "id": "MAIN_COLOR",
                  "name": "Color principal",
                  "value_id": "2450295",
                  "value_name": "Negro",
                  "value_struct": null,
                  "attribute_group_id": "OTHERS",
                  "attribute_group_name": "Otros"
              },
              {
                  "id": "OPERATING_SYSTEM_NAME",
                  "name": "Nombre del sistema operativo",
                  "value_id": "7404961",
                  "value_name": "iOS",
                  "value_struct": null,
                  "attribute_group_id": "OTHERS",
                  "attribute_group_name": "Otros"
              },
              {
                  "id": "WITH_IMEI",
                  "name": "Con IMEI",
                  "value_id": "242085",
                  "value_name": "Sí",
                  "value_struct": null,
                  "attribute_group_id": "OTHERS",
                  "attribute_group_name": "Otros"
              }
          ],
          "warnings": [],
          "listing_source": "",
          "variations": [],
          "thumbnail": "http://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-I.jpg",
          "secure_thumbnail": "https://mla-s1-p.mlstatic.com/675782-MLA31138875214_062019-I.jpg",
          "status": "active",
          "sub_status": [],
          "tags": [
              "immediate_payment",
              "test_item"
          ],
          "warranty": null,
          "catalog_product_id": "MLA6005934",
          "domain_id": "MLA-CELLPHONES",
          "seller_custom_field": null,
          "parent_item_id": null,
          "differential_pricing": null,
          "deal_ids": [],
          "automatic_relist": false,
          "date_created": "2019-08-29T14:49:43.099Z",
          "last_updated": "2019-08-29T14:49:43.099Z",
          "total_listing_fee": null,
          "health": null,
          "catalog_listing": true,
          "item_relations": []
      }
      

       

      Compitiendo para ganar las ventas

      Cómo conocer el precio para ganar [BETA]

      Importante:
      Este recurso está en BETA y la respuesta estará cambiando en los próximos días. Ten en cuenta que temporalmente para poder hacer pruebas deberás usar la respuesta actual, sin embargo en esta guía documentamos las respuestas definitivas que verás en unos días.

      Las publicaciones de catálogo compiten por obtener las ventas de la página de producto y existe un algoritmo que determina quién será el ganador de esas ventas en base a características de la publicación y del vendedor.
      El algoritmo que evalúa cuál será la publicación ganadora tiene en cuenta principalmente:

      • precio de la publicación
      • cuotas sin interés
      • envío full, envío gratis, envío en el día

      Notas:

      • algunas de estas características pueden aplicar sólo a algunos compradores (ejemplo: envío en el día ó descuento de Mercado Puntos). En estos casos hacemos un mejor esfuerzo por elegir un ganador considerando el comprador particular teniendo en cuenta qué características le aplican.
      • por lo anterior, si bien hablaremos de “el ganador” en forma unívoca, eventualmente el vendedor podría estar ganando en general pero no en particular para ciertos usuarios (por ejemplo, si viven muy lejos y no obtendrían nunca un envío en el día).

      Para que los vendedores puedan competir eficientemente, ofrecemos un recurso que indica cuál es el precio con el que ganarías las ventas manteniendo sin cambios el resto de las condiciones (en este momento envíos y financiación).


      Llamada:

      curl -X GET https://api.mercadolibre.com/items/{item_id}/price_to_win?access_token={ACCESS_TOKEN}

      Ejemplo:

      curl -X GET https://api.mercadolibre.com/items/MLB1234/price_to_win?access_token={ACCESS_TOKEN}

      Respuesta:

      {
        "item_id": "MLA1234",
        "current_price": 580.00,
        "price_to_win": 560.28,
        "boosts": {
              "fulfillment”: true,
              "free_shipping” : true,
      	"same_day_shipping”: true,
      	"free_installments”: false
        },
        "status": "competing"
      }
      

       

      Cómo leer la respuesta:

      • El campo status indica si estamos ganando para el público general (podríamos estar ganando para segmentos minoritarios como los que no aprovechan el envío en el día). Cuando estamos ganando el valor es winning, cuando no lo estamos haciendo es competing.
      • El campo boosts indica cuáles características de nuestra publicación están aportando a las chances de ganar. Las posibilidades son:
        • fulfillment: para publicaciones ubicadas en el centro de fulfillment
        • free_shipping: cuando la publicación ofrece envío gratuito
        • same_day_shipping: en casos que el artículo puede ser entregado en el día
        • free_installments: cuando se ofrecen cuotas sin interés para la publicación.
      • El campo price_to_win indica cuál es el precio (en la moneda actual de la publicación) para ser el ganador. Es decir que haciendo un PUT al recurso /items con el precio sugerido te aseguras de ser el ganador.

      En este llamada deberás utilizar un item_id de una publicación de catálogo, en caso de no hacerlo obtendrás un código de error 4XX.
      Además existen variables como la reputación que son utilizadas para determinar el ganador. Sin embargo, para un buen vendedor, serán las anteriores las variables utilizadas para determinar el ganador.
      Importante: en breve disponibilizaremos un recurso para recibir notificaciones cuando el vendedor se convierte en el ganador de un producto.

      Cómo conocer el listado de publicaciones para un Producto [BETA]

      Importante:
      Esta API está en BETA, la respuesta está cambiando en los próximos días, temporalmente para pruebas puedes usar la respuesta actual, sin embargo en esta guía documentamos las respuestas definitivas que verás en unos días.

      Si necesitas conocer cuáles son los artículos (de todos los vendedores) que compiten por las ventas de un producto en particular tienes un recurso que te entrega esa información.


      Llamada:

      curl -X GET https://api.mercadolibre.com/products/{product_id}/items

      Ejemplo:

      curl -X GET https://api.mercadolibre.com/products/MLB6309815/items

      Respuesta simplificada:

      {
        "paging": {
          "total": 3,
          "offset": 0,
          "limit": 100
        },
        "results": [
      	{ 
               "item_id": "MLB123456789",
            	 "category_id": "MLB73057",
               "seller_id": 111111111,
               "price": 560.00,
      
           },
           { 
               "item_id": "MLB345678912",
            	 "category_id": "MLB73057",
               "seller_id": 222222222,
               "price": 600.00,
           },
            { 
               "item_id": "MLB789123456",
            	 "category_id": "MLB73057",
               "seller_id": 333333333,
               "price": 650.00,
           }
        ]
        "available_filters": []
        “filters”: []
      }
      

      Ten en cuenta que “results” devolverá en primer lugar al ítem ganador y a continuación el resto de los ítems que están compitiendo.

       

      Filtrado [BETA]

      Pronto estará disponible la posibilidad de filtrar en esta API. El filtrado funcionará igual que en el recurso de Search (/sites/{site}/search) donde es posible utilizar los valores de available_filters como parámetro en la URL, por ejemplo:


      Ejemplo:

      curl -X GET https://api.mercadolibre.com/products/MLB6309815/items?shipping=free

      Crear una publicación de catálogo enlazada a una publicación existente implica crear un nuevo item del recurso /items 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 consulta a la publicación tradicional


      Llamada:

      curl -X GET https://api.mercadolibre.com/items/{item_id}?access_token={ACCESS_TOKEN}

      Ejemplo:

      curl -X GET https://api.mercadolibre.com/items/MLA1234?access_token={ACCESS_TOKEN}

      Respuesta:

      { 
        "variations": [ 
           { 
            "id": 36296213011, 
            "price": 50, 
            "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": "MLA987654321", 
               "variation_id": null, 
               "stock_relation": 1 
             }
           ]
          } 
        ], 
          "catalog_listing": false, 
          "item_relations": [] 
      }

       

      Ejemplo acotado de ítem de catálogo:

      Llamada:

      curl -X GET https://api.mercadolibre.com/items/{item_id}/?access_token={ACCESS_TOKEN}

      Ejemplo:

      curl -X GET https://api.mercadolibre.com/items/MLA1234?access_token={ACCESS_TOKEN}

      Respuesta:

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


      Cómo reconocer la publicación de catálogo y la original

      Para entender cuál es la publicación de catálogo y cuál la tradicional dispones en el recurso /ítems del campo catalog_listing. Si este tiene valor “true”, es una publicación de catálogo. Si tiene valor “false” es el ítem tradicional enlazado. Para ver la información completa del ítem, deberás utilizar access token.


      Cómo conocer la relación entre publicaciones enlazadas

      El campo item_relations en el recurso /items (con access token) te indicará qué publicaciones están enlazadas con la actual. 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.
      En un futuro podrían haber múltiples publicaciones enlazadas y la relación de decremento de stock podría ser distinta a 1. Ten en cuenta esto al diseñar tu sistema.

      Las preguntas en las publicaciones de catálogo se gestionan de la misma forma que en las publicaciones tradicionales pero no están sincronizadas. Esto quiere decir que las preguntas y respuestas que recibas por las publicaciones de catálogo no se verán en las publicaciones tradicionales y viceversa.

      En el site, cuando se realiza una pregunta en la página de producto, la consulta queda asociada al ítem que está ganando en ese momento únicamente y no se comparten con otro ítem que en otro momento gane la página de producto.

       

      Cómo gestionar las orders, visitas, etc.

      Las publicaciones de catálogo son ítems como cualquier otro, por ende la administración de las orders es igual a la de una publicación tradicional, solo que estas orders contarán con el tag "catalog" para diferenciarlas de las de Marketplace. En la respuesta del recurso /orders, el item_id hará referencia al cual se haya efectuado la compra.

      Las publicaciones enlazadas no comparten ninguna otra información además del stock. Por ejemplo, las visitas y ventas que están completamente separadas entre publicaciones.
      Ejemplo acotado de una order de catálogo:

       

      Llamada:

      curl -X GET https://api.mercadolibre.com/orders/{order_id}?access_token={ACCESS_TOKEN} 

      Ejemplo:

      curl -X GET https://api.mercadolibre.com/orders/1234567890?access_token={ACCESS_TOKEN} 

      Respuesta:

      {
        "id": 1234567890,
        "date_created": "2019-08-27T23:39:10.000-04:00",
        "date_closed": "2019-08-28T10:46:14.000-04:00",
        "last_updated": "2019-08-28T10:46:14.000-04:00",
        "manufacturing_ending_date": null,
        "feedback": {},
        "mediations": [
        ],
        "comments": null,
        "pack_id": null,
        "pickup_id": null,
        "order_request": {},
        "fulfilled": null,
        "total_amount": 16000,
        "total_amount_with_shipping": 16000,
        "paid_amount": 16000,
        "coupon": {},
        "expiration_date": "2019-09-25T10:46:14.000-04:00",
        "order_items": [
          {
            "item": {
              "id": "MLA123456789",
              "title": "Motorola G6 Plus 64 Gb",
              "category_id": "MLA1055",
              "variation_id": null,
              "seller_custom_field": "MO-CEL-N0011",
              "variation_attributes": [
              ],
              "warranty": "Garantía de fábrica: 12 meses",
              "condition": "new",
              "seller_sku": "MO-CEL-N0011"
            },
            "quantity": 1,
            "unit_price": 16000,
            "full_unit_price": 16000,
            "currency_id": "ARS",
            "manufacturing_days": null
          }
        ],
        "currency_id": "ARS",
        "payments": [],
        "shipping": {},
        "status": "paid",
        "status_detail": null,
        "tags": [
          "catalog",
          "not_delivered",
          "paid"
        ],
        "buyer": {},
        "seller": {},
        "taxes": {
          "amount": null,
          "currency_id": null
        }
      }
      

       

      Las ventas de las publicaciones de catálogo se gestionan de la misma forma que las de publicaciones tradicionales. Esto quiere decir que por cada venta que se genere desde un ítem de catálogo, se creará una orden con la misma información que contiene una venta de una publicación tradicional solo que podremos identificarlas con el tag de “catalog”. La orden tendrá asociado el ítem de catálogo. Y se enviarán notificaciones tanto cuando se cree como cuando se actualice la información de la misma.


      Ciclo de vida de las publicaciones enlazadas

      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, la publicación tradicional seguirá activa.

      Las publicaciones de catálogo se pueden crear y eliminar cuando sea necesario. Los vendedores con un comportamiento de ventas estable no ven afectada su capacidad de obtener las ventas de la página de producto por el historial de ventas de la publicación.

      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.

Forma parte de nuestra comunidad