Last update 25/08/2022

Manage Promotions

Use the /seller-promotions resource to centralize all the available promotion types, such as traditional campaigns (DEAL), Mercado Libre co-funded campaigns (MARKETPLACE_CAMPAIGN), price discounts (PRICE_DISCOUNT), lightning deals (LIGHTNING), deals of the day (DOD), volume discount (VOLUME), and pre-negotiated discount per item (PRE NEGOTIATED). Besides the new types of deals that we will make available.


Promotion Characteristics


Campaign type Name Price definition Price suggestion Bonus MELI Stock to participate Deadline Approval
Traditional DEAL User defines No No No Yes Yes
Co-funded campaigns MARKETPLACE CAMPAIGN User accepts No Yes No Yes No
Deals of the day DOD User accepts Yes No Yes, informative No No
Lightning deals LIGHTNING User defines Sim No Yes, required No No
Volume discount VOLUME User accepts No Yes No Yes No
Pre-negotiated discount per item PRE_NEGOTIATED User agree and accepts No Yes Yes Yes No


Promotion Availability by Country

Site Traditional campaigns
(DEAL)
Co-funded campaigns
(MARKETPLACE CAMPAIGN)
Price discounts
(PRICE DISCOUNT)
Volume discoun
(VOLUME)
Pre-negotiated discount per item
(PRE_NEGOTIATED)
Deals of the day
(DOD)
Lightning deals
(LIGHTNING)
MLA
MLB
MLM
MCO
MLC
MLU
MPE
MLV

Check Available Promotions for Sellers

Reminder - a user can have more than one and different types invitations.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/users/$USER_ID'

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/users/631366846'

Response:


    {
	"results": [{
			"id": "MLB686",
			"type": "DEAL",
			"status": "started",
			"start_date": "2020-02-04T17:50:00Z",
			"finish_date": "2022-10-31T17:20:00Z",
			"deadline_date": "2020-01-30T02:00:00Z",
			"name": "HOTSALE"
		},
		{
			"id": "DOD-MLB1000",
			"type": "DOD",
			"status": "started",
			"start_date": "2000-01-01T00:00:00.000Z"
		},
		{
			"id": "LGH-MLB1000",
			"type": "LIGHTNING",
			"status": "started",
			"start_date": "2000-01-01T00:00:00.000Z"
		},
		{
			"id": "P-MLB379009",
			"type": "VOLUME",
			"status": "started",
			"start_date": "2021-03-25T16:40:00Z",
			"finish_date": "2021-04-30T18:00:00Z",
			"name": "test volume MLB",
			"benefits": {
				"type": "VOLUME",
				"meli_percent": 8,
				"seller_percent": 17,
				"name": "4x3",
				"buy_quantity": 4,
				"pay_quantity": 3,
				"item_discount_percent": 25
			}
		},
		{
			"id": "P-MLB380001",
			"type": "VOLUME",
			"status": "started",
			"start_date": "2021-03-25T19:00:00Z",
			"finish_date": "2021-04-30T18:00:00Z",
			"name": "test volume MLB BNSP",
			"benefits": {
				"type": "VOLUME",
				"meli_percent": 10,
				"seller_percent": 30,
				"name": "buy 4 save 40%",
				"buy_quantity": 4,
				"item_discount_percent": 40
			}
		},
		{
			"id": "P-MLB380002",
			"type": "VOLUME",
			"status": "started",
			"start_date": "2021-03-25T19:30:00Z",
			"finish_date": "2021-04-30T18:00:00Z",
			"name": "test volume MLB SPONTH",
			"benefits": {
				"type": "VOLUME",
				"meli_percent": 8,
				"seller_percent": 17,
				"name": "save 50% on 2nd",
				"buy_quantity": 2,
				"item_discount_percent": 25
			}
		},
		{
			"id": "P-MLB382001",
			"type": "MARKETPLACE_CAMPAIGN",
			"status": "started",
			"start_date": "2021-03-25T22:36:00Z",
			"finish_date": "2021-04-30T18:00:00Z",
			"name": "test cofondeada",
			"benefits": {
				"type": "REBATE",
				"meli_percent": 2,
				"seller_percent": 8
			}
		},
		{
			"id": "P-MLM394001",
			"type": "PRE_NEGOTIATED",
			"status": "started",
			"start_date": "2021-03-30T18:30:15.525Z",
			"finish_date": "2021-12-27T17:59:59.525Z",
			"deadline_date": "2021-05-27T17:59:59.525Z",
			"name": "Prueba descuento x item sin benefit"
		}
	],
	"paging": {
		"offset": 0,
		"limit": 50,
		"total": 7
	}
}

