Pular para o conteúdo principal

Promoções

A tela Promoções gerencia as campanhas promocionais aplicadas aos anúncios no canal de venda (principalmente Mercado Livre). Cada linha é uma promoção do canal — com tipo (Liquidação, OneShot, Smart Listing, Promoção de Vendedor, etc.), datas de vigência, percentuais oferecidos pelo vendedor e pelo canal, e a lista de anúncios participantes. A tela trabalha com dois fluxos coexistentes: promoções recebidas do canal (Liquidação Meli, Black Friday — o canal cria a campanha e o vendedor escolhe quais anúncios participam) e promoções criadas localmente e enviadas ao canal (Promoção de Vendedor — o lojista decide datas e descontos).

Cada promoção tem uma sub-tela de detalhe (aberta em nova aba) onde o time consulta o status atual (Candidato, Programada, Iniciada, Ativa, Finalizada), a lista de itens participantes filtrável por status, e as ações em massa para adicionar/remover anúncios ou editar percentuais. A criação local só funciona para os tipos Smart Listing e Promoção de Vendedor — os demais tipos são exclusivamente recebidos do canal.

Esta tela não tem parametrizações próprias em Configurações → Parametrizações. Os tipos e status disponíveis são fixos no canal.

Índice​

Conceito

Promoções recebidas do canal

Criação local (Promoção de Vendedor)

Detalhe da promoção (sub-tela)

Regras de negócio

Boas práticas

Referência rápida

O que é a tela Promoções?​

É a tela onde o time gerencia campanhas promocionais dos anúncios no canal de venda. Funciona como ponte entre o canal (que oferece campanhas como Liquidação Meli, Black Friday, OneShot Deal) e a operação local (escolher quais anúncios participam, criar promoções próprias e enviá-las). Cada promoção lista os anúncios participantes, percentuais de desconto, datas de vigência e o status atual no canal.

📍 Onde: menu lateral → Integrações → Promoções.

Quais tipos de promoção existem?​

O Mercado Livre tem cerca de 10 tipos diferentes — alguns recebidos do canal, um criado localmente:

Nome típicoOrigemPode criar localmente?
Liquidação MeliRecebidoNão
OneShot DealRecebidoNão
Smart ListingHíbridoSim
Promoção de MarketplaceRecebidoNão
Cyber Monday / Black FridayRecebidoNão
Compre N pague MRecebido (com regra "Compre - pague")Não
Liquidação FreteRecebidoNão
Promoção de VendedorCriada localmenteSim
Outras campanhas sazonaisRecebidoNão

A tela mostra todos os tipos misturados, mas as ações disponíveis variam — só Smart Listing e Promoção de Vendedor aparecem no Novo → Tipo de promoção.

Promoções recebidas × criadas localmente — qual a diferença?​

Recebidas do canalCriadas localmente (Promoção de Vendedor)
OrigemCanal cria a campanha.Lojista cria no idworks.
DatasDefinidas pelo canal.Lojista escolhe (limite 31 dias).
PercentualNegociado pelo canal (% vendedor + % canal).Lojista define o % Vendedor.
Anúncios participantesLojista escolhe — pode entrar e sair.Lojista monta a lista do zero.
Pode editar campos da promoçãoNão — só decidir participação.Sim, enquanto não está Ativa.
Pode excluirNão — só sair (deixar de participar).Sim.

A maioria absoluta das promoções no idworks é recebida — Promoções de Vendedor (criadas localmente) são uma minoria, usadas para campanhas específicas que o vendedor controla.

O que significa cada status (Candidato, Programada, Iniciada, Ativa, Finalizada)?​

Cada promoção e cada anúncio dentro dela tem um status que reflete o ciclo no canal:

StatusSignificado
CandidatoO canal selecionou o anúncio como elegível, mas o lojista ainda não decidiu se participa.
IniciadoA promoção entrou em vigor (data início chegou) — anúncios participantes começam a vender com o desconto.
ProgramadaAceito para participar, mas a data de início ainda não chegou.
AtivoAnúncio está participando ativamente.
FinalizadaVigência acabou — anúncio voltou ao preço normal.

