Competencia 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.

Cómo 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

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"
   ]
}

Cómo 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.

Conoce las 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.

Cómo conocer el 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