Response fields

id: promotion ID code.
type: promotion type (DEAL, MARKETPLACE_CAMPAIGN, DOD, LIGHTNING, VOLUME).
status: Status.
start_date: promotion start date.
finish_date: promotion finish date.
deadline_date: maximum term to add promotional items.
name: promotion name.
deadline_date: maximum time limit for accepting the invitation to participate in the promotion.
benefits: promotion benefit configuration.


Consult candidate items

The /seller-promotions/candidates resource allows you to identify the items invited to participate in a promotion. Whenever an item obtains the status of "candidate" in a promotion a notification is sent with the candidate_id, with this resource it is possible to identify the item, the promotion and the status.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'  https://api.mercadolibre.com/seller-promotions/candidates/$CANDIDATE_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN'  https://api.mercadolibre.com/seller-promotions/candidates/CANDIDATE- MLB1254949426-803130663

Response:

{    
    "id": "CANDIDATE-MLB1254949426-803130663",    
    "item_id": "MLB1254949426",    
    "promotion_id": "P-MLB4629001",    
    "type": "MARKETPLACE_CAMPAIGN",    
    "status": {        
    "id": "candidate"    
  } 
}

Response fields

id: candidate identification code.

item_id: item associated with the candidate.

promotion_id: promotion id.

type: promotion type (DEAL, MARKETPLACE_CAMPAIGN, DOD, LIGHTNING, VOLUME, PRICE DISCOUNT, PRE_NEGOTIATED).

status: status of the applicant.

Note:
The candidate id is obtained through the notification of the "public candidate" topic.

Check offers

Use the /seller-promotions/offers resource allows you to identify changes in the offer of an item. All changes are sent by notifications with the offer_id, and it is possible to identify the item, the promotion, and the status.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/offers/$OFFERS_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/offers/OFFER-MLB1970246686-42701792

Response:

{    
    "id": "OFFER-MLB1970246686-42701792",    
    "item_id": "MLB1970246686",    
    "promotion_id": "P-MLB3329001",    
    "type": "DEAL",    
    "status": {        
    "id": "ACTIVE"    
  } 
}

Response fields

id: Identification code of the offer.
item_id: Item associated with the offer.
promotion_id: Promotion id.
type: type of promotion (DEAL, MARKETPLACE_CAMPAIGN, DOD, LIGHTNING, VOLUME, PRICE DISCOUNT, PRE_NEGOTIATED).
status: status of the offer (programmed, active, e inactive).

Nota:
You get the id of the offer through a notification in the public offers.

Check Promotion Details

Perform the following query to access the specific details of traditional campaigns, co-funded campaigns, and volume discounts.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTION_ID?promotion_type=$PROMOTION_TYPE'

Learn more about traditional campaigns, co-funded campaign, volume discount and pre-negotiated discount per item.


Status

Find below the different and possible promotion type statuses:


Check Promotion Items

Perform the query below to check the items included in a given promotion:

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTIONS_ID/items?promotion_type=PROMOTION_TYPE'

You can also check the items included in a traditional campaign, a co-funded campaign and volume discount items.

Check deal of the day items, lightning deal items e and pre-negotiated discount per item campaign status here. .


Filters

You can apply filters by item or status.


Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTION_ID/items?promotion_type=$PROMOTION_TYPE&status=$STATUS&item_id=$ITEM_ID

Filter example by item:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/MLA1111/items?promotion_type=DEAL&item_id=MLA604400000