Promoções criadas localmente geralmente passam por: Candidato (rascunho local) → Programada (envio aceito) → Iniciada (data início) → Ativa → Finalizada (data fim).

Como sei que tenho uma promoção nova do canal para gerenciar?​

A integração com o canal faz pull periódico das campanhas disponíveis. Sempre que uma campanha nova chega:

  1. Uma nova linha aparece na lista de Promoções com anúncios candidatos vinculados.
  2. O Prazo final para participar indica até quando o lojista pode decidir.
  3. Acessando o detalhe da promoção, vê-se a lista de anúncios elegíveis com status Candidato.

Boa prática: consultar a tela diariamente para não perder prazos — algumas campanhas (OneShot, Black Friday) têm janelas curtas de adesão.

Como faço um anúncio participar de uma promoção do canal?​

  1. Acesse Integrações → Promoções.
  2. Clique no ícone de Editar (ou duplo clique) na linha da promoção que tem Candidatos.
  3. Na sub-tela, filtre por status Candidatos (radio no topo).
  4. Selecione os anúncios que vão participar (caixa à esquerda) — pode marcar vários.
  5. Clique no botão Adicionar Itens (só aparece em Promoção de Vendedor e Smart Listing — em outros tipos a adesão é feita anúncio a anúncio pelo ícone de Editar na linha).
  6. Para promoções com regras de preço, abre uma janela pedindo o SellingPrice ou as datas — preencha e salve.
  7. Os anúncios passam para Programada (ou direto Ativa, conforme a data de início).

Em promoções onde o vendedor não escolhe (Cyber Monday, Liquidação Meli onde o canal já decidiu por você), o ato de "adicionar" é apenas confirmar a participação — o desconto é fixo.

Pré-requisito: privilégio Editar Promoções.

Como tiro um anúncio da promoção?​

  1. Abra o detalhe da promoção.
  2. Selecione os anúncios que vão sair (caixa à esquerda).
  3. Clique em Deixar de participar (botão danger).
  4. Confirme.

Os anúncios saem da promoção e voltam ao preço normal no canal (a partir da próxima sincronização). Não é possível "remover" a promoção em si — ela é do canal — apenas reduzir a lista de participantes.

Pré-requisito: privilégio Editar Promoções.

Como criar uma promoção localmente para enviar ao canal?​

Funciona apenas para os tipos Smart Listing ou Promoção de Vendedor:

  1. Clique em Criar Promoção.
  2. Preencha:
    • * Conta.
    • * Integração (somente Mercado Livre).
    • * Tipo de promoção — Smart Listing ou Promoção de Vendedor.
    • * Nome da promoção.
    • Se Promoção de Vendedor: * Vigência (RangePicker, mínimo hoje, máximo 31 dias) + % Vendedor (desconto que o vendedor concede).
  3. Clique em Salvar.

A promoção entra com status Candidato localmente. Adicione os anúncios (Adicionar Itens) e ao salvar pela primeira vez, o sistema envia ao canal — após confirmação, o status vira Programada (aguardando data de início).

Pré-requisito: privilégio Criar Promoções.

Quais campos são obrigatórios na criação?​

São obrigatórios na criação:

  • Conta — quando há mais de uma.
  • Integração Mercado Livre.
  • Tipo de promoção — apenas Smart Listing e Promoção de Vendedor estão disponíveis.
  • Nome da promoção.

Quando o tipo é Promoção de Vendedor, também são obrigatórios:

  • Vigência — período válido (mínimo hoje, máximo 31 dias).
  • % Vendedor — desconto oferecido pelo vendedor (em decimais).

Para Smart Listing, apenas os campos básicos são obrigatórios — o canal calcula o desconto baseado em algoritmo próprio.

Como adicionar anúncios à promoção criada?​

Após criar a promoção (vigente em status Candidato), abra o detalhe (duplo clique). No detalhe:

  1. Clique em Adicionar Itens (botão visível apenas em Promoção de Vendedor e Smart Listing).
  2. Abre uma janela de busca de SKUs/anúncios — busque por nome, código de referência ou código do anúncio.
  3. Selecione vários anúncios na lista.
  4. Para cada anúncio adicionado em Promoção de Vendedor, o sistema pede:
    • OriginalPrice — preço antes do desconto.
    • SellingPrice — preço durante a promoção (com o desconto aplicado).
    • Datas (quando aplicável).
  5. Clique em Salvar. Os anúncios entram em lotes de 5 (com rate limiting do canal).

