Documentation Mercado Libre

Check out all the necessary information about APIs Mercado Libre.
circulos azuis em degrade

Documentation

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