Documentação do Mercado Livre

Confira todas as informações necessárias sobre as APIs Mercado Livre.
circulos azuis em degrade

Documentação

Última atualização em 05/12/2023

Ofertas relâmpago

Importante:
A partir de 10 de janeiro de 2024 eliminaremos a versão anterior do recurso /seller-promotions.
Para obter a resposta com a nova versão, envie a query param app_version=v2. Consulte a documentação de cada campanha para conhecer as mudanças.

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.





Consultar os items

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


Chamada:

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

Exemplo:

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

Resposta:

{
   "results": [
       {
           "id": "MLB3293401743",
           "start_date": "2023-04-21T15:00:00",
           "finish_date": "2023-04-21T23:00:00",
           "status": "candidate",
           "price": 4000,
           "original_price": 5000,
           "max_discounted_price": 4950,
           "min_discounted_price": 1500,
           "stock": {
                 "min": 2,
                 "max": 5
             }


       }
   ],
   "paging": {
       "offset": 0,
       "limit": 50,
       "total": 1
   }
}

Campos de resposta

id: identificador do item.
start_date: data de início da campanha.
finish_date: data de término da campanha.
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_discounted_price: é o preço de valor mais baixo pelo qual essa promoção pode ser oferecida.
min_discounted_price: é o preço mais alto permitido para aquela promoção (ou seja, o menor desconto permitido).
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 Candidato a participar da promoção.
pending Promoção programada.
started Ativo a oferta.
finished Eliminado da campanha.


Indicar items

Após 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 stock disponível esgotar, a promoção do item será automaticamente encerrada.


Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'
-d '{ 
   "deal_price":$deal_price,
    "stock": $STOCK,
   "promotion_type":"$PROMOTION_TYPE
}' 
https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID?app_version=v2

Exemplo:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'
-d '{ 
   "stock": 4000,
   "stock":2,
   "promotion_type":"LIGHTNING"
}' 
https://api.mercadolibre.com/seller-promotions/items/MLB3293401743?app_version=v2

Resposta:

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

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 LIGHTNING (oferta relâmpago).


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?app_version=v2&promotion_type=$PROMOTION_TYPE

Exemplo:

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

Resposta: Status 200 OK

Siguiente: Campanhas do vendedor.