Campanhas tradicionais

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
candidate	Item elegível para a deal.
pending	Item foi enviado para a deal porém não iniciou.
started	Item com deal já iniciada.

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