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
→Filtrar por items e status
→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.

Filtrar por itens e status


Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/$PROMOTION_ID?promotion_type=DEAL&status=$STATUS&item_id=$ITEM_ID

Exemplo de filtro por item:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' /seller-promotions/promotions/MLA1111/items?promotion_type=DEAL&item_id=MLA604400000

Resposta:

{
   "results": [
       {
           "id": "MLA604400000",
           "status": "rejected",
           "price": 23968,
           "original_price": 28549
       }
   ],
   "paging": {...}
}

Exemplo de filtro por status approved:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' /seller-promotions/promotions/MLA1111/items?promotion_type=DEAL&status=approved

Resposta:

{
   "results": [
       {
            "id": "MLA639970000",
            "status": "approved",
            "price": 4037,
            "original_price": 4427
        },
        {
            "id": "MLA639973333",
            "status": "approved",
            "price": 6007,
            "original_price": 6587
        },
],
   "paging": [...]
}

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

ou registre-se para receber as últimas notícias sobre nossa API