Gerenciar ofertas

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:

• Indicando itens para uma campanha tradicional.
• Indicando itens para uma campanha com participação do Mercado Livre.
• Oferecendo um desconto individual para uma publicação.

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:

• Modificar itens de uma campanha tradicional.
• Modificar itens de uma campanha com participação do Mercado Livre.

Eliminar itens de uma oferta

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

• Eliminanando itens da uma campanha tradicional.
• Eliminando itens de uma campanha com participação do Mercado Livre.
• Eliminando desconto individual para um item.

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.