Última actualización 15/03/2023

Descuento individual

Los vendedores que deseen ofrecer una oferta particular para sus ítems con los siguientes recursos podrán hacerlo. Tendrán la posibilidad de aplicar, eliminar y consultar el descuento.
Deben contar con reputación verde y tener una venta del producto.




Ofrecer un descuento para un ítem

Para este tipo de oferta, debes cumplir algunos requisitos. Conoce más sobre cómo ofrecer descuentos.

Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'
-d '{
   "discount_percent": $DISCOUNT_PERCENT,
   "top_discount_percent": $TOP_DISCOUNT_PERCENT,
   "start_date": "$START_DATE",
   "finish_date": "$FINISH_DATE",
   "promotion_type": "PRICE_DISCOUNT"
}'
'https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID'

Ejemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'
-d '{
   "discount_percent": 20,
   "top_discount_percent": 30,
   "start_date": "2020-10-19T00:00:00",
   "finish_date": "2020-10-20T00:00:00",
   "promotion_type": "PRICE_DISCOUNT"
}'
'https://api.mercadolibre.com/seller-promotions/items/MLA876768946'

Respuesta:

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

Parámetros

discount_percent: porcentaje de descuento para todos los compradores.
top_discount_percent: porcentaje de descuento para los mejores compradores (con nivel Mercado Puntos 3 a 6). (opcional)
start_date: fecha de inicio del descuento.
finish_date: fecha de fin del descuento.


Consideraciones

  • Es posible segmentar la oferta de descuentos estableciendo un porcentaje general para todos los compradores, y una superior solo para nuestros compradores leales (con nivel 3 al 6 de Mercado Puntos).
  • El descuento general debe ser como mínimo 5% menor al descuento de usuarios de nivel 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 ítem se encuentra participando de un DEAL, dicho descuenConsideto no será aplicado hasta que finalice el DEAL asociado.
  • El plazo máximo para un descuento PRICE_DESCOUNT es de 21 días.

Nota:
Ten en cuenta que para realizar pruebas, es necesario que el usuario de TEST tenga reputación verde y el ítem tenga como mínimo 1 venta con el precio actual.

Estado del ítem

En la siguiente tabla puedes encontrar los posibles estados que pueden tomar los ítems cuando deseas aplicarle un descuento individual.

Estado Descripción
started Descuento activo en el ítem.
finished Descuento finalizado.
pending Descuento programado.
sync_requested Proceso de activación pendiente.
restore_requested Proceso pendiente de eliminación del descuento.
candidate Ítem candidato para participar en la promoción.


Eliminar descuento individual a un ítem

Llamada:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?promotion_type=$PROMOTION_TYPE

Ejemplo:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA876768946?promotion_type=PRICE_DISCOUNT

Recuerda que para las ofertas individuales (PRICE DISCOUNT) eliminarás toda la oferta, no podrás eliminar por niveles del comprador.


Respuesta: Status 200 OK



Errores al ofrecer un descuento

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":"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%"
}

Cuando el descuento no sea suficiente y el vendedor deba aplicar un descuento mayor, retornaremos:

{
    "key": "error_credibility_price",
    "message": "The price is not credible."
}

Conoce más sobre Descuentos en tus publicaciones.


Next post: Ofertas del día