Contenidos

→Recibe notificaciones de las publicaciones que cambian de estado en la competencia
→Conocer el precio para ganar
→Condiciones y el precio del ítem ganador">
    ↳Conocer la publicación que está ganando un producto
    ↳Listado de publicaciones para un producto
→Destaque especial en catálogo


Recibe notificaciones de las publicaciones que cambian de estado en la competencia

Con el tópico Item competition podrás suscribirte para comenzar a recibir notificaciones del cambio de estado de los ítems de catálogo, y te permitirá reconocer el ítem que modifica su estado de competencia a ganador o viceversa.

Para visualizar la información de la competencia y revisar las condiciones con las que el vendedor está compitiendo para ganar la página de producto, deberás utilizar el recurso /price_to_win para entender qué acciones deberían tomar.

Conoce más sobre cómo recibir notificaciones.


Conocer el precio para ganar

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 o 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, contamos con un recurso que te permitirá reconocer fácilmente el estado en el que se encuentra tu publicación de catálogo, esto puede variar ya que una publicación puede estar ganando, compitiendo o listada, este último estado cuenta con las razones por las cuales la publicación no compite.


Llamada:

curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/price_to_win?access_token=$ACCESS_TOKEN

Ejemplo de ítem compitiendo:

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

Respuesta:

"item_id": "MLA123456789",
    "current_price": 21499.0,
    "currency_id": "ARS",
    "price_to_win": 17600.0,
    "boosts": {
        "fulfillment": false,
        "free_installments": false,
        "free_shipping": true,
        "same_day_shipping": false
    },
    "status": "competing",
    "reason": [],
    "catalog_product_id": "MLA9652755"
}

Ejemplo de ítem ganando:

curl -X GET https://api.mercadolibre.com/items/MLB123456710/price_to_win?access_token=$ACCESS_TOKEN

Respuesta:

{
    "item_id": "MLA123456710",
    "current_price": 20499.0,
    "currency_id": "ARS",
    "price_to_win": 20499.0,
    "boosts": {
        "fulfillment": false,
        "free_installments": true,
        "free_shipping": true,
        "same_day_shipping": false
    },
    "status": "winning",
    "reason": [],
    "catalog_product_id": "MLA9652755"
}

Ejemplo de ítem no compitiendo:

curl -X GET https://api.mercadolibre.com/items/MLB123456710/price_to_win?access_token=$ACCESS_TOKEN

Respuesta:

{
   "item_id":"MLA123456710",
   "current_price":68000,
   "currency_id":"ARS",
   "price_to_win":null,
   "boosts":{
      "same_day_shipping":false,
      "fulfillment":false,
      "free_installments":false,
      "free_shipping":true,
      "cross_docking":false,
      "drop_off":true,
      "shipping_quarantine":false
   },
   "status":"listed",
   "reason":[
      "item_paused"
   ]
}

Leer la respuesta:

  • El campo status indica si el producto está ganando para el público general o para segmentos minoritarios como quienes que no aprovechan el envío en el día. Cuando está ganando, el valor es winning, sino será competing.
  • El campo boosts indica las características de la publicación que aportan chances de ganar, como:
    • same_day_shipping: Envíos en el dia por Mercado Envíos.
    • fulfillment: Mercado Envíos Full.
    • free_installments: Cuotas sin interés.
    • free_shipping: Envíos gratis por Mercado Envíos.
    • shipping_quarantine: Envío con normalidad.
    • shipping_collect: Mercado Envíos Colecta.
  • 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, la publicación será ganadora.
  • El campo reason mostrará información cuando el ítem no esté compitiendo, pudiendo identificar el motivo por el cual no lo está haciendo.

Valores posibles para reason

Reason Explicación
non_trusted_seller El vendedor no está en la whitelist de fraude. No puede competir. Aparece en los listados al final.
reputation_below_threshold El vendedor no alcanza la reputación mínima para poder ganar. No puede competir. Solamente aparece en los listados.
winner_has_better_reputation El vendedor tiene una reputación que podría competir pero hay un ganador con mejor reputación. Por el momento, solo aparece en los listados (caso amarillo con winner verde).
manufacturing_time El ítem tiene manufacturing time, solo aparece en los listados y no puede ganar porque el ganador tiene stock inmediato.
temporarily_winning_manufacturing_time El ítem tiene manufacturing time, está ganando temporalmente porque no hay competidores en el mismo nivel de reputación sin MF.
temporarily_competing_manufacturing_time El ítem tiene manufacturing time, esta compitiendo temporalmente porque no hay competidores en el mismo nivel de reputación sin MF, el ganador también tiene MF.
temporarily_winning_best_reputation_available El vendedor no es verde pero cuenta con una reputación que puede ganar y es la mejor oferta disponible. Está ganando temporalmente. Si aparece una mejor oferta, deja de ganar.
temporarily_competing_best_reputation_available El vendedor no es verde pero es la mejor reputación disponible, está compitiendo temporalmente. El ganador también es de la misma reputación. Si aparece un mejor vendedor, vuelve a solo estar listado.
item_paused El ítem está pausado, no puede listarse.
item_not_opted_in El ítem no ha hecho opt in, no puede listarse o es un ítem de test.

