Campanha com participação do Mercado Livre

Os vendedores são convidados periodicamente a participar de diversas campanhas realizadas no site.
A principal característica desse tipo de campanha é que o Mercado Livre paga um percentual do desconto oferecido.
Se recebeu o convite e quer se somar, segue este tutorial com os seguintes recursos.




Consultar detalhes da campanha com participação do Mercado Livre

Para obter os detalhes de uma oferta com participação do Mercado Livre, realize o seguinte consulta.

Chamada:

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

Resposta:

{
  "id": "MLA686",
  "type": "MARKETPLACE_CAMPAIGN",
  "status": "started",
  "start_date": "2019-02-04T17:50:00Z",
  "finish_date": "2020-10-31T17:20:00Z",
  "deadline_date": "2020-09-30T02:00:00Z",
  "name": "P-MLA1252",
  "benefits": {
    "type": "REBATE",
    "meli_percent": 20,
    "seller_percent": 10
  }

}

Campos específicos desta campanha


Benefits: 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.


  • Status

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

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

    Consultar itens em uma campanha com participação do Mercado Livre

    Para conhecer os itens candidatos e / ou que fazem parte de uma campanha coparticipação, 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=MARKETPLACE_CAMPAIGN

    Resposta:

    {
        "results": [
            {
                "id": "MLA877277006",
                "status": "ACTIVE",
                "price": 1349,
                "original_price": 1500,
                "offer_id": "MLA877277006-e2c63989-ad16-4ef3-9b6d-0c6da0ac40a5"
            },
            {
                "id": "MLA1767902544",
                "status": "candidate",
                "price": 0,
                "original_price": 0
            }
        ],
        "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 é atribuído um "offer_id" único.



    Status do 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 candidato a participar da promoção.
    programmed Item com promoção aprovada e programada.
    active Item ativo na campanha.


    Indicar itens para uma campanha com participação do Mercado Livre

    Depois de ter sido convidado a participar de uma campanha de coparticipação, 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-MLA147001",
       "promotion_type":"MARKETPLACE_CAMPAIGN"
    }'
    https://api.mercadolibre.com/seller-promotions/items/MLA876618673
    

    Resposta:

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

    Parâmetros

    deal_id: identificação da oferta do tipo MARKETPLACE_CAMPAIGN.
    promotion_type: oferta do tipo MARKETPLACE_CAMPAIGN.



    Modificar itens

    Para modificar o preço de um item que pertence a uma campanha com participação do Mercado Livre devem ser realizados os seguintes passos, já que não é possível modificar o preço diretamente.


    Passos:

    • Exclua o item da campanha
    • Modifique o preço do item como se você fosse realizar uma sincronização normal de preços
    • Inclua o item novamente à campanha

    • Nota:
      - Os itens que participam das ofertas coparticipação (Campanha Marketplace) 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 de coparticipação ao fazer uma alteração de preço (manual ou automática).

      Eliminar itens

      Com este recurso é possível eliminar uma 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/MLB1834747833?promotion_type=MARKETPLACE_CAMPAIGN&deal_id=P-MLB379009&offer_id=MLB1834747833-9eafadd4-16d2-49ae-b272-9a7a34585cb8'

      Resposta: Status 200 OK


      Conheça mais sobre Descontos por quantidade.


      Seguinte: Campanhas de desconto por volume

    banner footer

    Inscreva-se em nosso Newsletter

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