Campanhas tradicionais

Os vendedores que recebem assessoramento por parte da equipe comercial do Mercado Livre são convidados periodicamente a participar de diferentes campanhas de ofertas que se realizam no site.
Se recebeu o convite para alguma campanha pontual e quer se somar, segue este tutorial para conhecer os passos básicos de como sugerir seus produtos em oferta..

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