Desconto individual

Para oferecer este desconto é necessário:

• Tenha uma reputação verde.
• O item deve ter um status igual a ativo.
• Condição igual a nova.
• A exibição do item não pode ser gratuita.
• E apenas para MLA esse tipo de desconto não está disponível nas categorias de livros.

Oferecer desconto

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 '{
   "deal_price": $DEAL_PRICE,
   "top_deal_price": $TOP_DEAL_PRICE,
   "start_date": "$START_DATE",
   "finish_date": "$FINISH_DATE",
   "promotion_type": "PRICE_DISCOUNT"
}'
https://api.mercadolibre.com/seller-promotions/items/$ITEM_IDapp_version=v2

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'
-d '{
   "deal_price": 20,
   "top_deal_price": 30,
   "start_date": "2023-04-19T00:00:00",
   "finish_date": "2024-04-20T00:00:00",
   "promotion_type": "PRICE_DISCOUNT"
}'
https://api.mercadolibre.com/seller-promotions/items/MLA876768946?app_version=v2'

Resposta:

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

Parâmetros

deal_price: preço do item com desconto para todos os compradores.
top_deal_price: preço do item com desconto para os melhores compradores (com Mercado Pontos nível 3 a 6) (opcional).
start_date: data de início do desconto.
finish_date: data de fim do desconto.

Considerações

• É possível segmentar a oferta de desconto, estabelecendo um preço geral para todos os compradores, e um menor para nossos compradores fiéis (com Mercado Pontos nível3 a 6).
• 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 31 dias.
• As datas de início (start_date) e de término do desconto (finish_date) consideram apenas a data em si, independente do horário informado. Por padrão, o desconto começa às 00:00:00 do dia de início e termina às 23:59:59 do dia de término.

Estado do item

Possíveis estado que os itens podem assumir quando deseja aplicar um desconto individual.

Excluir desconto individual para um item

Chamada:

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

Exemplo:

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

Para ofertas do tipo PRICE_DISCOUNT exclua todo o desconto, não é possível finalizar o desconto por níveis.

Resposta: Status 200 OK

Erros

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

Conheça mais sobre Desconto individual.

Próxima: Ofertas do dia