Pre-negotiated discount per item

Documentation Mercado Libre

Check out all the necessary information about APIs Mercado Libre.

Last update 28/12/2022

Pre-negotiated discount per item (PRE_NEGOTIATED)

Sellers are regularly invited to participate in different website campaigns. In this type of campaign the seller previously negotiates with Mercado Libre commercial representative a discount for certain items, setting price, offered discount and granted benefit. If you received an invitation and want to join, use the resources below.

Seller view

Check pre-negotiated campaign details

Example:

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

Response:

{
    "id": "P-MLM671010",
    "type": "PRE_NEGOTIATED",
    "status": "started",
    "start_date": "2021-07-23T19:00:00Z",
    "finish_date": "2021-12-05T04:00:00Z",
    "deadline_date": "2021-12-05T04:00:00Z",
    "name": "CBT Pre negotiated test",
    "offers": [
        {
            "id": "MLM902888699-7e0c12b4-b3fb-4067-9923-24537db3fac9",
            "original_price": 2196.7,
            "new_price": 1600,
            "status": "candidate",
            "start_date": "2021-07-30T17:00:00Z",
            "end_date": "2021-08-13T04:00:00Z",
            "benefits": {
                "type": "REBATE",
                "meli_percent": 9.1,
                "seller_percent": 18.1
            }
        }
    ]
}

Specific campaign fields

Offers: detail of pre-negotiated discount

id: offer identification.

original_price: original item price.

new_price: final item price.

status: promotion item status.

start_date: start date of offer in promotion.

end_date: end date of offer in promotion.

Benefits: promotion benefit details

type: benefit type.
meli_percent: percentage contributed by Mercado Libre.
seller_percent: percentage contributed by seller.

Status

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

Check items in a pre-negotiated campaign

Request:

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

Response:

{
    "results": [
        {
            "id": "MLM902888699",
            "status": "candidate",
            "price": 110.03,
            "original_price": 0,
            "currency_id": "USD",
            "offer_id": "MLM902888699-7e0c12b4-b3fb-4067-9923-24537db3fac9",
            "meli_percentage": 9.1,
            "seller_percentage": 18.1,
            "start_date": "2021-07-30T17:00:00Z",
            "end_date": "2021-08-13T04:00:00Z"
        }
    ],
    "paging": {
        "offset": 0,
        "limit": 0,
        "total": 1
    }
}

When a new campaign is created, all applicable items are selected. The initial item (status) is "candidate" with a unique "offer_id". When the seller adds an item to the campaign, item status changes and goes to programmed or active.

Item status

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

Accept a pre-negotiated discount per item

Once a discount has been negotiated for an item, the seller can accept the pre-negotiation with the following resource.

Request:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -d 
{
   "deal_id":"$DEAL_ID",
    "offer_id":"$OFFER_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-MLM671010",
    "offer_id":"MLM902888699-7e0c12b4-b3fb-4067-9923-24537db3fac9",
   "promotion_type":"PRE_NEGOTIATED"
}
https://api.mercadolibre.com/marketplace/seller-promotions/items/MLM902888699?user_id=739768312

Response:

{
   "offer_id": "MLM902888699-7e0c12b4-b3fb-4067-9923-24537db3fac9",
   "price": 80.14,
   "original_price": 110.02,
   "currency_id": "USD"
}

Parameters

deal_id: promotion identification.
offer_id: negotiated offer identification.
promotion_type: type of promotion (PRE_NEGOTIATED).

Delete pre-negotiated discount

Use this resource to Pre-negotiated Discount per Item

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=PRE_NEGOTIATED&deal_id=$DEAL_ID

Example:

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

Nota:

Remember that if an item pre-negotiated discount is removed, the item will no longer be a candidate.

Next post: Co-funded campaigns