Response:

{
   "results": [
       {
           "id": "MLA604400000",
           "status": "started",
           "price": 23968,
           "original_price": 28549
       }
   ],
   "paging": {...}
}

Example of filter by status started:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' /seller-promotions/promotions/MLA1111/items?promotion_type=DEAL&status=started

Response:

{
   "results": [
       {
            "id": "MLA639970000",
            "status": "started",
            "price": 4037,
            "original_price": 4427
        },
        {
            "id": "MLA639973333",
            "status": "started",
            "price": 6007,
            "original_price": 6587
        },
],
   "paging": [...]
}
Note:
The status that can be filtered are: started, finished, pending and candidate.

Pagination

To perform pagination, you must use the searchAfter parameter. The value sent in this parameter is always the last id of the item returned to the previous call.


Note:
If you do not use the limit parameter, 50 items of the total will be returned by default. You can add a maximum limit of 50.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTIONS_ID/items?promotion_type=$PROMOTION_TYPE&searchAfter=$ITEM_ID'

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/promotions/MLB9377/items?promotion_type=DEAL&searchAfter=MLB2674512267'

Response:

"results": [
       {
           "id": "MLB2674512266",
           "status": "candidate",
           "price": 0,
           "original_price": 0
       },
       {
           "id": "MLB2674506199",
           "status": "candidate",
           "price": 0,
           "original_price": 0
       },
       {
           "id": "MLB2674506138",
           "status": "candidate",
           "price": 0,
           "original_price": 0
       },
       {
           "id": "MLB2674505931",
           "status": "candidate",
           "price": 0,
           "original_price": 0
       },
       {
           "id": "MLB2674505924",
           "status": "candidate",
           "price": 0,
           "original_price": 0
 
 […]
 
 "paging": {
       "searchAfter": "MLB2674512267",
       "limit": 50,
       "total": 14424
   }
}


Participate in a Promotion

You can participate in different types of promotions and even offer an item price discount by:


Check Item Promotions

For DEALS we will return items with status = approved only.
We will not approve test campaigns, which will remain with pending_approval, i.e., you will not see the promotion price.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA876768946

Resposta:



{
"results":
[
  {
    "id": "2864-MLB876768946",
    "type": "PRICE_DISCOUNT",
    "status": "started",
    "price": 700,
    "top_price": 650,
    "start_date": "2020-09-09T00:00:00",
    "finish_date": "2020-09-15T00:00:00"
  },
  {
    "id": "MLB686",
    "type": "DEAL",
    "status": "started",
    "price": 680,
    "start_date": "2021-03-04T17:50:00Z",
    "finish_date": "2021-10-31T17:20:00Z",
    "deadline_date": "2021-03-03T02:00:00Z",
    "name": "HOT SALE"
  },
  {
    "id": "P-MLB119001",
    "type": "MARKETPLACE_CAMPAIGN",
    "status": "started",
    "start_date": "2021-04-15T18:37:40.881Z",
    "finish_date": "2021-04-30T18:37:40.881Z",
    "name": "10% en herramientas",
    "benefits": {
           "type": "REBATE",
           "meli_percent": 2,
           "seller_percent": 8
       }
  },
  {
       "id": "1504782-MLA874447795",
       "type": "DOD",
       "status": "started",
       "price": 789,
       "start_date": "2021-04-19T00:00:00",
       "finish_date": "2021-04-19T23:59:59.999999999"
   },
   {
       "id": "1499515-MLA915978647",
       "type": "LIGHTNING",
       "status": "started",
       "price": 745,
       "start_date": "2021-04-19T06:00:00",
       "finish_date": "2021-04-19T12:00:00",
       "remaining_stock": 3
   },
   {
       "id": "P-MLB379009",
       "type": "VOLUME",
       "status": "started",
       "start_date": "2021-03-25T16:40:00Z",
       "finish_date": "2021-04-30T18:00:00Z",
       "name": "test volume MLB",
       "benefits": {
           "type": "VOLUME",
           "meli_percent": 8,
           "seller_percent": 17,
           "name": "4x3",
           "buy_quantity": 4,
           "pay_quantity": 3,
           "item_discount_percent": 25
       }
   },
   {
       "id": "P-MLM394001",
       "type": "PRE_NEGOTIATED",
       "status": "started",
       "start_date": "2021-03-30T18:30:15.525Z",
       "finish_date": "2021-12-27T17:59:59.525Z",
       "deadline_date": "2021-05-27T17:59:59.525Z",
       "name": "Prueba descuento x item sin benefit",
       "offers": [
           {
               "id": "MLM848619385-f588cf87-e298-498e-82ad-285b16dd11d5",
               "original_price": 101,
               "new_price": 21,
               "status": "active",
               "start_date": "2021-05-10T16:00:00Z",
               "end_date": "2021-05-11T15:00:00Z",
               "benefits": {
                   "type": "REBATE",
                   "meli_percent": 9.9,
                   "seller_percent": 69.3
               }
           }
       ]
   }

]
}


Change Items

You can change items included in a given deal by:

Nota:
To edit price discounts (PRICE DISCOUNT), deals of the day (DOD) and lightning deals (LIGHTNING) delete the promotion and apply it again.


Delete Items

You can change the items included in a given deal by:


Assign Test Campaigns

For test campaigns, please send user data and/or items in the following form.
Reminder - both users and items should be test users and items.


Nota:
Add the version=test parameter to calls for test promotion interaction. This applies to co-funded campaigns (MARKETPLACE_CAMPAIGN), volume discount campaigns (VOLUME), pre-negotiated discounts per item (PRE_NEGOTIATED), deals of the day (DOD), lightning deals (LIGHTNING), and also for price discounts (PRICE_DISCOUNT).
Traditional campaigns (DEALS), which use production campaigns exclusively for tests, are the only promotion type with no test scope.

Next Post: Traditional Campaigns

Documentación actual

Manage Promotions

Use the /seller-promotions resource to centralize all the available promotion types, such as traditional campaigns (DEAL), Mercado Libre co-funded campaigns (MARKETPLACE_CAMPAIGN), price discounts (PRICE_DISCOUNT), lightning deals (LIGHTNING), deals of the day (DOD), volume discount (VOLUME), and pre-negotiated discount per item (PRE NEGOTIATED). Besides the new types of deals that we will make available.


Contents

→Promotion Characteristics
→Promotion Availability by Country
→Check as available sales promotions for the seller
→Check Promotion Details
    ↳Status
→Check Promotion Items
→Participate in a promotion
→Check item promotions
→Change Items
→Delete items
→Assign Test Campaigns



Promotion Characteristics


Campaign type Name Price definition Price suggestion Bonus MELI Stock to participate Deadline Approval
Traditional DEAL User defines No No No Yes Yes
Co-funded campaigns MARKETPLACE CAMPAIGN User accepts No Yes No Yes No
Deals of the day DOD User accepts Yes No Yes, informative No No
Lightning deals LIGHTNING User defines Sim No Yes, required No No
Volume discount VOLUME User accepts No Yes No Yes No
Pre-negotiated discount per item PRE_NEGOTIATED User agree and accepts No Yes Yes Yes No


Promotion Availability by Country

Site Traditional campaigns
(DEAL)
Co-funded campaigns
(MARKETPLACE CAMPAIGN)
Price discounts
(PRICE DISCOUNT)
Volume discoun
(VOLUME)
Pre-negotiated discount per item
(PRE_NEGOTIATED)
Deals of the day
(DOD)
Lightning deals
(LIGHTNING)
MLA
MLB
MLM
MCO
MLC
MLU
MPE
MLV

Check Available Promotions for Sellers

Reminder - a user can have more than one and different types invitations.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/users/$USER_ID'

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/users/631366846'

Response:


    {
	"results": [{
			"id": "MLB686",
			"type": "DEAL",
			"status": "started",
			"start_date": "2020-02-04T17:50:00Z",
			"finish_date": "2022-10-31T17:20:00Z",
			"deadline_date": "2020-01-30T02:00:00Z",
			"name": "HOTSALE"
		},
		{
			"id": "DOD-MLB1000",
			"type": "DOD",
			"status": "started",
			"start_date": "2000-01-01T00:00:00.000Z"
		},
		{
			"id": "LGH-MLB1000",
			"type": "LIGHTNING",
			"status": "started",
			"start_date": "2000-01-01T00:00:00.000Z"
		},
		{
			"id": "P-MLB379009",
			"type": "VOLUME",
			"status": "started",
			"start_date": "2021-03-25T16:40:00Z",
			"finish_date": "2021-04-30T18:00:00Z",
			"name": "test volume MLB",
			"benefits": {
				"type": "VOLUME",
				"meli_percent": 8,
				"seller_percent": 17,
				"name": "4x3",
				"buy_quantity": 4,
				"pay_quantity": 3,
				"item_discount_percent": 25
			}
		},
		{
			"id": "P-MLB380001",
			"type": "VOLUME",
			"status": "started",
			"start_date": "2021-03-25T19:00:00Z",
			"finish_date": "2021-04-30T18:00:00Z",
			"name": "test volume MLB BNSP",
			"benefits": {
				"type": "VOLUME",
				"meli_percent": 10,
				"seller_percent": 30,
				"name": "buy 4 save 40%",
				"buy_quantity": 4,
				"item_discount_percent": 40
			}
		},
		{
			"id": "P-MLB380002",
			"type": "VOLUME",
			"status": "started",
			"start_date": "2021-03-25T19:30:00Z",
			"finish_date": "2021-04-30T18:00:00Z",
			"name": "test volume MLB SPONTH",
			"benefits": {
				"type": "VOLUME",
				"meli_percent": 8,
				"seller_percent": 17,
				"name": "save 50% on 2nd",
				"buy_quantity": 2,
				"item_discount_percent": 25
			}
		},
		{
			"id": "P-MLB382001",
			"type": "MARKETPLACE_CAMPAIGN",
			"status": "started",
			"start_date": "2021-03-25T22:36:00Z",
			"finish_date": "2021-04-30T18:00:00Z",
			"name": "test cofondeada",
			"benefits": {
				"type": "REBATE",
				"meli_percent": 2,
				"seller_percent": 8
			}
		},
		{
			"id": "P-MLM394001",
			"type": "PRE_NEGOTIATED",
			"status": "started",
			"start_date": "2021-03-30T18:30:15.525Z",
			"finish_date": "2021-12-27T17:59:59.525Z",
			"deadline_date": "2021-05-27T17:59:59.525Z",
			"name": "Prueba descuento x item sin benefit"
		}
	],
	"paging": {
		"offset": 0,
		"limit": 50,
		"total": 7
	}
}

Response fields

id: promotion ID code.
type: promotion type (DEAL, MARKETPLACE_CAMPAIGN, DOD, LIGHTNING, VOLUME).
status: Status.
start_date: promotion start date.
finish_date: promotion finish date.
deadline_date: maximum term to add promotional items.
name: promotion name.
deadline_date: maximum time limit for accepting the invitation to participate in the promotion.
benefits: promotion benefit configuration.


Check Promotion Details

Perform the following query to access the specific details of traditional campaigns, co-funded campaigns, and volume discounts.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTION_ID?promotion_type=$PROMOTION_TYPE'

Learn more about traditional campaigns, co-funded campaign, volume discount and pre-negotiated discount per item.


Status

Find below the different and possible promotion type statuses:


Check Promotion Items

Perform the query below to check the items included in a given promotion:

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTIONS_ID/items?promotion_type=PROMOTION_TYPE'

You can also check the items included in a traditional campaign, a co-funded campaign and volume discount items.

Check deal of the day items, lightning deal items e and pre-negotiated discount per item campaign status here. .



Participate in a Promotion

You can participate in different types of promotions and even offer an item price discount by:


Check Item Promotions

For DEALS we will return items with status = approved only.
We will not approve test campaigns, which will remain with pending_approval, i.e., you will not see the promotion price.

Request:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID

Example:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA876768946

Resposta:



{
"results":
[
  {
    "id": "2864-MLB876768946",
    "type": "PRICE_DISCOUNT",
    "status": "started",
    "price": 700,
    "top_price": 650,
    "start_date": "2020-09-09T00:00:00",
    "finish_date": "2020-09-15T00:00:00"
  },
  {
    "id": "MLB686",
    "type": "DEAL",
    "status": "started",
    "price": 680,
    "start_date": "2021-03-04T17:50:00Z",
    "finish_date": "2021-10-31T17:20:00Z",
    "deadline_date": "2021-03-03T02:00:00Z",
    "name": "HOT SALE"
  },
  {
    "id": "P-MLB119001",
    "type": "MARKETPLACE_CAMPAIGN",
    "status": "started",
    "start_date": "2021-04-15T18:37:40.881Z",
    "finish_date": "2021-04-30T18:37:40.881Z",
    "name": "10% en herramientas",
    "benefits": {
           "type": "REBATE",
           "meli_percent": 2,
           "seller_percent": 8
       }
  },
  {
       "id": "1504782-MLA874447795",
       "type": "DOD",
       "status": "started",
       "price": 789,
       "start_date": "2021-04-19T00:00:00",
       "finish_date": "2021-04-19T23:59:59.999999999"
   },
   {
       "id": "1499515-MLA915978647",
       "type": "LIGHTNING",
       "status": "started",
       "price": 745,
       "start_date": "2021-04-19T06:00:00",
       "finish_date": "2021-04-19T12:00:00",
       "remaining_stock": 3
   },
   {
       "id": "P-MLB379009",
       "type": "VOLUME",
       "status": "started",
       "start_date": "2021-03-25T16:40:00Z",
       "finish_date": "2021-04-30T18:00:00Z",
       "name": "test volume MLB",
       "benefits": {
           "type": "VOLUME",
           "meli_percent": 8,
           "seller_percent": 17,
           "name": "4x3",
           "buy_quantity": 4,
           "pay_quantity": 3,
           "item_discount_percent": 25
       }
   },
   {
       "id": "P-MLM394001",
       "type": "PRE_NEGOTIATED",
       "status": "started",
       "start_date": "2021-03-30T18:30:15.525Z",
       "finish_date": "2021-12-27T17:59:59.525Z",
       "deadline_date": "2021-05-27T17:59:59.525Z",
       "name": "Prueba descuento x item sin benefit",
       "offers": [
           {
               "id": "MLM848619385-f588cf87-e298-498e-82ad-285b16dd11d5",
               "original_price": 101,
               "new_price": 21,
               "status": "active",
               "start_date": "2021-05-10T16:00:00Z",
               "end_date": "2021-05-11T15:00:00Z",
               "benefits": {
                   "type": "REBATE",
                   "meli_percent": 9.9,
                   "seller_percent": 69.3
               }
           }
       ]
   }

]
}


Change Items

You can change items included in a given deal by:

Nota:
To edit price discounts (PRICE DISCOUNT), deals of the day (DOD) and lightning deals (LIGHTNING) delete the promotion and apply it again.


Delete Items

You can change the items included in a given deal by:


Assign Test Campaigns

For test campaigns, please send user data and/or items in the following form.
Reminder - both users and items should be test users and items.


Nota:
Add the version=test parameter to calls for test promotion interaction. This applies to co-funded campaigns (MARKETPLACE_CAMPAIGN), volume discount campaigns (VOLUME), pre-negotiated discounts per item (PRE_NEGOTIATED), deals of the day (DOD), lightning deals (LIGHTNING), and also for price discounts (PRICE_DISCOUNT).
Traditional campaigns (DEALS), which use production campaigns exclusively for tests, are the only promotion type with no test scope.

Next Post: Traditional Campaigns

banner footer

Subscribe to our Newletter

or register to recieve the latest news about our API