Como editar preço ou datas dos anúncios em massa?​

Quando vários anúncios precisam ter o mesmo ajuste (ex.: estender a data fim ou mudar o preço promocional):

  1. Abra o detalhe da promoção.
  2. Selecione os anúncios desejados (caixa à esquerda).
  3. Clique em Editar em Massa (botão visível em Liquidação Meli, Cyber Monday / Black Friday, Promoção de Vendedor sem percentual, Smart Listing e Promoção de Marketplace).
  4. Aparece uma janela com os campos editáveis conforme o tipo da promoção.
  5. Preencha o que quer atualizar e salve.

O sistema aplica a mudança em todos os selecionados, em lote.

Como excluir uma promoção criada localmente?​

Apenas promoções do tipo Promoção de Vendedor podem ser excluídas — as recebidas do canal não.

  1. Na lista, clique no ícone de lixeira na linha (visível apenas em Promoção de Vendedor).
  2. Confirme.
  3. O sistema dispara o cancelamento em segundo plano — a remoção propaga para o canal e leva alguns minutos.

Uma mensagem informa que o processamento está em andamento. Após a confirmação do canal, a promoção sai da lista e os anúncios voltam ao preço normal.

Pré-requisito: privilégio Deletar Promoções.

O que aparece no detalhe?​

A sub-tela de detalhe (aba) mostra:

  • Cabeçalho com nome, integração, status, tipo, prazo final, datas de vigência, percentuais (vendedor e canal), código externo do canal, regra "Compre - pague" (apenas em Compre N pague M), status do canal e descrição de erro (apenas em Promoção de Vendedor quando falha o envio).
  • Filtros de status (radio no topo) — Todos, Candidatos, Ativos, Programada, Iniciado, Finalizada — para reduzir a lista exibida.
  • Tabela de anúncios participantes com colunas variáveis (algumas escondidas por tipo): nome do produto, código do anúncio, preço original, preço promocional, datas, quantidade disponível, status.
  • Ações por linha: Visualizar Anúncio (abre no canal) e Editar (modal de edição do preço/data).
  • Ações em massa: Deixar de participar, Editar em Massa, Adicionar Itens (conforme tipo).

Como filtrar anúncios da promoção por status?​

No detalhe da promoção, o Radio.Group de filtros logo abaixo do cabeçalho permite:

  • Todos — vê tudo.
  • Candidatos — anúncios que ainda não foram adicionados, mas o canal selecionou como elegíveis.
  • Ativos — em vigor no momento.
  • Programada — aceito para participar, mas ainda fora da data de vigência.
  • Iniciado — entrou em vigor.
  • Finalizada — vigência encerrada.

A escolha do filtro dispara nova consulta paginada (lotes de 1000 itens).

Como visualizar um anúncio diretamente no canal?​

Na tabela de anúncios da promoção, há uma coluna de ação por linha com o botão Visualizar Anúncio — clicando, abre o anúncio diretamente no canal de venda (Mercado Livre, etc.) em nova aba. Útil para conferir como o desconto está aparecendo para o comprador, ou para fazer alguma alteração diretamente no canal antes/depois de promoção.

Por que só consigo excluir promoções "de vendedor"?​

Só promoções do tipo Promoção de Vendedor permitem exclusão porque são as únicas criadas pelo lojista. As outras (Liquidação Meli, Cyber Monday, OneShot, etc.) são campanhas do canal — o canal as criou e mantém. O lojista não pode "deletar" uma campanha do Mercado Livre; apenas não participar dela (Deixar de participar, que é diferente).

Por isso o ícone de lixeira nas linhas só fica habilitado quando o tipo é Promoção de Vendedor.

Por que a Promoção de Vendedor tem vigência limitada a 31 dias?​