En esta 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.

Condiciones y el precio del ítem ganador

La tabla de competencia le permitirá a los vendedores comparar las condiciones de los ítems y mejorarlas. Con la nueva versión del recurso price_to_win puedes sumar vía API una tabla de competencia para comparar las condiciones de un ítem que se encuentra compitiendo y las del ganador. Con esta funcionalidad en tu desarrollo, los vendedores conocerán qué condiciones mejorar para ganar la página de producto.

Llamada:

curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/price_to_win?siteId=$SITE_ID&version=v2?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET https://api.mercadolibre.com/items/MLA123456789/price_to_win?siteId=MLA&version=v2?access_token=$ACCESS_TOKEN

Respuesta:

{
    "item_id": "MLA848886211",
    "current_price": 85990,
    "currency_id": "ARS",
    "price_to_win": 65200,
    "boosts": [
        {
            "id": "same_day_shipping",
            "status": "opportunity",
            "description": "Envíos en el dia por Mercado Envíos"
        },
        {
            "id": "fulfillment",
            "status": "opportunity",
            "description": "Mercado Envíos Full"
        },
        {
            "id": "free_installments",
            "status": "opportunity",
            "description": "Cuotas sin interés"
        },
        {
            "id": "free_shipping",
            "status": "not_boosted",
            "description": "Envíos gratis por Mercado Envíos"
        },
        {
            "id": "shipping_quarantine",
            "status": "boosted",
            "description": "Envío con normalidad"
        },
        {
            "id": "shipping_collect",
            "status": "boosted",
            "description": "Mercado Envíos Colecta"
        }
    ],
    "status": "competing",
    "reason": [],
    "catalog_product_id": "MLA14186099",
    "winner": {
        "item_id": "MLA849174940",
        "price": 76999,
        "currency_id": "ARS",
        "boosts": [
            {
                "id": "same_day_shipping",
                "status": "not_apply",
                "description": "Envíos en el dia por Mercado Envíos"
            },
            {
                "id": "fulfillment",
                "status": "boosted",
                "description": "Mercado Envíos Full"
            },
            {
                "id": "free_installments",
                "status": "boosted",
                "description": "Cuotas sin interés"
            },
            {
                "id": "free_shipping",
                "status": "not_boosted",
                "description": "Envíos gratis por Mercado Envíos"
            },
            {
                "id": "shipping_quarantine",
                "status": "boosted",
                "description": "Envío con normalidad"
            },
            {
                "id": "shipping_collect",
                "status": "opportunity",
                "description": "Mercado Envíos Colecta"
            }
        ]
    }
}

En la nueva versión del recurso, además de los campos ya conocidos en la versión anterior, sumamos la información del ítem que estamos consultando y la del ítem que se encuentra ganando (en caso de que el ítem que se consulta esté compitiendo).

Por lo tanto, en primer lugar visualizamos el precio y las condiciones de venta listadas dentro de boosts, con un estado y explicación, permitiendo comparar rápidamente con el segundo listado que hace referencia a la publicación que se encuentra ganando la página de producto.

Los boosts son los ya mencionados en los campos de respuesta de la versión anterior.
Ahora, puedes reconocer dentro del boost el estado de estos y dibujar una tabla comparativa según corresponda.

Estado del boost Detalle
boosted Tiene la condición de venta y actualmente aplica el boost.
not_boosted Tiene la condición de venta pero no es un boost que mejora las posibilidades de ganar.
opportunity No tiene la condición de venta. Si se aplica, mejoraría las chances de ganar.
not_apply La condición de venta no aplica como boost en el producto donde compite el ítem.
Nota:
Esta información te permitirá comparar rápidamente con el segundo listado sobre la publicación del ítem que se encuentra ganando la página de producto.

Conocer la publicación que está ganando un producto

Usando el recurso de /products/{product_id} podrás, además de conocer las características y estado del producto, reconocer mediante el campo buy_box_winner la publicación que está ganando la página de producto.


