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 do dia
![](https://http2.mlstatic.com/storage/developers-site-cms-admin/DevSite/287973232012-Ofertas-del-dia.png)
Consultar itens de campanha
Para conhecer os itens que fazem parte de uma oferta do dia faça a seguinte consulta:
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTION_ID/items?promotion_type=DOD&app_version=v2'
Exemplo:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/DOD-MLB1000/items?promotion_type=DOD&app_version=v2
Response:
{
"results": [
{
"id": "MLB3500438494",
"start_date": "2023-04-20T00:00:00",
"finish_date": "2023-04-20T23:59:59",
"status": "candidate",
"price": 3900,
"original_price": 4000,
"max_discounted_price": 3960,
"min_discounted_price": 1200,
"stock": {
"min": 1,
"max": 5
}
},
{
"id": "MLB833682552",
"start_date": "2023-04-20T00:00:00",
"finish_date": "2023-04-20T23:59:59",
"status": "candidate",
"price": 4900,
"original_price": 5000,
"max_discounted_price": 4960,
"min_discounted_price": 2200,
"stock": {
"min": 1,
"max": 5
}
},
{
"id": "MLB915917360",
"start_date": "2023-04-20T00:00:00",
"finish_date": "2023-04-20T23:59:59",
"status": "candidate",
"price": 5900,
"original_price": 6000,
"max_discounted_price": 5960,
"min_discounted_price": 3200,
"stock": {
"min": 1,
"max": 5
}
}
],
"paging": {
"offset": 0,
"limit": 50,
"total": 3
}
}
Campos de respuesta
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 o stock mínimo que você deve ter do item ao enviar um candidato em uma promoção.
Estados do item
Na tabela a seguir você encontra os possíveis estados que os itens podem assumir neste tipo de promoção.
Estados | Descrição |
---|---|
candidate | Candidato a participar da promoção. |
pending | Promoção programada. |
started | Ativo na promoção. |
finished | Eliminado da campanha. |
Indicar itens
Após 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",
"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 '{
"deal_price": 14999,
"promotion_type":"DOD"
}'
https://api.mercadolibre.com/seller-promotions/items/MLA876768946?app_version=v2
Resposta:
{
"price": 14999,
"original_price": 17000
}
Parâmetros
deal_price: preço do item na promoção.
promotion_type: tipo de promoção DOD (oferta do dia).
Eliminar itens
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=DOD'
Seguinte: Ofertas relâmpago