Price discount

To offer this discount it is necessary to:

• Have a green reputation.
• The item must have status equal to active.
• Condition equal to new.
• The exposure of the item can not be free.

Offer discount for an item

Request:

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/marketplace/seller-promotions/items/$ITEM_ID&user_id=$USER_ID
  --header 'version: v2' \
  --header 'X-Client-Id: \
  --header 'X-Caller-Id: \

Example:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'
  -d '{
     "deal_price": 20,
     "top_deal_price": 30,
     "start_date": "2020-10-19T00:00:00",
     "finish_date": "2020-10-20T00:00:00",
     "promotion_type": "PRICE_DISCOUNT"
  }'
  https://api.mercadolibre.com/marketplace/seller-promotions/items/MLM876768946&user_id=1317418851' --header 'version: v2' \
  --header 'X-Client-Id: 1317417907' \
  --header 'X-Caller-Id: 1317417907' \

Response:

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

Parameters

• DEAL_PRICE: discount percentage for all buyers.
• top_DEAL_PRICE: discount percentage for best buyers (Mercado Puntos 3 to 6 level). (optional)
• start_date: discount start date.
• finish_date: discount finish date.

Considerations

• Discount offers can be segmented, setting an overall percentage for all buyers and a top percentage for loyal buyers (Mercado Puntos 3 to 6 level).
• The overall discount should be, at least, 5% lower than level 3 to 6 user discount for up to 35% discounts. For higher discounts, the difference should be, at least, 10%; that is, better discounts are given to higher levels.
• The top discount should be lower than 80% and the lowest discount should be higher than or equal to 5%.
• If the item price goes up, discounts will be automatically removed.
• If when a discount starts an item is participating in a DEAL, it will not be applied until the related PRICE_DISCOUNT ends.
• The maximum term for this type of PRICE_DISCOUNT is 31 days.
• The start_date and end_date of the discount only consider the date itself, regardless of the time reported. By default, the discount starts at 00:00:00 on the start date and ends at 23:59:59 on the end date.

Item status

The table below shows the possible item statuses when you want to apply a price discount

Delete a price discount for an item

Request:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/seller-promotions/items/$ITEM_ID?promotion_type=$PROMOTION_TYPE&user_id=$USER_ID
  --header 'version: v2' \
  --header 'X-Client-Id: \
  --header 'X-Caller-Id: \

Example:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/seller-promotions/items/MLM876768946?promotion_type=PRICE_DISCOUNT&user_id=1317418851' 
  --header 'version: v2' \
  --header 'X-Client-Id: 1317417907' \
  --header 'X-Caller-Id: 1317417907' \

Remember that for individual offers (PRICE DISCOUNT), all the offers will be removed, you cannot remove by buyer level.

Response: Status 200 OK

Errors when offering discounts

{
  "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)"
}

Differences in discounts for 1-2 levels and 3-6 levels out of set ranges.

{
  "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%"
}

When discount is not enough and seller needs to apply a higher discount, we will go back.

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

Next: Deal of the Day DOD.