Administrar descuentos

Este recurso podrá ser utilizado por vendedores que tengan reputación verde para administrar los descuentos sobre sus ítems. En esta guía, aprenderás de manera fácil y rápida a desarrollar cómo aplicar, eliminar y consultar.

Importante:
En este momento, solo está disponible para vendedores de MLA, MLM y MLB.

Contenidos

→Aplicar descuento
    ↳Agregar descuento solo a usuarios nivel 1 y 2
    ↳Agregar descuento a los usuarios nivel 1 y 2 y a usuarios nivel 3 al 6
       ↳Parámetros
       ↳Consideraciones
→Eliminar descuento
→Consultar descuento
→Posibles errores


Aplicar descuento

Antes de aplicar un descuento, debes tener en cuenta diferentes reglas según los niveles relacionado al nuevo programa de beneficios de Mercado Puntos de nuestra plataforma. Estos son:

  • Nivel 1: Inicial
  • Nivel 2: Aficionado
  • Nivel 3: Avanzado
  • Nivel 4: Profesional
  • Nivel 5: Experto
  • Nivel 6: Leyenda

En los niveles 1 y 2, podrás poner los descuentos directamente y del 3 al 6, deberás incluir los niveles 1 y 2.

Para aplicar un descuento será necesario realizar un PUT tal como se muestra a continuación.


Agregar descuento solo a usuarios nivel 1 y 2

Llamada:

curl -X PUT-H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/promo/item/$ITEM_ID 
{
	"best_buyers_discount_percentage" : XX, 
	"buyers_discount_percentage" : XX, 
	"start_date": "AAAA-MM-DDT00:00:00", 
	"finish_date": "AAAA-MM-DDT00:00:00", 
	"discount_type:" "PRICE_DISCOUNT"
}

Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/promo/item/MLB1105211403
{
	"best_buyers_discount_percentage" : null,
	"buyers_discount_percentage" : 	10,
	"start_date": "2019-07-09T00:00:00",
  	"finish_date": "2019-07-15T00:00:00",
	"discount_type:" "PRICE_DISCOUNT"
}

Respuesta:

{
   "price": 90.00,
   "original_price": 100.00
}

Agregar descuento a los usuarios nivel 1 y 2 y a usuarios nivel 3 al 6

Llamada:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/promo/item/$ITEM_ID
{
	"best_buyers_discount_percentage" : XX, 
	"buyers_discount_percentage" : XX, 
	"start_date": "AAAA-MM-DDT00:00:00", 
	"finish_date": "AAAA-MM-DDT00:00:00", 
	"discount_type:" "PRICE_DISCOUNT"
}

Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/promo/item/MLB1105211403
{
	"best_buyers_discount_percentage" : 30,
	"buyers_discount_percentage" : 20,
	"start_date": "2019-07-09T00:00:00",
  	"finish_date": "2019-07-15T00:00:00",
	"discount_type:" "PRICE_DISCOUNT"
}

Respuesta:

{
    "price": 70,
    "original_price": 100
}

Parámetros

best_buyers_discount_percentage: mediante este atributo definimos los niveles del 3 al 6.
buyers_discount_percentage: mediante este atributo definimos los niveles 1 y 2.
start_date: fecha de inicio de la vigencia del descuento. (AAAA-MM-DDThh:mm:ss).
finish_date: fecha de fin de la vigencia del descuento. El plazo máximo de vigencia debe ser 7 días. (AAAA-MM-DDThh:mm:ss).
discount_type: tipo de descuento. Hoy está disponible PRICE_DISCOUNT.


