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



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