Desconto individual

Conteúdos

→Oferecer um desconto para uma publicação
    ↳Status do item
→Eliminar desconto individual para um item
→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 item

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

Eliminar 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

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.

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

Conheça mais sobre Desconto individual.

Seguinte: Ofertas do dia