Ofertas do dia

Os vendedores são convidados periodicamente a participar de diversas promoções que acontecem no site. Se você recebeu o convite para participar de uma oferta do dia e deseja ingressar, poderá fazê-lo com os seguintes recursos.



Conteúdo

→Consultar os itens em uma oferta do dia
    ↳Status do item
→Indicar itens para uma oferta do dia
→Eliminar itens



Consultar os itens em uma oferta do dia

Para conhecer os itens que fazem parte de uma oferta do dia pode fazer a seguinte consulta:


Exemplo:

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

Resposta:

{
  "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 do item.
status: status do item na promoção. (Veja a tabela)
price: preço do item na promoção. Caso o status do item seja candidato, refere-se ao preço sugerido.
original_price: preço atual do item.
max_original_price: preço máximo que o item pode ter como original_price para participar da promoção.
stock: valor informativo sobre o stock mínimo que você deve ter o item ao enviar um candidato em uma promoção.


Status do item

Na tabela a seguir você encontra os possíveis status que os itens podem assumir neste tipo de promoção.

Status Descrição
candidate Item candidato a participar da promoção.
pending Item com promoção programada.
started Item ativo na promoção.


Indicar itens para uma oferta do dia

Depois de ser convidado a participar de uma oferta do dia, você pode indicar quais produtos candidatos deseja incluir nela.

Chamada:

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

Exemplo:

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

Resposta:

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

Parâmetros

deal_price: preço do item na promoção.
original_price: preço do item antes de ser incluído na promoção.
start_date: data inicial do desconto.
promotion_type: tipo de promoção "oferta do dia" (DOD).


Eliminar itens

Com este recurso você poderá eliminar a oferta do item.

Chamada:

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

Exemplo:

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

Resposta: Status 200 OK

Seguinte: Ofertas relâmpago

ou registre-se para receber as últimas notícias sobre nossa API