Gerenciar descontos

Esse recurso pode ser utilizado por vendedores com reputação verde para gerenciar descontos em seus itens. Com nosso guia, você aprenderá rápida e facilmente como aplicar, remover e consultar.

Importante:
No momento, só está disponível para vendedores de MLA, MLM e MLB.

Conteúdos

→Aplicar desconto
    ↳Adicionar desconto somente a usuários nível 1 e 2
    ↳Adicionar desconto a usuários nível 1 e 2 e a usuários nível 3 a 6
      ↳Parâmetros
      ↳Considerações
→Remover desconto
→Consultar desconto
→Considerações
→Possíveis erros


Aplicar desconto

Antes de aplicar um desconto, você deve levar em conta as diferentes regras diferentes de acordo com os níveis relacionados ao novo programa de benefícios do Mercado Pontos da nossa plataforma. Eles são:

  • Nível 1: Iniciante
  • Nível 2: Entusiasta
  • Nível 3: Avançado
  • Nível 4: Profissional
  • Nível 5: Especialista
  • Nível 6: Lendário

Nos níveis 1 e 2, você pode colocar os descontos diretamente e do 3 a 6, deve incluir os níveis 1 e 2. Para aplicar um desconto será necessário realizar um PUT, como mostrado abaixo.


Adicionar desconto somente a usuários nível 1 e 2

Chamada:

curl -X PUT http://api.mercadolibre.com/promo/item/$ITEM_ID?access_token=$ACCESS_TOKEN 
{
	"best_buyers_discount_percentage" : XX, 
	"buyers_discount_percentage" : XX, 
	"start_date": "AAAA-MM-DDT00:00:00", 
	"finish_date": "AAAA-MM-DDT00:00:00", 
	"discount_type:" "PRICE_DISCOUNT"
}

Exemplo:

curl -X PUT http://api.mercadolibre.com/promo/item/MLB1105211403?access_token=$ACCESS_TOKEN
{
 "best_buyers_discount_percentage" : null,
 "buyers_discount_percentage" :  10,
 "start_date": "2020-02-01T00:00:00",
   "finish_date": "2020-03-25T00:00:00",
 "discount_type": "PRICE_DISCOUNT"
}

Resposta:

{
   "price": 90.00,
   "original_price": 100.00
}

Adicionar desconto a usuários nível 1 e 2 e a usuários nível 3 a 6

Chamada:

curl -X PUT http://api.mercadolibre.com/promo/item/$ITEM_ID?access_token=$ACCESS_TOKEN 
{
	"best_buyers_discount_percentage" : XX, 
	"buyers_discount_percentage" : XX, 
	"start_date": "AAAA-MM-DDT00:00:00", 
	"finish_date": "AAAA-MM-DDT00:00:00", 
	"discount_type:" "PRICE_DISCOUNT"
}

Exemplo:

curl -X PUT http://api.mercadolibre.com/promo/item/MLB1105211403?access_token=$ACCESS_TOKEN
{
	"best_buyers_discount_percentage" : 30,
	"buyers_discount_percentage" : 20,
	"start_date": "2019-07-09T00:00:00",
  	"finish_date": "2019-07-15T00:00:00",
	"discount_type:" "PRICE_DISCOUNT"
}

Resposta:

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

Parâmetros

best_buyers_discount_percentage: mediante este atributo definimos que é para níveis 3 a 6.
buyers_discount_percentage: mediante este atributo definimos que é para níveis 1 e 2.
start_date: Data de início da vigência do desconto (AAAA-MM-DDThh:mm:ss).
finish_date:Data de fim da vigência do desconto. O intervalo de vigência deve ser de no máximo 30 dias (AAAA-MM-DDThh:mm:ss).
discount_type: tipo de desconto. Hoje só está disponível PRICE_DISCOUNT.


Considerações

  • A TAG loyalty_discount_eligible indica que o produto é elegível para aplicar um desconto, mas o vendedor tem que ter em conta todas as regras de como fazer.
  • É possível segmentar o desconto estabelecendo uma porcentagem maior a nossos compradores mais leais (nível 3 a 6 de Mercado Pontos) e um percentual menor ao resto dos compradores (nível 1 e 2 de Mercado Pontos).
  • O desconto dos níveis 1 e 2 deve ser no mínimo 5% menor ao dos usuários de 3 a 6, para desocntos até 35%, para descontos superiores a diferença deve ser de 10%. Com isso, garatimos os melhores descontos aos compradores mais fiéis.
  • O desconto máximo deve ser menor que 80% e o desconto mínimo deve ser maior a 5%.
  • Se o preço do produto for aumentado, o desconto é automaticamente retirado.
  • Se ao aplicar um desconto o item estiver participando de uma campanha (deals), o desconto só será aplicado quando a campanha for finalizada.

Saiba mais sobre como oferecer descontos.

Nota:
Para usuários de TESTE é necessário que a conta esteja com reputação verde e o item tenha no mínimo 3 vendas com o preço atual.

Remover desconto

Com este recurso é possível remover todos os descontos do item.


Chamada:

curl -X DELETE http://api.mercadolibre.com/promo/item/$ITEM_ID?access_token=$ACCESS_TOKEN

Exemplo:

curl -X DELETE http://api.mercadolibre.com/promo/item/MLB1105219833?access_token=$ACCESS_TOKEN

Resposta:

A resposta virá com um status 200 sem body na resposta.


Consultar desconto

Para ver o desconto de um item é necessário fazer o GET no recurso de Itens, onde será possível consultar os campos: price, original_price e sales_terms.

Chamada:

curl -X GET http:/api.mercadolibre.com/promo/item/$ITEM_ID?access_token=$ACCESS_TOKEN

Exemplo:

curl -X GET http:/api.mercadolibre.com/promo/item/MLA822573619?access_token=$ACCESS_TOKEN

Resposta:

{
    "id": "353-MLA822573619",
    "start_date": "2019-10-31T00:00:00",
    "finish_date": "2019-10-31T23:59:59",
    "seller_id": 468098195,
    "item_id": "MLA822573619",
    "price": 9000,
    "list_price": 10000,
    "prime_price": 8000,
    "status": "finished"
}

Status do desconto

Os descontos podem estar nos seguintes status:

started: desconto ativo.
finished: desconto finalizado.
pending: desconto programado.
sync_requested: processamento de ativação pendente, nesse caso o desconto ainda não reflete no produto.
restore_requested: pendente processamento de remoção do desconto.


Possíveis erros

Lembre o ACCESS TOKEN inválido not_authorized e sem ACCESS TOKEN, internal_server_error. Além disso, evite erros frequentes, como não relatar:

  • O desconto no campo buyers_discount_percentage: null_discount.
  • A data de início do desconto start_date: null_promo_start_date.
  • A data final do desconto finish_date: null_promo_finish_date.

Caso as regras para aplicar um desconto não sejam respeitadas, apresentaremos as seguintes mensagens:


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

Além disso, para alguns itens ao validar o desconto aplicado, podemos identificar que o desconto não é o suficiente e o vendedor deve aplicar um desconto maior. Para esses casos retornaremos o seguinte erro:

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