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.


Conteúdos

→Consultar detalhes da campanha com participação do Mercado Livre
    ↳Status
→Consultar itens em uma campanha com participação do Mercado Livre
    ↳Status do itens
→Indicar itens para uma campanha com participação do Mercado Livre
→Modificar itens
→Eliminar itens



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

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