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

En las 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.


Indicar items para uma oferta relâmpago

Una vez invitado a participar en una oferta relámpago, puedes indicar qué productos candidatos deseas incluir en la misma. Teniendo en cuenta que debes informar el stock que estará disponible para esta promoción. Cuando se agote el stock disponible automáticamente se dará por finalizada la promoción en el ítem.


Llamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' 
-d '{ 
   "price":"PRICE",
   "original_price":$LIST_PRICE,
   "involved_stock": $INVOLVED_STOCK,
   "promotion_type":"$PROMOTION_TYPE"
}' https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID

Ejemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' 
-d '{ 
   "price": 14999,
   "original_price": 17000,
   "involved_stock":11,
   "promotion_type":"LIGHTNING"
}' https://api.mercadolibre.com/seller-promotions/items/MLA876768946

Respuesta:

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

Parámetros

price: precio del ítem en la promoción.
original_price: precio del ítem antes de incluirse en la promoción.
involved_stock: stock del ítem que desees reservar para esta promoción.
promotion_type: tipo de promoción “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

Respuesta: Status 200 OK

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