Desconto individual
Conteúdos
→Oferecer um desconto para uma publicação
↳Status do iten
→Eliminar desconto individual para um iten
→Erros ao oferecer um desconto
Oferecer um desconto para uma publicação
Para este tipo de oferta, você deve atender a alguns requisitos. Saiba mais sobre como oferecer descontos.
Chamada:
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'
Exemplo:
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'
Resposta:
{
"price": 70,
"original_price": 100
}
Parâmetros
discount_percent: percentual de desconto para todos os compradores.
top_discount_percent: percentual de desconto para os melhores compradores (com nível Mercado Pontos 3 a 6). (opcional)
start_date: data de início do desconto.
finish_date: data de fim do desconto.
Considerações
- A tag loyalty_discount_eligible indica que o produto está elegível para aplicação de um desconto, mas ainda é necessário considerar as outras regras de como oferecer.
- É possível segmentar o desconto estabelecendo um percentual geral para todos os compradores, e uma superior só para nossos compradores leais ( com nível 3 a 6 de Mercado Pontos).
- O desconto geral deve ser no mínimo 5% menor que o desconto de usuários dos níveis 3 a 6, para descontos de até 35%. Para descontos maiores que 35%, a diferença deve ser de no mínimo 10%, ou seja, garantimos melhores descontos aos níveis mais altos.
- O desconto máximo deve ser menor a 80% e o desconto mínimo maior o igual a 5%.
- Se o preço do produto é alterado para mais, os descontos serão removidos automaticamente.
- Se o produto estiver associado a uma oferta do tipo DEAL na data de início do desconto, o desconto do tipo PRICE_DESCOUNT só será aplicado quando a outra oferta for finalizada.
- O prazo máximo para um desconto do tipo PRICE_DESCOUNT é de 7 dias.
Status do iten
Possíveis status que os itens podem assumir quando deseja aplicar um desconto individual.
Status | Descrição |
---|---|
started | Desconto ativo no ítem. |
finished | Desconto finalizado. |
pending | Desconto programado. |
sync_requested | Proceso de ativação pendiente. |
restore_requested | Proceso definalização do desconto pendiente. |
Eliminar desconto individual para um iten
Chamada:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?promotion_type=$PROMOTION_TYPE
Exemplo:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA876768946?promotion_type=PRICE_DISCOUNT
Para ofertas do tipo PRICE_DISCOUNT finaliza todo o desconto, não é possível finalizar o desconto por níveis..
Respuesta: Status 200 OK
Erros ao oferecer um desconto
Desconto fora do range estabelecido.
{
"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)"
}
Diferença entre descontos para níveis 1-2 e níveis 3-6 fora da margem estabelecida
{
"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%"
}
Quando o desconto não for suficiente e o vendedor precisar aplicar um desconto maior, retornaremos:
{
"key": "error_credibility_price",
"message": "The price is not credible."
}