Precios de productos
Gestiona los precios relacionados a un producto y calcula el mejor precio para un producto dependiendo la fecha y contexto.
Obtener precio de venta actual
Identifica el precio de venta de un producto, utilizando el recurso items/$ITEM_ID/sale_price enviando el parámetro context de acuerdo al canal de la publicación que quieres consultar, se detallarán los posibles valores de este parámetro más adelante.
Valores posibles para el parámetro context:
- channel_marketplace
- channel_mshops
- channel_proximity (productos publicados en Mercado Pago)
- buyer_loyalty_3
- buyer_loyalty_4
- buyer_loyalty_5
- buyer_loyalty_6
Para conocer el channel del producto puede consultar el array de channels en el recurso /items.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/sale_price?context=$CONTEXT
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLB3191390879/sale_price?context=channel_marketplace
Respuesta:
{
"price_id": "1",
"amount": 800,
"regular_amount": null,
"currency_id": "BRL",
"reference_date": "2023-02-15T00:23:53Z"
}
Descripción de los campos
- price_id: ID del precio.
- amount: precio actual del producto.
- regular_amount: precio original del producto, en casos que tenga promoción.
- currency_id: ID de la moneda a la que se refiere el campo amount y regular_amount.
- reference_date: fecha para la cual está calculando el precio de venta.
Obtener precios del producto
Esta API trae todos los precios originales que puede tener un producto en los diferentes canales donde está publicado.
Llamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/$ITEM_ID/prices
Ejemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/items/MLB3191390879/prices?
Respuesta:
{
"id": "MLB3191390879",
"prices": [
{
"id": "1",
"type": "standard",
"amount": 800,
"regular_amount": null,
"currency_id": "BRL",
"last_updated": "2023-02-14T18:43:58Z",
"conditions": {
"context_restrictions": [
"channel_marketplace"
],
"start_time": null,
"end_time": null
}
},
{
"id": "2",
"type": "standard",
"amount": 650,
"regular_amount": null,
"currency_id": "BRL",
"last_updated": "2023-02-14T18:43:58Z",
"conditions": {
"context_restrictions": [
"channel_mshops"
],
"start_time": null,
"end_time": null
}
}
]
}
Descripción de los campos
- id: ID del producto.
- price: monto definido por el vendedor para la publicación en ese contexto.
- type: tipo de precio. Standard: valor indicado por el vendedor sin promociones.
- amount: precio del producto.
- regular_amount: precio original del producto, en casos que tenga promoción.
- currency_id: ID de la moneda a la que se refiere el campo amount regular_amount.
- conditions: condiciones bajo las cuales puede aplicar el precio en cuestión.
- context_restrictions: canal que se aplica el precio.
Notificaciones sobre precios
Para recibir notificaciones sobre los precios, debes suscribirte al tópico items_prices, después de recibir la notificación debe consultar el recurso de /sale_price.