Descuento individual
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.
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