Gerenciar ofertas

O recurso /seller-promotions centraliza todas as ofertas disponíveis como Campanhas tradicionais(DEAL) e Descontos individuais (PRICE_DISCOUNT), Campanhas com participação do Mercado Livre (MARKETPLACE_CAMPAIGN), e permitirá que novos tipos de oferta sejam incluídos.


Conteúdos

→Consultar as ofertas que o vendedor foi convidado
→Detalhes da oferta
    ↳Status
→Consultar itens da oferta
→Participar em uma oferta
→Consultar ofertas do item
→Modificar itens em uma oferta
→Eliminar itens de uma oferta
→Atribuir campanha teste



Consultar as ofertas que o vendedor foi convidado

Pode haver mais de um convite por usuário, inclusive convites de tipos de ofertas diferentes.

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": "MLA686",
      "type": "DEAL",
      "status": "started",
      "start_date": "2019-02-04T17:50:00Z",
      "finish_date": "2020-10-31T17:20:00Z",
      "deadline_date": "2020-09-29T22:00:00Z",
      "name": "HOTSALE"
    },
    {
      "id": "P-MLA119001",
      "type": "MARKETPLACE_CAMPAIGN",
      "status": "started",
      "start_date": "2020-10-15T18:37:40.881Z",
      "finish_date": "2020-12-30T18:37:40.881Z",
      "deadline_date": "2020-12-29T22:00:00Z",
      "name": "P-MLA1252"
    }
  ],
  "paging": {
    "offset": 0,
    "limit": 50,
    "total": 2
  }
}

Campos da resposta

id: código de identificação da oferta.
type: tipo de oferta (DEAL, MARKETPLACE_CAMPAIGN).
status: estado de uma campanha tradicional, status de uma campanha com participação do Mercado Livre.
start_date: data de início da oferta.
finish_date: data de fim da oferta.
start_date: fecha de inicio de la oferta.
deadline_date: prazo máximo para aceitar o convite para participar da oferta.
name: nome da campanha.


Detalhes da oferta

Para obter os detalhes das ofertas realize o seguinte GET com o parâmetro promotion_type=$PROMOTION_TYPE (DEAL o MARKETPLACE_CAMPAIGN).

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 e campanha com participação do Mercado Livre (campanha de marketplace).


Status

Possíveis status que as diferentes ofertas podem ter: status de uma campanha tradicional y status de uma campanha com participação do Mercado Livre.


Consultar itens da oferta

Para saber os itens de uma oferta, realize o seguinte GET:

Chamada:

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

Além disso, pode consultar itens de uma campanha tradicional e itens em uma campanha com participação do Mercado Livre.

Participar em uma oferta

Pode participar de diferentes tipos de campanhas. Além disso, você pode oferecer um desconto individual para os itens:


Consultar ofertas do item

Para ofertas de tipo DEALS só devolvemos itens com estado aprovado (status=approved).
Não aprovaremos campanhas com itens de teste, eles permanecerão com status pending_approval e não mostraremos o preço com oferta.

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

Respuesta:

[
  {
    "id": "2864-MLA876768946",
    "type": "PRICE_DISCOUNT",
    "status": "started",
    "price": 680,
    "top_price": 570,
    "start_date": "2020-09-09T00:00:00",
    "finish_date": "2020-09-15T00:00:00"
  },
  {
    "id": "MLA686",
    "type": "DEAL",
    "status": "started",
    "price": 680,
    "start_date": "2019-02-04T17:50:00Z",
    "finish_date": "2020-10-31T17:20:00Z",
    "deadline_date": "2020-09-30T02:00:00Z",
    "name": "Super deal"
  },
  {
    "id": "P-MLA119001",
    "type": "MARKETPLACE_CAMPAIGN",
    "status": "started",
    "start_date": "2020-10-15T18:37:40.881Z",
    "finish_date": "2020-12-30T18:37:40.881Z",
    "name": "P-MLA1252"
  }
]

Modificar itens em uma oferta

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), você deve excluí-los e registrá-los novamente.


Eliminar itens de uma oferta

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


Atribuir campanha teste

Para fazer testes com campanhas teste, envie os dados de seu usuário e/ou itens no seguinte formulario.
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 interatuar com essas campanhas.

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