Gerenciar promoções

Com o recurso /seller-promotions você pode centralizar todos os tipos de promoções disponíveis como Campanhas tradicionais (DEAL), Campanhas com participação do Mercado Livre (MARKETPLACE_CAMPAIGN), Descontos individuais (PRICE_DISCOUNT), Ofertas relâmpago (LIGHTNING), Ofertas do dia (DOD), Desconto por volume (VOLUME) e desconto pré-acordado por item (PRE NEGOTIATED). Além dos novos tipos de ofertas que disponibilizamos.


Conteúdo

→Características das promoções
→Disponibilidade de promoção por país
→Consultar as promoções disponíveis para o vendedor
→Consultar os detalhes da promoção
    ↳Status
→Consultar itens da promoção
→Participar de uma promoção
→Consultar as promoções de itens
→Modificar itens
→Eliminar itens
→Atribuir campanha para teste



Características das promoções


Tipo de campanha Nome Definição de preço Sugestão de preço Bonificação MELI Stock para participar Deadline Aprovação
Tradicional DEAL Usuário define Não Não Não Sim Sim
Campanhas com participação MARKETPLACE CAMPAIGN Usuário aceita Não Sim Não Sim Não
Oferta do dia DOD Usuário define Sim Não Sim, informativo Não Não
Oferta relâmpago LIGHTNING Usuário define Sim Não Sim, obrigatório Não Não
Desconto por volume VOLUME Usuário aceita Não Sim Não Sim Não
Desconto pré-acordado por item PRE_NEGOTIATED Usuário concordar e aceita Não Sim Sim Sim Não


Disponibilidade de promoção por país


Site Campanha tradicional
(DEAL)
Campanha com participação
(MARKETPLACE CAMPAIGN)
Desconto individual
(PRICE DISCOUNT)
Desconto por volume
(VOLUME)
Desconto pré-acordado por item
(PRE_NEGOTIATED)
Oferta do dia
(DOD)
Oferta relâmpago
(LIGHTNING)
MLA
MLB
MLM
MCO
MLC
MLU
MPE
MLV

Consultar as promoções disponíveis para o vendedor

Lembre-se de que um usuário pode ter mais de um convite e de diferentes tipos.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/users/$USER_ID'

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' 'https://api.mercadolibre.com/seller-promotions/users/631366846'

Resposta:


    {
	"results": [{
			"id": "MLB686",
			"type": "DEAL",
			"status": "started",
			"start_date": "2020-02-04T17:50:00Z",
			"finish_date": "2022-10-31T17:20:00Z",
			"deadline_date": "2020-01-30T02:00:00Z",
			"name": "HOTSALE"
		},
		{
			"id": "DOD-MLB1000",
			"type": "DOD",
			"status": "started",
			"start_date": "2000-01-01T00:00:00.000Z"
		},
		{
			"id": "LGH-MLB1000",
			"type": "LIGHTNING",
			"status": "started",
			"start_date": "2000-01-01T00:00:00.000Z"
		},
		{
			"id": "P-MLB379009",
			"type": "VOLUME",
			"status": "started",
			"start_date": "2021-03-25T16:40:00Z",
			"finish_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
			}
		},
		{
			"id": "P-MLB380001",
			"type": "VOLUME",
			"status": "started",
			"start_date": "2021-03-25T19:00:00Z",
			"finish_date": "2021-04-30T18:00:00Z",
			"name": "test volume MLB BNSP",
			"benefits": {
				"type": "VOLUME",
				"meli_percent": 10,
				"seller_percent": 30,
				"name": "buy 4 save 40%",
				"buy_quantity": 4,
				"item_discount_percent": 40
			}
		},
		{
			"id": "P-MLB380002",
			"type": "VOLUME",
			"status": "started",
			"start_date": "2021-03-25T19:30:00Z",
			"finish_date": "2021-04-30T18:00:00Z",
			"name": "test volume MLB SPONTH",
			"benefits": {
				"type": "VOLUME",
				"meli_percent": 8,
				"seller_percent": 17,
				"name": "save 50% on 2nd",
				"buy_quantity": 2,
				"item_discount_percent": 25
			}
		},
		{
			"id": "P-MLB382001",
			"type": "MARKETPLACE_CAMPAIGN",
			"status": "started",
			"start_date": "2021-03-25T22:36:00Z",
			"finish_date": "2021-04-30T18:00:00Z",
			"name": "test cofondeada",
			"benefits": {
				"type": "REBATE",
				"meli_percent": 2,
				"seller_percent": 8
			}
		},
		{
			"id": "P-MLM394001",
			"type": "PRE_NEGOTIATED",
			"status": "started",
			"start_date": "2021-03-30T18:30:15.525Z",
			"finish_date": "2021-12-27T17:59:59.525Z",
			"deadline_date": "2021-05-27T17:59:59.525Z",
			"name": "Prueba descuento x item sin benefit"
		}
	],
	"paging": {
		"offset": 0,
		"limit": 50,
		"total": 7
	}
}

Campos de resposta

id: código de identificação da promoção.
type: tipo de oferta (DEAL, MARKETPLACE_CAMPAIGN, DOD, LIGHTNING, PRE NEGOTIATED).
status: Status.
start_date: data de início da promoção.
finish_date: data de fim da promoção.
deadline_date: prazo máximo para aceitar o convite para participar da oferta.
name: nome da promoção.
deadline_date: prazo máximo para aceitar o convite para participar da promoção.
benefits: configurações de benefícios de promoção.


