Última actualización 15/03/2023

Campañas tradicionales

Los vendedores que reciben asesoramiento por parte del equipo comercial de Mercado Libre son invitados periódicamente a participar de diferentes campañas que se realizan en el sitio. Si recibiste la invitación para alguna campaña puntual y quieres sumarte puedes hacerlo con los siguientes recursos.




Consultar detalle de una campaña tradicional

Para obtener los detalles de una oferta de tipo Deal, realiza la siguiente consulta:

Llamada:

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

Respuesta:

{
  "id": "MLA686",
  "type": "DEAL",
  "status": "started",
  "start_date": "2019-02-04T17:50:00Z",
  "finish_date": "2020-10-31T17:20:00Z",
  "deadline_date": "2020-09-30T02:00:00Z",
  "name": "HOTSALE",
  "categories": [
       "MLA1182",
       "MLA3937",
       "MLA1459"
   ]
}

El detalle de cada campo de la respuesta lo puedes encontrar en gestionar promociones .


Estados

Estos son los distintos estados por lo que puede pasar una campaña tradicional.

Estado Descripción
pending Promoción aprobada que aún no inició.
started Promoción activa.
finished Promoción finalizada.


Consultar ítems en una campaña tradicional

Para conocer los ítems que forman parte de una campaña tradicional puedes realizar la siguiente consulta:

Llamada:

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

Respuesta:

{
   "results": [
       {
           "id": "MLB21995793456",
           "status": "candidate",
           "price": 0,
           "original_price": 0
       },
       {
           "id": "MLB2199578643",
           "status": "candidate",
           "price": 0,
           "original_price": 0
       },
         ],
   "paging": {
       "offset": 0,
       "limit": 50,
       "total": 2
   }

Estado de los ítems

En la siguiente tabla puedes encontrar los posibles estados que pueden tomar los ítems dentro de este tipo de campaña.

Status Descripción
candidate Ítem elegible a la deal.
pending Ítem enviado a deal pero no se inició.
started Ítem con deal ya iniciada.
finished Ítem eliminado de la campaña
Nota:
Las nuevas campañas tienen ítems con status de candidate, pero aún hay campañas antiguas que no tienen ítems con este status.

Indicar ítems para una campaña tradicional

Una vez invitado a participar en una campaña de ofertas, puedes indicar qué productos deseas incluir en la misma.

Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'
-d '{
   "deal_id":"$DEAL_ID",
   "regular_price":$REGULAR_PRICE,
   "deal_price":$DEAL_PRICE,
   "promotion_type":"$PROMOTION_TYPE"
}'
https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID

Ejemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'
-d '{ 
   "deal_id":"MLA1804",
   "regular_price":350,
   "deal_price":240,
   "promotion_type":"DEAL"
}' 
https://api.mercadolibre.com/seller-promotions/items/MLA876768946

Respuesta:

{
  "price": 240,
  "original_price": 350
}

Parámetros

deal_id: identificación de la promoción.
regular_price: precio del ítem antes de incluirse en la promoción.
deal_price: precio del ítem en la promoción.
promotion_type: tipo de promoción (DEAL.)



Modificar ítems

Para modificar los ítems que están participando en una promoción realiza la siguiente operación:

Llamada:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'
-d'{
   "deal_id":"$DEAL_ID",
   "regular_price":$REGULAR_PRICE,
   "deal_price":$DEAL_PRICE,
   "promotion_type":"DEAL"
}'
https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID

Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'
-d'{
   "deal_id":"MLA1804",
   "regular_price":350,
   "deal_price":220,
   "promotion_type":"DEAL"
}'
https://api.mercadolibre.com/seller-promotions/items/MLB1676902612

Respuesta:

{
  "price": 220,
  "original_price": 350
}

Eliminar ítems

Con este recurso podrás eliminar la oferta del ítem.

Llamada:

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

Ejemplo:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA632979587?promotion_type=DEAL&deal_id=1804

Respuesta: Status 200 OK


Next post: Campañas co-fondeadas