Documentation Mercado Libre
Check out all the necessary information about APIs Mercado Libre.
Documentation
Pre-negotiated discount per item (PRE_NEGOTIATED)
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
- 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
Next post: Co-funded campaigns