Campanhas tradicionais
Conteúdos
→Consultar detalhes de um deal
↳Status
→Consultar itens em um deal
↳Status dos itens
→Indicar itens para um deal
→Modificar itens
→Eliminar itens
Consultar detalhes de um deal
Para obter os detalhes de uma oferta do tipo Deal, realize o seguinte GET:
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/MLA686?promotion_type=DEAL
Resposta:
{
"id": "MLA686",
"type": "DEAL",
"status": "started",
"start_date": "2019-02-04T17:50:00Z",
"finish_date": "2020-10-31T17:20:00Z",
"deadline_date": "2020-09-30T02:00:00Z",
"name": "HOTSALE"
}
Status
Esses são os diferentes estados pelos quais uma campanha tradicional pode passar:
Status | Descrição |
---|---|
pending | Oferta aprovada que ainda não começou. |
started | Oferta ativa. |
finished | Oferta finalizada. |
Consultar itens em um deal
Para saber os itens em um deal, realize o seguinte GET:
Chamada:
curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/MLA686/items?promotion_type=DEAL
Resposta:
{
"results": [
{
"id": "MLA875050287",
"status": "pending_approval",
"price": 300,
"original_price": 1000
},
{
"id": "MLA876387768",
"status": "pending_approval",
"price": 900,
"original_price": 1000
}
],
"paging": {
"offset": 0,
"limit": 50,
"total": 2
}
}
Status dos itens
Possíveis status que os itens podem assumir os itens neste tipo de campanhas.
Status | Descrição |
---|---|
approved | Item aprovado para da oferta. |
pending_approval | Item com aprovação pendente para da oferta. |
rejected | Item rejeitado para da oferta. |
Indicar itens para um deal
Depois de ter sido convidado a participar de uma campanha de venda, com o seguinte POST é possível indicar os produtos que deseja incluir nesta campanha.
Chamada:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'
-d '{
"deal_id":"$DEAL_ID",
"regular_price":$REGULAR_PRICE,
"deal_price":$DEAL_PRICE,
"promotion_type":"$PROMOTION_TYPE"
}'
https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID
Exemplo:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN'
-d '{
"deal_id":"MLA1804",
"regular_price":350,
"deal_price":240,
"promotion_type":"DEAL"
}'
https://api.mercadolibre.com/seller-promotions/items/MLA876768946
Resposta:
{
"price": 240,
"original_price": 350
}
Parâmetros
deal_id: identificação da oferta.
regular_price: preço do produto antes da oferta.
deal_price: preço do item na oferta.
promotion_type: oferta do tipo DEAL.
Modificar itens
Para modificar os itens que estão participando de uma oferta, pode fazer isso da seguinte maneira:
Chamada:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'
-d'{
"deal_id":"$DEAL_ID",
"regular_price":$REGULAR_PRICE,
"deal_price":$DEAL_PRICE,
"promotion_type":"DEAL"
}'
https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID
Exemplo:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN'
-d'{
"deal_id":"MLA1804",
"regular_price":350,
"deal_price":220,
"promotion_type":"DEAL"
}'
https://api.mercadolibre.com/seller-promotions/items/MLB1676902612
Resposta:
{
"price": 220,
"original_price": 350
}
Eliminar itens
Com este recurso é possível eliminar uma 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&deal_id=$DEAL_ID
Exemplo:
curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA632979587?promotion_type=DEAL&deal_id=1804
Resposta: Status 200 OK