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