Campañas tradicionales

Consultar detalle de una campaña

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/P-MLB1806019?promotion_type=DEAL&app_version=v2

Respuesta:

{
  "id": "P-MLB1806019",
  "type": "DEAL",
  "status": "started",
  "start_date": "2023-04-20T03:00:00Z",
  "finish_date": "2023-08-01T02:00:00Z",
  "deadline_date": "2023-08-01T01:00:00Z",
  "name": "HOTSALE"
}

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

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/P-MLB1806019/items?promotion_type=DEAL&app_version=v2'

Respuesta:

{
  "results": [
      {
          "id": "MLB3295112047",
          "status": "started",
          "price": 4000,
          "original_price": 5000,
          "top_deal_price": 3000
      },
      {
          "id": "MLB3293389813",
          "status": "candidate",
          "price": 0,
          "original_price": 3000.5,
          "min_discounted_price": 900.15
      },
      {
          "id": "MLB3500418540",
          "status": "candidate",
          "price": 0,
          "original_price": 2000,
          "min_discounted_price": 600
      },
      {
          "id": "MLB3500450682",
          "status": "candidate",
          "price": 0,
          "original_price": 3000,
          "min_discounted_price": 900
      },
      {
          "id": "MLB3500438432",
          "status": "candidate",
          "price": 0,
          "original_price": 3000.5,
          "min_discounted_price": 900.15
      }
  ],
  "paging": {
      "offset": 0,
      "limit": 50,
      "total": 5
  }
}

Parámetros

id: item id.
status: status del ítem en la campaña.
price: precio del ítem en la campaña.
original_price: precio del ítem sin descuento.
min_discounted_price: precio mínimo que el vendedor puede poner en el ítem en la campaña. O sea, es el mayor descuento que puede tener el ítem.
top_deal_price: precio del ítem para los mejores compradores, con nivel Mercado Puntos 3 a 6. Este campo solo aparecerá si el ítem se encuentra activo en la campaña y si el vendedor ingresó un valor para el mismo en el momento de agregar el ítem a la campaña.

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 la deal ya iniciada.
finished	Ítem eliminado de la campaña.

Indicar ítems para una campaña

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

Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'
-d '{
  "top_deal_price":$TOP_DEAL_PRICE
  "promotion_id":"$PROMOTION_ID"
   "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_price": 4000,
  "top_deal_price": 3000,
  "promotion_id": "P-MLB1806019",
  "promotion_type": "DEAL"
 }' 
https://api.mercadolibre.com/seller-promotions/items/MLB3295112047?app_version=v2

Respuesta:

{
  "price": 4000,
  "top_price": 3000,
  "original_price": 5000
}

Parámetros

deal_price: precio del ítem en la promoción.
top_deal_price: precio del ítem para los mejores compradores, con nivel Mercado Puntos 3 a 6 (es opcional informar este precio)
promotion_id: identificación de 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_price":$DEAL_PRICE,
   "top_deal_price":$TOP_DEAL_PRICE,
   "promotion_id":"$PROMOTION_ID"
   "promotion_type":"DEAL"
}'
https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?app_version=v2

Ejemplo:

curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'
-d'{
  "deal_price": 3900,
  "top_deal_price": 3000,
  "promotion_id": "P-MLB1806019",
  "promotion_type": "DEAL"
 }'
https://api.mercadolibre.com/seller-promotions/items/MLB3295112047?app_version=v2

Respuesta:

{
  "price": 3900,
  "top_price": 3000,
  "original_price": 5000
}

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&promotion_id=$PROMOTION_ID&app_version=v2

Ejemplo:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLB3295112047?promotion_type=DEAL&promotion_id=P-MLB1806019=&app_version=v2

Respuesta: Status 200 OK

Next: Campañas co-fondeadas