Ofertas del día

Consultar ítems en una oferta del día

Para conocer los ítems que forman parte de una oferta del día puedes realizar la siguiente consulta:

Ejemplo:

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

Respuesta:

{
  "results": [
    {
           "id": "MLA833682552",
           "status": "candidate",
           "price": 2260,
           "original_price": 2429,
           "max_original_price": 3643,
           "stock": {
               "min": 20
           }
       },
       {
           "id": "MLA915916697",
           "status": "candidate",
           "price": 5070,
           "original_price": 5879,
           "max_original_price": 8818,
           "stock": {
               "min": 20
           }
       },
       {
           "id": "MLA915917360",
           "status": "candidate",
           "price": 5800,
           "original_price": 8260,
           "max_original_price": 12390,
           "stock": {
               "min": 20
           }
       },
       {
           "id": "MLA850940784",
           "status": "candidate",
           "price": 2530,
           "original_price": 2699,
           "max_original_price": 4198,
           "stock": {
               "min": 20
           }
       }
  ],
  "paging": {
    "offset": 0,
    "limit": 50,
    "total": 4
  }
}

Campos de respuesta

id: identificador del ítem.
status: estado del ítem en la promoción. (ver tabla)
price: precio del ítem dentro de la promoción. En el caso que el estado del ítem sea candidate hace referencia al precio sugerido.
original_price: precio actual del ítem.
max_original_price: máximo precio que puede tener el ítem como original_price para participar de la promoción.
stock: valor informativo sobre el stock mínimo que debe tener el ítem al momento de subir un candidato en una promoción.

Estado del ítem

En la siguiente tabla puedes encontrar los posibles estados que pueden tomar los ítems dentro de este tipo de promoción.

Estado	Descripción
candidate	Ítem candidato para participar en la promoción.
pending	Ítem con promoción programada.
started	Ítem activo en la promoción.
finished	Ítem eliminado de la campaña.

Indicar ítems para una oferta del día

Una vez invitado a participar en una oferta del día, puedes indicar qué productos candidatos deseas incluir en la misma.

Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' 
-d '{ 
   "deal_price":"DEAL_PRICE",
   "original_price":$LIST_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": 14999,
   "original_price": 17000,
   "promotion_type":"DOD"
}' https://api.mercadolibre.com/seller-promotions/items/MLA876768946

Respuesta:

{
  "price": 14999,
  "original_price": 17000
}

Parámetros

deal_price: precio del ítem en la promoción.
original_price: precio del ítem antes de incluirse en la promoción.
promotion_type: tipo de promoción “oferta del día” (DOD).

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

Ejemplo:

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

Respuesta: Status 200 OK

Next post: Ofertas relámpago