Cupons - Listagem

O que é

A listagem de cupons é a tela central do módulo de promoções do Viagilize. Ela reúne todos os códigos promocionais cadastrados pela empresa - sejam eles cupons públicos divulgados em campanhas, cupons de uso único, cupons por cliente ou códigos gerados em lote - e mostra de forma rápida o status, o tipo, o valor do desconto e o progresso de usos de cada um.

Você costuma chegar aqui quando precisa conferir se um cupom já foi criado, acompanhar o desempenho de uma campanha, pausar um cupom temporariamente, ajustar regras antes de uma divulgação ou exportar a lista de códigos de um lote para entregar a um parceiro.

Como usar

1. Vá em Marketing > Cupons no menu lateral. A página abre em /admin/marketing/cupons (ou no caminho equivalente /admin/marketing/cupons).
2. Confira os quatro cartões de estatísticas no topo: Total de Cupons, Cupons Ativos, Usos este Mês e Descontos no Mês (soma em reais dos descontos aplicados nos pedidos do mês corrente).
3. Use a barra de filtros logo abaixo para localizar um cupom específico:
   • Buscar por código ou nome... - pesquisa por código, nome interno do cupom ou nome do lote.
   • Tipo - filtra por Publico, Uso Único, Por Cliente, Primeira Compra ou Indicacao.
   • Status - filtra por Ativos, Inativos, Expirados (com data de expiração no passado) ou Esgotados (limite total de usos já atingido).
4. Para cada cupom da lista, você pode:
   • Clicar no ícone de prancheta ao lado do código para copiá-lo para a área de transferência (aparece a confirmação "Copiado!").
   • Clicar em Editar para alterar regras, valor e validade.
   • Clicar em Ver Detalhes para abrir a página interna do cupom com todas as informações e os últimos 20 usos.
   • Clicar em Ver Usos (quando aparece) para abrir a lista completa de pedidos que aplicaram o cupom.
5. Para ações secundárias, use o dropdown de três pontinhos no canto direito do cartão: Visualizar, Editar, Ver Usos, Duplicar, Exportar CSV (cupons de lote), Ativar/Desativar e Excluir.
6. Para criar um cupom novo, clique no botão azul Novo Cupom no cabeçalho. Para gerar vários códigos de uma vez, clique em Gerar Lote.

Casos especiais

Cupons em lote

Quando um cupom é um lote (criado em Gerar Lote), ele aparece na listagem com um selo roxo indicando a quantidade de cupons filhos (por exemplo "100 cupons"). A listagem mostra apenas o cupom-pai do lote - os códigos filhos ficam ocultos para não poluir a lista. Para baixar todos os códigos do lote em planilha, use Exportar CSV no dropdown de ações: o arquivo gerado inclui código, status (Usado/Disponível), data de uso, cliente, e-mail e os valores do desconto.

Ativar e desativar em lote

Ao ativar ou desativar um cupom que é pai de lote, o sistema replica o novo status para todos os cupons filhos automaticamente. Útil para pausar uma campanha inteira de uma só vez sem precisar editar cada código.

Cupom esgotado ou expirado

Cupons com data de expiração no passado entram automaticamente no filtro Expirados e exibem a data em vermelho no cartão. Cupons que atingiram o limite de uso total aparecem no filtro Esgotados. Em ambos os casos, o cupom continua na listagem para consulta histórica, mas o sistema bloqueia novas aplicações no checkout.

Excluir não está aparecendo

A opção Excluir só aparece no dropdown se o cupom ainda não foi utilizado por nenhum cliente (usos = 0). Para cupons que já tiveram pelo menos um uso, a recomendação é Desativar, preservando o histórico de descontos aplicados em pedidos.

Erros comuns e como resolver

• "Não e possível excluir um cupom que ja foi utilizado. Desative-o ao inves disso." - Causa: você tentou excluir um cupom com pelo menos um uso registrado. Solução: use a opção Desativar no dropdown - o cupom fica indisponível para novos clientes, mas preserva o vínculo com os pedidos antigos.
• "Este cupom não e um lote." - Causa: a ação Exportar CSV foi acionada em um cupom comum (não-lote). Solução: a exportação CSV só está disponível para cupons gerados em Gerar Lote - use Ver Detalhes para consultar um cupom único.
• Cupom não aparece na lista - Causa: você criou um cupom em lote e está procurando pelos códigos filhos. Solução: a listagem mostra apenas o cupom-pai do lote (com o selo roxo indicando a quantidade). Abra o cupom-pai ou exporte o CSV para ver os códigos individuais.

Onde encontrar

• URL: /admin/marketing/cupons (a aplicação redireciona automaticamente para /admin/marketing/cupons)
• Caminho no menu: Marketing > Cupons
• Permissão necessária: ver os cupons (para abrir a lista), criar os cupons para os botões Novo Cupom, Gerar Lote e Duplicar, editar os cupons para Editar e Ativar/Desativar, excluir os cupons para Excluir
• Módulo necessário: nenhum

Veja também

• Criar Cupom
• Editar Cupom