Lista de Campanhas
Módulo: Comercial Caminho na aplicação: Menu > Comercial > Campanhas Última atualização: 20/04/2026
Para que serve
Exibe todas as campanhas e promoções cadastradas no tenant. Campanhas definem benefícios automáticos (descontos, bonificações, frete grátis, brindes, progressivas) aplicados em pedidos que satisfazem as regras de elegibilidade.
Quem pode usar
Usuários com acesso ao módulo Comercial.
Como usar (passo a passo)
- Acesse Menu > Comercial > Campanhas.
- Use o campo de busca para filtrar por descrição.
- Clique no ícone Editar (lápis) na coluna de ações da linha para abrir o cadastro de edição.
- Clique em "Nova Campanha" para criar uma nova campanha.
- Clique no ícone de lixeira para remover (confirmação obrigatória).
- A lista carrega mais registros ao rolar até o fim (scroll infinito, lotes de 50).
Campos da tela
Filtros
| Campo | Obrigatório | O que preencher | Observações |
|---|---|---|---|
| Busca | Não | Descrição | Filtra em tempo real |
Colunas da tabela
| Coluna | Descrição |
|---|---|
| ID | Identificador interno sequencial |
| Descrição | Nome da campanha |
| Tipo | Desc. Percentual, Desc. Valor, Bonificação, Frete Grátis, Brinde ou Progressiva |
| Vigência | Período no formato DD/MM/AAAA - DD/MM/AAAA |
| Prioridade | Número de prioridade (menor = maior prioridade) |
| Acumulável | "Sim" quando pode ser combinada com outras campanhas |
| Situação | Tag: Ativa (verde), Rascunho (cinza), Pausada (amarelo), Encerrada (vermelho) |
| Ações | Lixeira para remover |
Validações e regras
- A remoção usa confirmação antes de excluir.
- Somente campanhas ativas e dentro da vigência são consideradas no cálculo de pedidos.
- Campanhas com prioridade menor têm precedência sobre as demais quando não são acumuláveis.
Mensagens de erro e o que fazer
| Mensagem | Causa | Como resolver |
|---|---|---|
| "Erro ao carregar campanhas" | Falha de comunicação com a API | Verifique a conexão e recarregue a página |
| "Campanha removida com sucesso" | Remoção bem-sucedida | — |
| "Erro ao remover campanha" | Campanha em uso ou erro na API | ⚠️ CONFIRMAR mensagem exata do backend |
Integrações e dependências
- Serviço:
campanhasService(campanhas.service) - Campanhas são usadas nos Pedidos de Venda
Dúvidas frequentes
O que é prioridade? Quando um pedido elegível a várias campanhas não acumuláveis, o sistema aplica somente a de menor número de prioridade.
Campanhas acumuláveis se somam? Sim. Campanhas marcadas como acumuláveis podem ser aplicadas em conjunto com outras no mesmo pedido.
Histórico de alterações
| Data | Alteração |
|---|---|
| 20/04/2026 | Documento inicial criado. |