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 descuento
→Consultar descuento
→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

Além disso, o item poderá oferecer descontos com a seguinte tag loyalty_discount_eligible, assim representa que cumpre com todas as considerações mencionadas no final da documentação.

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

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

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

  • O "original_price" só é apurado com o novo valor quando o desconto altera o preço original, isto é, isso ocorre quando o desconto é feito nos níveis 1 e 2. Se o preço original não for modificado, só será acrescentada a informação de descontos em sales_terms na consulta de itens.
  • Segmentar a oferta de descontos estabelecendo uma porcentagem superior a nossos compradores fiéis (nível 3 a 6 do Mercado Pontos) e uma porcentagem menor aos outros compradores (nível 1 a 2 do Mercado Pontos).
  • Se o seller adicionar um desconto, esse item poderá ser acessado a partir da landing do marketplace de descontos.
  • Após termos alterado o preço original do item, os descontos serão automaticamente apagados.

Saiba mais sobre como oferecer descontos.


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.


Considerações

  • O item deve ser de um site no qual o feature esteja ligado. Código erro failed_rules: EnabledSiteRule
  • O desconto de nível 1 e 2 deve ser, no mínimo, 5% menor que o de usuários 3 a 6, para porcentagens de desconto de até 35%, caso contrário a diferença deve ser no mínimo 10%. Isto é, oferecemos melhores descontos aos níveis mais altos. Código erro failed_rules: PricePercentageDeltaRule
  • O item do usuário deve ter um mínimo de 3 vendas nos últimos 30 e as vendas devem estar num limiar de preço. Código erro failed_rules: ItemPriceVsMaxSalesPriceRule e ItemMoreEqThanXSalesRule
  • Os sellers habilitados têm reputação verde e verde claro. Código erro failed_rules: UserReputationRule
  • O desconto máximo deve ser menor a 80%. Código erro failed_rules: MaximumDiscountPercentageRule
  • Desconto mínimo de 5%. Código erro failed_rules: ItemValidDiscountRule
  • O item deve ser novo. Código erro failed_rules: ItemConditionRule
  • O item não pode estar em um deal. Código erro failed_rules: ItemNotInDealRule
  • O item deve ter, no mínimo, 5 reviews e a média deles deve ser >= 3. Código erro failed_rules: ItemRatingRule
  • O desconto só será aplicado para itens com preço maior ou igual ao estabelecido em cada site. Em caso de estar por abaixo de range, você receberá um erro de API: ItemMinPriceRuleTask
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.

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.