Listado de publicaciones para un producto

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": 7,
    "offset": 0,
    "limit": 100
  },
  "results": [
    {
      "item_id": "MLA824759321",
      "category_id": "MLA1055",
      "seller_id": 90205574,
      "price": 13999,
      "currency_id": "ARS",
      "sold_quantity": 0,
      "available_quantity": 1,
      "installments": {
        "quantity": 1,
        "amount": 13999,
        "rate": 0,
        "currency_id": "ARS"
      },
      "shipping": {
        "mode": "me2",
        "tags": [
          "mandatory_free_shipping"
        ],
        "free_shipping": true,
        "logistic_type": "fulfillment",
        "store_pick_up": false
      },
      "warranty": "Garantía de fábrica: 1 años",
      "condition": "new",
      "sale_terms": [
        {
          "id": "INVOICE",
          "name": "Facturación",
          "value_id": "6891885",
          "value_name": "Factura A",
          "value_struct": null
        },
        {
          "id": "WARRANTY_TYPE",
          "name": "Tipo de garantía",
          "value_id": "2230279",
          "value_name": "Garantía de fábrica",
          "value_struct": null
        },
        {
          "id": "WARRANTY_TIME",
          "name": "Tiempo de garantía",
          "value_id": null,
          "value_name": "1 años",
          "value_struct": {
            "number": 1,
            "unit": "años"
          }
        }
      ],
      "official_store_id": null,
      "original_price": null,
      "listing_type_id": "gold_special",
      "accepts_mercadopago": true,
      "seller_address": {
        "city": {
          "id": "TUxBQ0xBWmI3M2Q3",
          "name": "Santa Fe"
        },
        "state": {
          "id": "TUxBUFNBTmU5Nzk2",
          "name": "Santa Fe"
        },
        "neighborhood": {
          "id": "TUxBQk9UUjQyMjJa",
          "name": "Otros Barrios"
        }
      },
      "international_delivery_mode": "none",
      "tags": [
        "brand_verified",
        "extended_warranty_eligible",
        "good_quality_picture",
        "good_quality_thumbnail",
        "immediate_payment",
        "cart_eligible"
      ],
      "tier": ""
    },
    {},
    {},
    {},
    {},
    {},
    {}
  ]
}

Ten en cuenta que “results” devolverá los ítems que están compitiendo para ganar ese producto.

 

Filtrado

El filtrado funciona 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.


Actualmente cuentas con las siguientes opciones de filtrado:

Parámetros Valor Explicación
official_store all Para que se muestren solo productos ganadores de Tiendas Oficiales.
official_store_id id Para mostrar los productos ganadores de una Tienda Oficial.
discount 10-100 Para mostrar productos ganadores con descuento mayor o igual al 10%.
price 100-200 Para productos ganadores con precio entre 100 y 200
*100 para productos ganador con precio mayor o igual a 100.
*200 para productos ganadores con precio menor o igual a 200.
installments no_interest Para productos ganadores con cuotas sin interés.
shipping fulfillment Para productos ganadores con FBM.
shipping mercadoenvios Para productos ganadores sin FBM.
shipping_cost free Para productos ganadores con envío gratis.
shipping_time sameday/ nextday Debe ser usado junto con el query param b.buyer_zones el cual indica en qué zonas se encuentra el comprador.
seller_id id Obtener el ganador user_id

Ejemplo:

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

Con esta funcionalidad puedes acceder a un precio más competitivo de determinados productos para obtener un destaque especial y un precio más bajo para el comprador, ya que Mercado Libre financia la diferencia. Además, la publicación que esté ganando la página de producto tendrá el destaque especial “Recomendado" por Mercado Libre y el precio tachado con el descuento realizado:




Antes de consultar el precio competitivo, identifica las publicaciones que podrían aplicar al destaque especial con el tag best_price_eligible. Luego, realiza un GET y accede a los precios para acceder a la promoción.


Llamada:

curl -X GET https://api.mercadolibre.com/items/$ITEM_ID/best-price?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET https://api.mercadolibre.com/items/MLB12343223/best-price?access_token=$ACCESS_TOKEN

Respuesta:

{
  "winner_price": 1000,
  "final_price": 850,
  "financed_by_meli": 150,
  "is_rebate": true,
  "is_winner": true
}

winner_price: valor objetivo que el vendedor debe colocar para que Mercado Libre financie la diferencia.
final_price: valor final que tendrá el ítem con la diferencia financiada aplicada.
financed_by_meli: valor de la diferencia financiada por Mercado Libre.
is_rebate: indica si la publicación tiene aplicada la diferencia financiada.
is_winner: indica si la publicación está ganando la página de producto.

Cuando una publicación está accediendo al destaque especial se elimina el tag best price eligible de la misma.

Ademas, ten en cuenta que el monto que se obtendrá en la orden de la venta es el winner price, mientras que el monto que pagará el comprador es el final price.

Por último, te recomendamos estar suscrito al nuevo tópico best-price-eligible para recibir las notificaciones sobre los ítems que están compitiendo por acceder al precio más competitivo. Conoce más sobre cómo recibir notificaciones.


Podrá retornar solo un error status code 404 - NOT FOUND por:

o regístrate para recibir las últimas novedades sobre nuestra API