Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.![circulos azuis em degrade](https://http2.mlstatic.com/storage/developers-site-cms-admin/DevImgs/230801158836-ImgMS--1-.png)
Documentação do
Ofertas relâmpago
![]( https://http2.mlstatic.com/storage/developers-site-cms-admin/DevSite/287972316449-Ofertas-rela-mpago.png)
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 programada 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.