Campanhas de desconto por volume

Os vendedores são convidados periodicamente a participar de diversas campanhas realizadas no site. A principal característica desse tipo de campanha é que um desconto é aplicado quando um determinado número de itens de um produto é atingido. Por exemplo, “compre 4 e pague 3” ou “2x1” ou “50% de desconto no segundo item”.
Além disso, o Mercado Livre assume um percentual do desconto oferecido. Se você recebeu um convite e deseja ingressar, você pode fazê-lo com os seguintes recursos.

Visão do vendedor

Conteúdo

→Consultar os detalhes de uma campanha com desconto por volume
↳Tipos de desconto
↳Status
→Consultar os itens em uma campanha de desconto por volume
↳Status dos itens
→Indicar itens para uma campanha de desconto por volume
→Modificar itens
→Eliminar itens

Consultar os detalhes de uma campanha com desconto por volume

Para obter os detalhes de uma campanha de desconto por volume, faça a seguinte consulta:

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/P-MLB379009?promotion_type=VOLUME

Resposta:

{
   "id": "P-MLB379009",
   "type": "VOLUME",
   "status": "started",
   "start_date": "2021-03-25T16:40:00Z",
   "finish_date": "2021-04-30T18:00:00Z",
   "deadline_date": "2021-04-30T18:00:00Z",
   "name": "test volume MLB",
   "benefits": {
       "type": "VOLUME",
       "meli_percent": 8,
       "seller_percent": 17,
       "name": "4x3",
       "buy_quantity": 4,
       "pay_quantity": 3,
       "item_discount_percent": 25
   }
}

Campos específicos desta campanha

Benefícios: Detalhe dos benefícios da promoção.

type: tipo de benefício.

meli_percent: porcentagem contribuída pelo Mercado Livre.

seller_percent: porcentagem de contribuição do vendedor.

name: nome do desconto.

buy_quantity: número necessário de itens para acessar o desconto.

pay_quantity: quantidade de itens que são pagos.

item_discount_percent: porcentagem de desconto em cada item.

Tipos de desconto

Estes são os diferentes tipos de descontos que existem neste tipo de campanha:

Leva 4 paga 3
70% OFF comprando 2
70% OFF na 2ª unidade

Status

Esses são os diferentes status pelos quais uma campanha de desconto por volume pode passar.

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

Consultar os itens em uma campanha de desconto por volume

Para conhecer os itens candidatos e / ou que fazem parte de uma campanha com desconto por volume, pode-se fazer a seguinte consulta:

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/promotions/P-MLB379009/items?promotion_type=VOLUME

Resposta:

{
    "results": [
        {
           "id": "MLB1834747833",
           "status": "candidate",
           "price": 0,
           "original_price": 0
       },
       {
           "id": "MLB1834747833",
           "status": "active",
           "price": 3750,
           "original_price": 5000,
           "offer_id": "MLB1834747833-47a4b043-adb6-4e29-93b7-b36880013fef"
       }
    ],
    "paging": {
        "total": 2
    }
}

Ao criar uma nova campanha, todos os itens aplicáveis a ela são selecionados. O estado inicial (status) dos itens é "candidato" e sem um ID de oferta atribuído. Assim que o vendedor incorpora um item à campanha, seu status é modificado e um "offer_id" exclusivo é atribuído a ele.

Status dos itens

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

Status	Descrição
candidate	Item candidato a participar da promoção
programmed	Item com promoção aprovada e programada
active	Item ativo na campanha

Indicando itens para uma campanha de desconto por volume

Depois de ter sido convidado a participar neste tipo de campanha, você pode indicar quais produtos deseja incluir nela.

Chamada:

curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' \
-d '{
   "deal_id":"$DEAL_ID",
   "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":"P-MLB379009",
   "promotion_type":"VOLUME"
}'
https://api.mercadolibre.com/seller-promotions/items/MLB1834747833

Resposta:

{
  "offer_id": "MLB1834747833-9eafadd4-16d2-49ae-b272-9a7a34585cb8",
  "price": 1800,
  "original_price": 2000
}

Parâmetros

deal_id: identificação da promoção.
promotion_type: tipo de promoção (VOLUME).

Modificar itens

Para modificar o preço de um item que participa de uma campanha com desconto por volume, devem ser realizados os seguintes passos, uma vez que não é possível modificar o preço diretamente.

Eliminar o item da campanha
Modifique o preço do item como sincronização normal de preço
Incluir o item novamente na campanha

Nota:

Os itens que participam das campanhas de desconto por volume não têm preço fixo, portanto, se um item estiver participando e seu preço aumentar, ele sairá automaticamente da oferta e você não poderá adicioná-lo novamente.
- Recomendamos que você valide se o item está participando de uma campanha com desconto por volume ao fazer uma alteração de preço (manual ou automática) .

Eliminar itens

Com este recurso você pode eliminar a 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&offer_id=$OFFER_ID

Exemplo:

curl -X DELETE -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA632979587?promotion_type=VOLUME&deal_id=1804&offer_id=MLA876618673-9eafadd4-16d2-49ae-b272-9a7a34585cb8

Resposta: Status 200 OK