Desconto individual

Os vendedores que desejam oferecer uma oferta individual para seus itens com os seguintes recursos poderão fazê-lo. Eles terão a possibilidade de aplicar, eliminar e consultar o desconto. Lembre-se que eles devem ter uma reputação verde e ter como mínimo 3 vendas do produto.


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.
Nota:
Para usuários de TESTE é necessário que a conta tenha reputação verde e o item tenha no mínimo 3 vendas com o preço atual.



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

ou registre-se para receber as últimas notícias sobre nossa API