Consideraciones

  • El tag loyalty_discount_eligible indica que el producto es elegible para aplicar un descuento, pero deberás tener en cuenta las reglas sobre cómo ofrecerlos.
  • Es posible segmentar la oferta de descuentos estableciendo un porcentaje superior a nuestros compradores leales (nivel 3 al 6 de Mercado Puntos) y un porcentaje inferior al resto de los compradores (nivel 1 al 2 de Mercado Puntos).
  • El descuento de nivel 1 y 2 debe ser como mínimo 5% menor al de usuarios 3 al 6, para descuentos de hasta 35%. Para descuentos superiores, la diferencia debe ser de mínimo 10%, es decir, damos mejores descuentos a los niveles más altos.
  • El descuento máximo debe ser menor a 80% y el descuento mínimo a ofrecer deberá ser mayor o igual al 5%.
  • Si se realiza una suba del precio del ítem, los descuentos serán quitados automáticamente.
  • Si al iniciar el descuento, el item se encuentra participando de un deal, dicho descuento no será aplicado hasta que finalice el deal asociado.

Conoce más sobre cómo ofrecer descuentos.

Nota:
Para usuarios TEST es necesario que la cuenta tenga reputación verde y el ítem tenga como mínimo 3 ventas con el precio actual.

Eliminar descuento

Con este recurso podrás eliminar solo descuentos del ítem y no podrás realizarlo para algunos niveles de usuarios.

Llamada:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/promo/item/$ITEM_ID

Ejemplo:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' http://api.mercadolibre.com/promo/item/MLB1105219833

Respuesta:

La respuesta a este servicio es un status 200 sin body en el response.


Consultar descuento

Para ver o consultar el descuento de un ítem haz el GET en la API de descuentos.

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http:/api.mercadolibre.com/promo/item/$ITEM_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' http:/api.mercadolibre.com/promo/item/MLA822573619

Respuesta:

{
    "id": "353-MLA822573619",
    "start_date": "2019-10-31T00:00:00",
    "finish_date": "2019-10-31T23:59:59",
    "seller_id": 468098195,
    "item_id": "MLA822573619",
    "price": 9000,
    "list_price": 10000,
    "prime_price": 8000,
    "status": "finished"
}

Estado del descuento

Los descuento pueden tener en los siguientes estados:

started: descuento activo.
finished: descuento finalizado.
pending: descuento programado
sync_requested: proceso de activación pendiente. En este caso, el descuento aún no se refleja en el producto.
restore_requested: proceso pendiente de eliminación del descuento.


Reasons:

Indican los motivos porqué los descuentos fueron finalizados:

item_feed_pause: La publicación fue pausada;
job_excecution: El período de vigencia terminó;
impact_pending_pause_rollback: Item fue pausado en el momento de iniciar el descuento;
item_feed_closed: El item fue finalizado, finaliza el descuento consecuentemente;
decrement_price: Cambio de precio que si hace superar el descuento por encima del máximo, se finaliza la promo;
increment_price: Incremento en el precio del item que finaliza el descuento.


Posibles errores

Recuerda el ACCESS TOKEN inválido not_authorized y sin ACCESS TOKEN, internal_server_error. Además, evita errores frecuentes, como no informar:

  • El descuento en el campo buyers_discount_percentage: null_discount.
  • La fecha de inicio del descuento start_date: null_promo_start_date.
  • La fecha de fin del descuento finish_date: null_promo_finish_date.

También pueden presentarse los siguientes mensajes en caso de falla de algunas de las validaciones sobre los descuentos que se intentan aplicar sobre el item:


Descuentos fuera de los rangos establecidos

{
"key":"buyer_discount_not_in_range",
"message": "buyers_discount_percentage parameter must be in range (5, 80)"
}
{
"key":"best_buyer_discount_not_in_range",
"message": "best_buyers_discount_percentage parameter must be in range (5, 80)"
}

Diferencias entre descuentos para niveles 1-2 y niveles 3-6 fuera de los márgenes establecidos

{
"key":"discount_below_10_percent_difference",
"message": "The best buyer discount difference cannot be below 10% when buyers discount is above 35%"
}
{
"key":"discount_below_5_percent_difference",
"message": "The discount difference cannot be below 5%"
}

Además, para algunos ítems a validar el descuento aplicado, podemos identificar si el descuento no es suficiente y el vendedor debe aplicar un descuento mayor. Para estos casos, devolveremos el siguiente error:

{
    "key": "error_credibility_price",
    "message": "The price is not credible."
}
o regístrate para recibir las últimas novedades sobre nuestra API