Consultar os detalhes da promoção

Realize a seguinte consulta para acessar os detalhes específicos de uma campanha tradicional, uma campanha com participação Mercado Livre e para os descontos por volume.

Chamada:

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

Saiba mais sobre campanha tradicional, campanha com participação do Mercado Livre, desconto por volume e desconto pré-acordado por item. .


Status

Abaixo você encontra os possíveis status que os diferentes tipos de promoções:


Consultar itens da promoção

Para conhecer os itens que fazem parte de uma determinada promoção pode-se fazer a seguinte consulta:

Chamada:

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

Além disso, pode consultar itens de uma campanha tradicional, itens em uma campanha com participação do Mercado Livre e os itens que podem acessar descontos por volume.
Aqui você pode verificar os itens de uma oferta do dia, de uma oferta relâmpago e o status da campanha com um desconto pré-acordado por item.



Participar de uma promoção

Você pode participar de diversos tipos de promoções e até oferecer um desconto individual para itens:


Consultar as promoções de itens

Para ofertas DEALS, retornaremos apenas itens com status aprovado (status = aprovado).
Não aprovaremos as campanhas em teste e elas permanecerão com o status pending_approval, ou seja, você não verá o preço na promoção.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/$ITEM_ID

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/seller-promotions/items/MLA876768946

Resposta:




{
"results":
[
  {
    "id": "2864-MLB876768946",
    "type": "PRICE_DISCOUNT",
    "status": "started",
    "price": 700,
    "top_price": 650,
    "start_date": "2020-09-09T00:00:00",
    "finish_date": "2020-09-15T00:00:00"
  },
  {
    "id": "MLB686",
    "type": "DEAL",
    "status": "started",
    "price": 680,
    "start_date": "2021-03-04T17:50:00Z",
    "finish_date": "2021-10-31T17:20:00Z",
    "deadline_date": "2021-03-03T02:00:00Z",
    "name": "HOT SALE"
  },
  {
    "id": "P-MLB119001",
    "type": "MARKETPLACE_CAMPAIGN",
    "status": "started",
    "start_date": "2021-04-15T18:37:40.881Z",
    "finish_date": "2021-04-30T18:37:40.881Z",
    "name": "10% en herramientas",
    "benefits": {
           "type": "REBATE",
           "meli_percent": 2,
           "seller_percent": 8
       }
  },
  {
       "id": "1504782-MLA874447795",
       "type": "DOD",
       "status": "started",
       "price": 789,
       "start_date": "2021-04-19T00:00:00",
       "finish_date": "2021-04-19T23:59:59.999999999"
   },
   {
       "id": "1499515-MLA915978647",
       "type": "LIGHTNING",
       "status": "started",
       "price": 745,
       "start_date": "2021-04-19T06:00:00",
       "finish_date": "2021-04-19T12:00:00",
       "remaining_stock": 3
   },
   {
       "id": "P-MLB379009",
       "type": "VOLUME",
       "status": "started",
       "start_date": "2021-03-25T16:40:00Z",
       "finish_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
       }
   },
   {
       "id": "P-MLM394001",
       "type": "PRE_NEGOTIATED",
       "status": "started",
       "start_date": "2021-03-30T18:30:15.525Z",
       "finish_date": "2021-12-27T17:59:59.525Z",
       "deadline_date": "2021-05-27T17:59:59.525Z",
       "name": "Prueba descuento x item sin benefit",
       "offers": [
           {
               "id": "MLM848619385-f588cf87-e298-498e-82ad-285b16dd11d5",
               "original_price": 101,
               "new_price": 21,
               "status": "active",
               "start_date": "2021-05-10T16:00:00Z",
               "end_date": "2021-05-11T15:00:00Z",
               "benefits": {
                   "type": "REBATE",
                   "meli_percent": 9.9,
                   "seller_percent": 69.3
               }
           }
       ]
   }

]
}






Modificar itens

Para modificar os itens que estão participando de uma oferta, pode fazer isso da seguinte maneira:

Nota:
Para editar os descontos individuais (PRICE DISCOUNT), as ofertas do dia (DOD) e as ofertas relâmpago (LIGHTNING) você deve excluir a promoção e aplicá-la novamente.


Eliminar itens

Com este recurso é possível eliminar uma oferta do item antes que o prazo acabe:


Atribuir campanha para teste

Para fazer testes com campanhas teste, envie os dados de seu usuário e/ou itens no seguinte formulário.
Lembre-se de que os usuários quanto itens devem ser testes.


Nota:
Você deve adicionar o parâmetro version = test dentro das chamadas para interagir com as promoções de teste. Isso se aplica a campanhas coparticipação (MARKETPLACE_CAMPAIGN), campanhas de desconto por volume (VOLUME), desconto pré-acordado por item (PRE_NEGOTIATED), ofertas do dia (DOD), Ofertas Flash (LIGHTNING) e também para descontos individuais (PRICE_DISCOUNT).
O único tipo de promoção que não tem escopo de teste são as campanhas tradicionais (DEALS) que utilizam campanhas produtivas voltadas exclusivamente para teste.

Seguinte: Campanhas tradicionais

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