Volume discount campaigns (VOLUME)

Sellers are regularly invited to participate in different website campaigns. The main characteristic of this type of campaign is that a discount is applied when a given number of product items is reached. For example, “Get 4 Pay 3,” “2x1,” or “second item at half price”. Besides Mercado Libre assumes a percentage of the offered discount. If you received an invitation and want to join, use the resources below.



Contents

→Check details about a volume discount campaign
    ↳Discount types
    ↳Discount status
→Check items in a volume discount campaign
    ↳Item status
→Specify items in a volume discount campaign
→Edit items
→Delete items



Check details about a volume discount campaign

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/seller-promotions/promotions/P-MLM651001?promotion_type=VOLUME&user_id=739768312

Response:

{ 
   "id": "P-MLM651001",
   "type": "VOLUME",
   "status": "started",
   "start_date": "2021-07-19T16:00:00Z",
   "finish_date": "2021-12-05T04:00:00Z",
   "deadline_date": "2021-12-05T04:00:00Z",
   "name": "in CBT",
   "benefits": {
       "type": "VOLUME",
       "meli_percent": 5,
       "seller_percent": 20,
       "name": "4x3",
       "buy_quantity": 4,
       "pay_quantity": 3,
       "item_discount_percent": 25
   }
}

Specific campaign fields

Benefits: Promotion benefit details

  • type: benefit type.
  • meli_percent: percentage contributed by Mercado Libre.
  • seller_percent: percentage contributed by seller
  • name: rebate name.
  • buy_quantity: required quantity of items to get discount.
  • pay_quantity: quantity of items paid.
  • item_discount_percent: percentage of discount on each item.


  • Discount types

    Find below the different types of discount for this campaign type:

    • Get 2 pay 1
    • 70% OFF buying 2
    • 70% OFF in the 2nd unit


    • Volume discount status

      pending: promotion approved but not yet started.
      started: active promotion.
      finished: finished promotion.


      Check items in a volume discount campaign

      Request:

      curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/seller-promotions/promotions/P-MLM651001/items?user_id=739768312

      Response:

      {
         "results": [
             {
                 "id": "MLM902888695",
                 "status": "candidate",
                 "price": 89.99,
                 "original_price": 0,
                 "currency_id": "USD"
             },
             {
                 "id": "MLM902888708",
                 "status": "active",
                 "price": 130.48,
                 "original_price": 144.98,
                 "offer_id": "MLM902888708-e2c56324-ad86-5ed9-6b1d-2c1da0ac21a8"
                 "currency_id": "USD"
             }
         ],
         "paging": {
             "offset": 0,
             "limit": 0,
             "total": 2
         }
      }

      When a new campaign is created, all applicable items are selected. The initial item (status) is "candidate" with no assigned offer id. When the seller adds an item to the campaign, item status changes and a unique "offer_id" is assigned.



      Item status

      candidate: candidate item to participate in the promotion.
      programmed: approved and programmed promotion item.
      active: campaign active item.


      Specify items in a volume discount campaign

      Once you are invited to participate in this type of campaign, you can specify the products to be included.

      Request:

      curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
      -d 
      {
         "deal_id":"$DEAL_ID",
         "promotion_type":"$PROMOTION_TYPE"
      } 
      https://api.mercadolibre.com/marketplace/seller-promotions/items/$ITEM_ID?user_id=$USER_ID

      Example:

      curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
      -d 
      {
         "deal_id":"P-MLM651001",
         "promotion_type":"VOLUME"
      }
      https://api.mercadolibre.com/marketplace/seller-promotions/items/MLM902888708?user_id=739768312

      Response:

      {
        "offer_id": "MLM902888708-e2c56324-ad86-5ed9-6b1d-2c1da0ac21a8",
        "price": 130.48,
        "original_price": 144.98,
        "currency_id": "USD"
      }

      Parameters

      deal_id: promotion identification.
      promotion_type: type of promotion (VOLUME).



      Edit items

      Since prices cannot be changed directly, follow the steps below to change the price of an item included in a volume discount campaign.

      • Delete the item from the campaign
      • Change item price just like regular price synchronization
      • Add the item back to the campaign

      • Nota:
        - Since items included in volume discount campaigns (marketplace campaign) have no fixed price, when the price of an included item rises, it will be automatically removed from the offer and you will not be able to add it back.
        - We recommend checking if the item is participating in a volume discount campaign before making (manual or automatic) price changes.

        Delete items

        Request:

        curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/seller-promotions/items/$ITEM_ID?user_id=$USER_ID&promotion_type=VOLUME&deal_id=$DEAL_ID

        Example:

        curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/marketplace/seller-promotions/items/MLM902888708?user_id=739768312&promotion_type=VOLUME&deal_id=P-MLM651001

        Next: Co-funded campaigns