Ofertas relâmpago

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 relâmpago e deseja ingressar, você pode fazer isso com os seguintes recursos.
Lembre-se que este tipo de oferta tem um estoque reservado para quando a promoção terminar.



Conteúdo

→Consultar os items em uma oferta relâmpago
    ↳Status do item
→Indicar items para uma oferta relâmpago
→Eliminar items



Consultar os items em uma oferta relâmpago

Para conhecer os itens que fazem parte de uma oferta relâmpago, você pode fazer a seguinte consulta:

Exemplo:

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

Resposta:

{
  "results": [
    {
           "id": "MLA910489378",
           "status": "candidate",
           "price": 4464,
           "original_price": 4899,
           "max_original_price": 7048,
           "stock": {
               "min": 6,
               "max": 10
           }
       },
       {
           "id": "MLA902703770",
           "status": "candidate",
           "price": 32289,
           "original_price": 35399,
           "max_original_price": 50983,
           "stock": {
               "min": 6,
               "max": 14
           }
       }
  ],
  "paging": {
    "offset": 0,
    "limit": 50,
    "total": 4
  }
}

Campos de resposta

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 a faixa de stock mínimo e máximo a ser atribuído à promoção.


Status do item

Na tabela a seguir você pode encontrar 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 items para uma oferta relâmpago

Depois de convidado a participar de uma oferta relâmpago, você pode indicar quais produtos candidatos deseja incluir nela. Lembrando que você deve informar o estoque que estará disponível para esta promoção. Quando o estoque disponível acabar, a promoção do item será automaticamente encerrada.


Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' 
-d '{ 
   "deal_price":"DEAL_PRICE",
   "original_price":$LIST_PRICE,
   "stock": $STOCK,
   "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,
   "stock":11,
   "promotion_type":"LIGHTNING"
}' 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.
stock: estoque do item que deseja reservar para esta promoção.
promotion_type: tipo de promoção “oferta relâmpago” (LIGHTNING).


Eliminar items

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=LIGHTNING

Resposta: Status 200 OK

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