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 (tipo 8 "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 3 (Smart Listing) e 8 (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
- O que é a tela Promoções?
- Quais tipos de promoção existem?
- Promoções recebidas × criadas localmente — qual a diferença?
- O que significa cada status (Candidato, Programada, Iniciada, Ativa, Finalizada)?
Promoções recebidas do canal
- Como sei que tenho uma promoção nova do canal para gerenciar?
- Como faço um anúncio participar de uma promoção do canal?
- Como tiro um anúncio da promoção?
Criação local (Promoção de Vendedor)
- Como criar uma promoção localmente para enviar ao canal?
- Quais campos são obrigatórios na criação?
- Como adicionar anúncios à promoção criada?
- Como editar preço ou datas dos anúncios em massa?
- Como excluir uma promoção criada localmente?
Detalhe da promoção (sub-tela)
- O que aparece no detalhe?
- Como filtrar anúncios da promoção por status (Candidato, Ativo, Programada, etc.)?
- Como visualizar um anúncio diretamente no canal?
Regras de negócio
- Por que só consigo excluir promoções "de vendedor"?
- Por que a Promoção de Vendedor tem vigência limitada a 31 dias?
- O que é "% Vendedor" vs "% Integração"?
- Por que a exclusão demora ("processamento em segundo plano")?
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:
| Tipo | Nome típico | Origem | Pode criar localmente? |
|---|---|---|---|
| 1 | Liquidação Meli | Recebido | Não |
| 2 | OneShot Deal | Recebido | Não |
| 3 | Smart Listing | Híbrido | Sim |
| 4 | Promoção de Marketplace | Recebido | Não |
| 5 | Cyber Monday / Black Friday | Recebido | Não |
| 6 | Compre N pague M | Recebido (com regra "Compre - pague") | Não |
| 7 | Liquidação Frete | Recebido | Não |
| 8 | Promoção de Vendedor | Criada localmente | Sim |
| 9, 10, 11 | Outras campanhas sazonais | Recebido | Não |
A tela mostra todos os tipos misturados, mas as ações disponíveis variam — só os tipos 3 e 8 aparecem no Novo → Tipo de promoção.
Promoções recebidas × criadas localmente — qual a diferença?
| Recebidas do canal | Criadas localmente (Tipo 8) | |
|---|---|---|
| Origem | Canal cria a campanha. | Lojista cria no idworks. |
| Datas | Definidas pelo canal. | Lojista escolhe (limite 31 dias). |
| Percentual | Negociado pelo canal (% vendedor + % canal). | Lojista define o % Vendedor. |
| Anúncios participantes | Lojista escolhe — pode entrar e sair. | Lojista monta a lista do zero. |
| Pode editar campos da promoção | Não — só decidir participação. | Sim, enquanto não está Ativa. |
| Pode excluir | Nã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:
| Status | Significado |
|---|---|
| 1 — Candidato | O canal selecionou o anúncio como elegível, mas o lojista ainda não decidiu se participa. |
| 2 — Iniciado | A promoção entrou em vigor (data início chegou) — anúncios participantes começam a vender com o desconto. |
| 3 — Programada | Aceito para participar, mas a data de início ainda não chegou. |
| 4 — Ativo | Anúncio está participando ativamente. |
| 5 — Finalizada | Vigê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:
- Uma nova linha aparece na lista de Promoções com anúncios candidatos vinculados.
- O Prazo final para participar indica até quando o lojista pode decidir.
- 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?
- Acesse Integrações → Promoções.
- Clique no ícone de Editar (ou duplo clique) na linha da promoção que tem Candidatos.
- Na sub-tela, filtre por status Candidatos (radio no topo).
- Selecione os anúncios que vão participar (caixa à esquerda) — pode marcar vários.
- Clique no botão Adicionar Itens (só aparece em promoções tipo 8 e 3 — em outros tipos a adesão é feita anúncio a anúncio pelo ícone de Editar na linha).
- Para promoções com regras de preço, abre uma janela pedindo o SellingPrice ou as datas — preencha e salve.
- 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?
- Abra o detalhe da promoção.
- Selecione os anúncios que vão sair (caixa à esquerda).
- Clique em Deixar de participar (botão danger).
- 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 tipos 3 (Smart Listing) ou 8 (Promoção de Vendedor):
- Clique em Criar Promoção.
- Preencha:
- * Conta.
- * Integração (somente Mercado Livre).
- * Tipo de promoção — Smart Listing ou Promoção de Vendedor.
- * Nome da promoção.
- Se tipo = 8 (Promoção de Vendedor): * Vigência (RangePicker, mínimo hoje, máximo 31 dias) + % Vendedor (desconto que o vendedor concede).
- 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 tipos 3 e 8 estão disponíveis.
- Nome da promoção.
Quando o tipo é 8 (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 tipo 3 (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:
- Clique em Adicionar Itens (botão visível apenas em tipos 8 e 3).
- Abre uma janela de busca de SKUs/anúncios — busque por nome, código de referência ou código do anúncio.
- Selecione vários anúncios na lista.
- Para cada anúncio adicionado em tipo 8, o sistema pede:
- OriginalPrice — preço antes do desconto.
- SellingPrice — preço durante a promoção (com o desconto aplicado).
- Datas (quando aplicável).
- 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):
- Abra o detalhe da promoção.
- Selecione os anúncios desejados (caixa à esquerda).
- Clique em Editar em Massa (botão visível em tipos 1, 5, 8 sem percentual, 3 e 4).
- Aparece uma janela com os campos editáveis conforme o tipo da promoção.
- 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 tipo 8 (Promoção de Vendedor) podem ser excluídas — as recebidas do canal não.
- Na lista, clique no ícone de lixeira na linha (visível apenas em tipo 8).
- Confirme.
- 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 tipo 6), status do canal e descrição de erro (apenas tipo 8 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 tipo 8 (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 IDTypeHubProductPromotion === 8.
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 (tipo 8) 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 (tipo 8) é 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.
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 configurar | O que define |
|---|---|
| Configurações → Integrações | Quais canais de venda fazem pull de promoções. |
| Integrações → Hub Pagamento / Hub Marcas / Hub Categorias | Mapeamentos 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égio | Libera |
|---|---|
| Visualizar Promoções | Acesso à tela, à lista e ao detalhe das promoções. |
| Criar Promoções | Botão Criar Promoção (somente tipos 3 e 8). |
| Editar Promoções | Adicionar anúncios à promoção, editar preços/datas em massa, deixar de participar. |
| Deletar Promoções | Excluir uma promoção criada localmente (apenas tipo 8). |