Campanhas tradicionais

Os vendedores que recebem assessoria da equipe comercial do Mercado Livre são convidados periodicamente a participar de diversas campanhas realizadas no site. Se você recebeu o convite para uma campanha específica e deseja ingressar, você pode fazer isso com os seguintes recursos.

Conteúdos

→Consultar detalhes de uma campanha tradicional
↳Status
→Consultar itens de uma campanha tradicional
↳Status dos itens
→Identificar itens para uma campanha tradicional
→Modificar itens
→Eliminar itens

Consultar detalhes de uma campanha tradicional

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",
  "categories": [
       "MLA1182",
       "MLA3937",
       "MLA1459"
   ]
}

O detalhe de cada campo da resposta pode ser encontrado em gerenciar promoções.

Status

Esses são os diferentes estados pelos quais uma campanha tradicional pode passar:

Status	Descrição
pending	Promoção aprovada que ainda não iniciou.
started	Promoção ativa.
finished	Promoção finalizada.

Consultar itens de uma campanha tradicional

Para conhecer os itens que fazem parte de uma campanha tradicional pode-se fazer a seguinte consulta:

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": "approved",
      "price": 900,
      "original_price": 1000
    }
  ],
  "paging": {
    "offset": 0,
    "limit": 50,
    "total": 2
  }
}

Status dos itens

Na tabela a seguir você encontra os possíveis status que os itens podem assumir neste tipo de campanha.

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.

Identificar itens para uma campanha tradicional

Uma vez convidado a participar de uma campanha, você pode indicar quais produtos deseja incluir nela.

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 promoção.
regular_price: preço do item antes de ser incluído na promoção.
deal_price: preço do item na promoção.
promotion_type: tipo de promoção (DEAL).

Modificar itens

Para modificar os itens que estão participando de uma promoção, execute a seguinte operação:

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 você pode eliminar itens de uma campanha tradicional.

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

Seguinte: Campanha com participação do Mercado Livre