Campanha com participação do Mercado Livre

Os vendedores que recebem assessoramento por parte da equipe comercial do Mercado Livre são convidados periodicamente a participar de diferentes campanhas de ofertas que se realizam 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 do 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 do campanha com participação do Mercado Livre

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

Chamada da oferta MARKETPLACE_CAMPAIGN:

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
  }
}

Status

Esses são os diferentes estados pelos quais uma campanha com participação do Mercado Livre pode passar:

Status	Descrição
pending_approval	Oferta pendente de aprovação.
pending	Oferta aprovada que ainda não começou.
started	Oferta ativa.
finished	Oferta finalizada.

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

Para saber os itens candidatos que fazem parte de uma campanha com participação do Mercado Livre, realize o seguinte GET:

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": "",
            "price": 0,
            "original_price": 0
        }
    ],
    "paging": {
        "total": 2
    }
}

Ao criar uma nova campanha, todos os itens aplicáveis a ela são selecionados. O status inicial dos itens é com "status" vazio e sem offer_id atribuído. Quando o vendedor adiciona um item à campanha seu status é modificado é atribuído um "offer_id" exclusivo.

Status do itens

Possíveis status que os itens podem assumir neste tipo de campanha:

Status	Descrição
active	Iten con oferta ativa.
programmed	Iten con oferta aprovada e programada.

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

Depois de ter sido convidado a participar de uma com participação do Mercado Livre, com o seguinte POST é possível indicar os produtos que deseja incluir nesta campanha.

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 pertencem as campanhas com participação do Mercado Livre (Campanha Marketplace) não possuem preço fixo, portanto, se um item estiver participando e aumentar seu preço, sairá automaticamente da oferta e não poderá adicioná-lo novamente.
- Recomendamos que você valide se o item está participando de uma campanha co-financiada 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/MLA632979587?promotion_type=MARKETPLACE_CAMPAIGN&deal_id=1804&offer_id=MLA876618673-9eafadd4-16d2-49ae-b272-9a7a34585cb8

Resposta: Status 200 OK