Regra imposta pelo canal (Mercado Livre): campanhas criadas pelo vendedor têm duração máxima de 31 dias consecutivos. Para promoções mais longas, o lojista precisa criar promoções consecutivas (uma terminando, outra começando logo depois) ou aguardar promoções do próprio canal (que podem ser mais longas).

O sistema valida no RangePicker da criação — não é possível selecionar período maior que 31 dias.

O que é "% Vendedor" vs "% Integração"?​

Em promoções recebidas do canal, o desconto pode ser dividido:

  • % Vendedor — desconto que sai do bolso do vendedor (afeta a margem do lojista).
  • % Integração — desconto subsidiado pelo canal (não afeta a margem do lojista, é "presente" do canal para o comprador).

Em Cyber Monday por exemplo, o Mercado Livre frequentemente subsidia parte do desconto — % Integração mostra essa contribuição. Em Promoções de Vendedor só existe % Vendedor (o canal não subsidia).

Por que a exclusão demora ("processamento em segundo plano")?​

A exclusão de Promoção de Vendedor é assíncrona: o idworks marca a intenção, dispara um worker em segundo plano que comunica com o canal. O canal precisa confirmar antes que a promoção desapareça localmente — pode demorar alguns minutos.

Durante esse intervalo, a promoção continua visível na lista com um indicador de "em remoção". Após confirmação, ela some.

Boas práticas para as promoções​

Gerir bem as promoções evita perder janelas de campanha, corroer a margem sem perceber e bagunçar o preço dos anúncios no canal. Recomendações:

  • Consulte a tela com frequência para não perder prazo. Campanhas como OneShot e Black Friday têm janela curta de adesão — o Prazo final para participar mostra até quando você pode entrar com cada anúncio.
  • Olhe o "% Vendedor" antes de aderir. É o desconto que sai da sua margem; o "% Integração" é subsidiado pelo canal e não pesa no seu bolso. Em Promoção de Vendedor só existe o % Vendedor, então o desconto é todo seu.
  • Para sair de uma campanha do canal, use "Deixar de participar". Campanhas recebidas (Liquidação Meli, Cyber Monday) não podem ser excluídas — só dá para tirar os anúncios; a lixeira só funciona em Promoção de Vendedor.
  • Planeje campanhas longas em blocos. A Promoção de Vendedor é limitada a 31 dias pelo canal — para um período maior, emende promoções consecutivas ou use uma campanha do próprio canal.
  • Garanta os mapeamentos DE-PARA dos anúncios participantes. Hub Pagamento, Hub Marcas e Hub Categorias precisam estar resolvidos para que os anúncios da promoção funcionem corretamente no canal.
  • Exclua a Promoção de Vendedor com antecedência. A remoção roda em segundo plano e só some depois que o canal confirma — pode levar alguns minutos até os anúncios voltarem ao preço normal.

Resumo de parametrizações​

Esta tela não tem parametrizações próprias em Configurações → Parametrizações. Os tipos, status e regras de cada promoção vêm do canal de venda — não são editáveis pelo lojista.

Onde configurarO que define
Configurações → IntegraçõesQuais canais de venda fazem pull de promoções.
Integrações → Hub Pagamento / Hub Marcas / Hub CategoriasMapeamentos DE-PARA necessários para que os anúncios participantes funcionem corretamente.

⚠️ Não confundir com a tela Promoção PDV (cupons internos do idworks para o ponto de venda físico) — são duas coisas diferentes.

Privilégios da tela​

Esta tela tem privilégios próprios que controlam o que cada usuário pode fazer. Configure os perfis de acesso em Configurações → Perfis de Acesso vinculando os privilégios abaixo aos grupos desejados. Quando o usuário não tem o privilégio, a ação correspondente fica desabilitada na tela.

PrivilégioLibera
Visualizar PromoçõesAcesso à tela, à lista e ao detalhe das promoções.
Criar PromoçõesBotão Criar Promoção (somente Smart Listing e Promoção de Vendedor).
Editar PromoçõesAdicionar anúncios à promoção, editar preços/datas em massa, deixar de participar.
Deletar PromoçõesExcluir uma promoção criada localmente (apenas Promoção de Vendedor).
Última atualização em