Administrar descuentos
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.
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."
}