Cupons

Bem-vindo ao guia de Cupons do CMS E-commerce! Este manual irá ajudá-lo a criar, gerenciar e organizar os cupons de desconto que são utilizados para oferecer promoções aos clientes no catálogo.

---

Visão Geral

A tela de Cupons permite que você:

• 📋 Visualize todos os cupons cadastrados no sistema
• 🔍 Filtre cupons por código e status
• ➕ Crie novos cupons de desconto para promoções
• ✏️ Edite cupons existentes para ajustar valores e condições
• 🗑️ Exclua cupons que não são mais necessários
• 📊 Acompanhe o uso dos cupons em tempo real

Os cupons são fundamentais para estratégias de marketing e vendas, permitindo que você ofereça descontos por porcentagem, valor fixo ou frete grátis aos seus clientes.

---

Acessando a Tela de Cupons

A tela de cupons está localizada no menu de Catálogo do sistema. Ao acessá-la, você verá:

• Título "Cupons"
• Subtítulo "Gerencie os cupons de desconto do catálogo"
• Botão "Novo Cupom"
• Barra de busca
• Filtro de Status
• Seletor de cupons por página
• Tabela com os cupons cadastrados

---

Como Buscar e Filtrar Cupons

Busca por Código

A barra de busca permite encontrar cupons específicos por código:

Como usar:

1. Digite o código do cupom no campo de busca (ex: "DESCONTO20", "FRETEGRATIS")
2. Pressione Enter para realizar a busca
3. Os resultados serão filtrados automaticamente

Dica

A busca funciona com códigos completos ou parciais. Por exemplo, digite "DESC" para encontrar "DESCONTO20" ou cupons relacionados.

---

Filtro por Status

O sistema oferece filtros para visualizar cupons por status:

Status Disponíveis:

• ✅ Ativo: Cupons que estão ativos e disponíveis para uso
• ❌ Inativo: Cupons desativados temporariamente
• 📋 Todos: Exibe todos os cupons independente do status

Como filtrar:

1. Clique no seletor "Status"
2. Escolha o status desejado na lista
3. A tabela será atualizada automaticamente

---

Cupons por Página

Para facilitar a navegação, você pode ajustar quantos cupons são exibidos por vez:

1. Localize o seletor "Cupons por página"
2. Escolha entre: 10, 15, 20, 25, 30 cupons por página
3. Use a paginação no rodapé da tabela para navegar

---

Entendendo a Tabela de Cupons

A tabela exibe as seguintes informações:

Colunas da Tabela

Coluna	Descrição
Código	Código do cupom em formato monoespaçado (Ex: DESCONTO20)
Tipo	Tipo do cupom com badge visual (Porcentagem, Valor Fixo, Frete Grátis)
Desconto	Valor do desconto em verde (Ex: 20%, R$ 50, Frete Grátis)
Status	Badge indicando se o cupom está Ativo ou Inativo

Indicadores Visuais

• Cada tipo de cupom é exibido com um badge cinza para fácil identificação
• Os valores de desconto aparecem em verde para destaque
• O status é exibido com badge azul (Ativo) ou badge cinza (Inativo)
• Linhas da tabela são clicáveis para acessar os detalhes do cupom

---

Como Criar um Novo Cupom

Passo a Passo para Criar

Passo 1: Clique em "Novo Cupom"

No canto superior direito da tela, clique no botão "Novo Cupom".

Passo 2: Preencha as Informações Básicas

Um modal será aberto com três seções. Comece preenchendo as Informações Básicas:

Campos da seção:

1. Código (obrigatório): Digite o código único do cupom

   • Use apenas letras, números e caracteres especiais (%, ., -, _)
   • O campo converte automaticamente para maiúsculas
   • Exemplo: DESCONTO20, FRETE-GRATIS, PROMO_NATAL

2. Tipo (obrigatório): Selecione o tipo do cupom

   • Porcentagem: Desconto percentual sobre o valor da compra
   • Valor Fixo: Desconto de um valor fixo em reais
   • Frete Grátis: Isenta o cliente do valor do frete

3. Desconto: Valor do desconto (obrigatório para Porcentagem e Valor Fixo)

   • Para Porcentagem: Digite o valor em % (Ex: 20)
   • Para Valor Fixo: Digite o valor em R$ (Ex: 50.00)
   • Para Frete Grátis: Este campo não aparece

4. Status (obrigatório): Define se o cupom estará ativo

   • Ativo: O cupom pode ser usado imediatamente
   • Inativo: O cupom não pode ser usado pelos clientes

5. Descrição (opcional): Descreva o cupom e suas condições

   • Use este campo para detalhar a promoção
   • Exemplo: "Cupom de 20% de desconto para primeira compra"

Campos Obrigatórios

Os campos marcados com * são obrigatórios e devem ser preenchidos para criar o cupom.

Passo 3: Configure Restrições e Limites

Na seção Restrições e Limites, configure as condições de uso:

Campos da seção:

1. Valor Mínimo da Compra (opcional): Define o valor mínimo em R$ para usar o cupom

   • Exemplo: 100.00 (o cliente precisa comprar no mínimo R$ 100)
   • Deixe vazio se não houver valor mínimo

2. Desconto Máximo (opcional, apenas para Porcentagem): Limite máximo de desconto em R$

   • Exemplo: Para 20% com máximo de R$ 200, uma compra de R$ 2000 terá desconto de R$ 200 (não R$ 400)
   • Protege contra descontos muito altos em compras grandes

3. Limite de Uso (obrigatório): Quantas vezes o cupom pode ser usado no total

   • Exemplo: 100 (o cupom pode ser usado 100 vezes por diferentes clientes)
   • Quando atingir o limite, o cupom não poderá mais ser usado

Dica Importante

O Desconto Máximo é especialmente útil para cupons de porcentagem, evitando perdas excessivas em compras de alto valor.

Passo 4: Defina o Período de Validade

Na seção Período de Validade, configure quando o cupom será válido:

Campos da seção:

1. Válido De (obrigatório): Data e hora de início da validade

   • Use o seletor de data e hora
   • O cupom só poderá ser usado a partir desta data/hora

2. Válido Até (obrigatório): Data e hora de término da validade

   • Use o seletor de data e hora
   • O cupom não poderá ser usado após esta data/hora

Atenção

Certifique-se de que a data "Válido Até" é posterior à data "Válido De". O sistema pode impedir a criação se as datas estiverem incorretas.

Passo 5: Confirme a Criação

1. Revise todos os dados preenchidos
2. Clique no botão "Criar Cupom"
3. Aguarde a confirmação (você verá "Criando...")
4. Você será redirecionado automaticamente para a tela de detalhes do novo cupom

Sucesso

Após criar o cupom, você será direcionado para a página de detalhes onde poderá visualizar todas as informações e acompanhar o uso do cupom.

---

Visualizando Detalhes de um Cupom

Para ver informações completas sobre um cupom:

1. Clique em qualquer linha da tabela
2. Você será direcionado para a tela de detalhes

Informações Disponíveis na Tela de Detalhes

1. Cabeçalho

• Código do cupom em destaque (formato monoespaçado)
• Badge de Status: Ativo (azul) ou Inativo (cinza)
• Ícone de ticket azul identificando o tipo de página
• Botão "Editar": Para modificar as informações
• Botão "Excluir": Para remover o cupom
• Botão "Voltar": Para retornar à lista de cupons

2. Card de Informações Básicas

Exibe:

• ID do Cupom: Identificador único (não editável, fundo cinza)
• Código: Código do cupom em formato monoespaçado
• Tipo de Cupom: Badge indicando Porcentagem, Valor Fixo ou Frete Grátis
• Descrição: Texto descritivo do cupom (ou "Sem descrição" se vazio)

3. Card de Valor do Desconto

Destaque visual do desconto com:

• Ícone grande colorido indicando o tipo (%, R$, ou Pacote)
• Valor do desconto em fonte grande e verde
• Badge do tipo ao lado do valor
• Desconto máximo (se aplicável para cupons de porcentagem)

4. Card de Uso do Cupom

Acompanhamento em tempo real do uso:

• Total de usos: Mostra quantas vezes foi usado / limite total
• Usos disponíveis: Quantos usos ainda restam
• Barra de progresso visual: Indica percentual de uso
• Percentual exato de uso

Importante

A barra de progresso atualiza em tempo real conforme o cupom é usado pelos clientes.

5. Card de Período de Validade

Informações de vigência:

• Válido de: Data e hora de início formatada (dd/MM/yyyy às HH:mm)
• Válido até: Data e hora de término formatada (dd/MM/yyyy às HH:mm)

6. Card de Restrições

Exibe condições de uso (se aplicável):

• Valor mínimo da compra: Valor mínimo necessário em R$
• Desconto máximo: Limite máximo de desconto para cupons de porcentagem

Dica

Este card só aparece se houver restrições configuradas no cupom.

7. Card de Informações de Auditoria

Criação:

• 👤 Criado por: Nome do usuário que criou
• 📅 Data de criação: Data e hora da criação

Última Atualização (quando aplicável):

• 👤 Atualizado por: Nome do usuário que fez a última alteração
• 📅 Data de atualização: Data e hora da última modificação

---

Como Editar um Cupom

Passo a Passo para Editar

Passo 1: Acesse os Detalhes

1. Clique no cupom desejado na tabela
2. Na tela de detalhes, clique no botão "Editar"

Passo 2: Modifique os Dados

Um modal será aberto com os dados atuais preenchidos. Você pode modificar:

Informações Básicas:

• Código do cupom
• Tipo do cupom
• Valor do desconto
• Status (Ativo/Inativo)
• Descrição

Restrições e Limites:

• Valor mínimo da compra
• Desconto máximo
• Limite de uso

Período de Validade:

• Data e hora de início
• Data e hora de término

Atenção

• Alterar o tipo de cupom pode impactar campanhas em andamento
• Reduzir o limite de uso para menos que o já utilizado pode causar problemas
• Certifique-se de que as alterações são realmente necessárias

Passo 3: Salve as Alterações

1. Revise as modificações
2. Clique no botão "Atualizar Cupom"
3. Aguarde a confirmação (você verá "Atualizando...")
4. As informações serão atualizadas automaticamente

---

Como Excluir um Cupom

Passo a Passo para Excluir

Importante

A exclusão de um cupom é uma ação irreversível. Cupons excluídos não podem ser recuperados.

Passo 1: Acesse os Detalhes

1. Clique no cupom desejado na tabela
2. Na tela de detalhes, clique no botão "Excluir" (vermelho)

Passo 2: Confirme a Exclusão

Um diálogo de confirmação será exibido com:

• Título: "Confirmar exclusão"
• Mensagem: Confirmação com o código do cupom
• Aviso: "Esta ação não pode ser desfeita"

Passo 3: Finalize a Exclusão

1. Leia atentamente o aviso
2. Clique em "Excluir" para confirmar (ou "Cancelar" para desistir)
3. Aguarde o processamento (você verá "Excluindo...")
4. Você será redirecionado para a lista de cupons

---

Casos de Uso Práticos

1. Criar Cupom de Primeira Compra

Situação: Você quer incentivar novos clientes com 15% de desconto.

Como fazer:

1. Clique em "Novo Cupom"
2. Código: PRIMEIRA15
3. Tipo: Porcentagem
4. Desconto: 15
5. Status: Ativo
6. Descrição: "15% de desconto para primeira compra"
7. Valor Mínimo: 50.00 (opcional)
8. Desconto Máximo: 100.00 (para limitar o desconto)
9. Limite de Uso: 500
10. Configure o período de validade
11. Clique em "Criar Cupom"

---

2. Criar Cupom de Frete Grátis para Black Friday

Situação: Oferecer frete grátis durante a Black Friday.

Como fazer:

1. Clique em "Novo Cupom"
2. Código: BLACKFRIDAY2024
3. Tipo: Frete Grátis
4. Status: Ativo
5. Descrição: "Frete grátis para toda a loja na Black Friday"
6. Valor Mínimo: 100.00 (apenas compras acima de R$ 100)
7. Limite de Uso: 1000
8. Válido De: 29/11/2024 às 00:00
9. Válido Até: 29/11/2024 às 23:59
10. Clique em "Criar Cupom"

---

3. Criar Cupom de Valor Fixo para Clientes VIP

Situação: Dar R$ 50 de desconto para clientes especiais.

Como fazer:

1. Clique em "Novo Cupom"
2. Código: VIP50
3. Tipo: Valor Fixo
4. Desconto: 50.00
5. Status: Ativo
6. Descrição: "R$ 50 de desconto para clientes VIP"
7. Valor Mínimo: 200.00 (compra mínima de R$ 200)
8. Limite de Uso: 100
9. Configure validade para 30 dias
10. Clique em "Criar Cupom"

---

4. Desativar Cupom Temporariamente

Situação: Pausar um cupom sem excluí-lo.

Como fazer:

1. Encontre o cupom na lista
2. Clique para ver os detalhes
3. Clique em "Editar"
4. Altere Status para Inativo
5. Clique em "Atualizar Cupom"

---

5. Buscar Cupons Inativos

Situação: Ver todos os cupons que estão desativados.

Como fazer:

1. Na tela principal de cupons
2. Clique no filtro "Status"
3. Selecione "Inativo"
4. Veja todos os cupons inativos na tabela
5. Clique em "Todos" para remover o filtro

---

Problemas Comuns e Soluções

❌ "Nenhum cupom cadastrado"

Problema: A tabela está vazia e não há cupons cadastrados.

Soluções:

• Se for seu primeiro acesso, crie cupons clicando em "Novo Cupom"
• Se você aplicou filtros, remova-os para ver todos os cupons
• Verifique se você tem permissão para visualizar cupons

---

❌ "Nenhum cupom encontrado com esse filtro"

Problema: A busca ou filtro não retornou resultados.

Soluções:

• Verifique a ortografia do código buscado
• Tente códigos mais genéricos (ex: "DESC" em vez de "DESCONTO20COMPLETO")
• Remova o filtro de status se estiver ativo
• Pressione Enter após digitar o código de busca

---

❌ Erro ao criar cupom

Problema: O botão "Criar Cupom" está desabilitado ou apresenta erro.

Soluções:

• Verifique se todos os campos obrigatórios estão preenchidos:
  • ✅ Código
  • ✅ Tipo
  • ✅ Desconto (exceto para Frete Grátis)
  • ✅ Status
  • ✅ Limite de Uso
  • ✅ Válido De
  • ✅ Válido Até
• Certifique-se de que o código segue o formato correto (apenas letras, números e %, ., -, _)
• Verifique se a data "Válido Até" é posterior a "Válido De"
• Verifique se você tem permissão para criar cupons

---

❌ Cupom não pode ser usado pelos clientes

Problema: Clientes reclamam que o cupom não funciona.

Possíveis causas e soluções:

1. Status Inativo: Verifique se o cupom está com status "Ativo"
2. Fora do período de validade: Verifique as datas "Válido De" e "Válido Até"
3. Limite de uso atingido: Verifique o card "Uso do Cupom" nos detalhes
4. Valor mínimo não atingido: Cliente precisa comprar o valor mínimo configurado
5. Código digitado incorretamente: Confirme o código exato com o cliente

---

❌ Não consigo editar um cupom

Problema: O botão "Editar" não aparece ou está desabilitado.

Soluções:

• Verifique se você tem permissão para editar cupons
• Certifique-se de que está na tela de detalhes do cupom
• Recarregue a página e tente novamente
• Entre em contato com o administrador do sistema para verificar suas permissões

---

❌ Erro ao excluir cupom

Problema: A exclusão falha ou retorna erro.

Possíveis causas:

• O cupom pode estar sendo usado ativamente por clientes
• Você pode não ter permissão para excluir cupons
• Pode haver pedidos vinculados a este cupom

Soluções:

• Se o cupom está em uso, considere desativá-lo em vez de excluir
• Verifique suas permissões com o administrador
• Entre em contato com o suporte técnico se o problema persistir

---

Entendendo os Tipos de Cupons

Porcentagem

Quando usar: Para dar desconto percentual sobre o valor da compra.

Características:

• Desconto calculado como % do valor total
• Pode ter desconto máximo em R$ para limitar perdas
• Ideal para promoções gerais
• Exemplos: 10%, 20%, 50%

Cenários ideais:

• Promoções sazonais (Black Friday, Natal)
• Cupons de primeira compra
• Campanhas de aniversário da loja

---

Valor Fixo

Quando usar: Para dar desconto de um valor específico em reais.

Características:

• Desconto de valor fixo independente do total da compra
• Simples e direto para o cliente entender
• Ideal para cupons de boas-vindas ou fidelidade
• Exemplos: R$ 20, R$ 50, R$ 100

Cenários ideais:

• Cupons de boas-vindas
• Recompensas para clientes VIP
• Compensações por problemas

---

Frete Grátis

Quando usar: Para isentar o cliente do custo de frete.

Características:

• Remove completamente o valor do frete
• Não afeta o valor dos produtos
• Altamente atrativo para clientes
• Incentiva compras de maior ticket

Cenários ideais:

• Campanhas de frete grátis
• Incentivar compras acima de determinado valor
• Promoções especiais para produtos com frete alto

---

Boas Práticas

📝 Nomenclatura de Códigos

1. Use códigos claros e memoráveis

   • ✅ PRIMEIRA15, BLACKFRIDAY, FRETEGRATIS
   • ❌ XYZ123, AAA, TEMP

2. Inclua o valor ou tipo no código quando possível

   • ✅ DESC20 (indica 20% de desconto)
   • ✅ 50REAIS (indica R$ 50 de desconto)

3. Use padrões consistentes

   • Se usar PRIMEIRA15, use também SEGUNDA15, TERCEIRA15
   • Mantenha um padrão de nomenclatura em toda a loja

4. Evite caracteres especiais complexos

   • Prefira letras, números e hífens
   • Evite caracteres que possam confundir (0 vs O, 1 vs l)

Exemplos corretos:

• ✅ DESCONTO20
• ✅ NATAL-2024
• ✅ VIP_50
• ✅ FRETE.GRATIS

Exemplos a evitar:

• ❌ dEsCoNtO20 (uso inconsistente de maiúsculas)
• ❌ @#$%! (caracteres especiais não permitidos)
• ❌ a1b2c3 (difícil de lembrar e comunicar)

---

🎯 Configuração de Valores

1. Defina limites claros para cupons de porcentagem

   • Sempre use "Desconto Máximo" para evitar perdas excessivas
   • Exemplo: 20% com máximo de R$ 200

2. Configure valores mínimos estrategicamente

   • Use para aumentar o ticket médio
   • Exemplo: Frete grátis acima de R$ 150

3. Limite o uso adequadamente

   • Campanhas rápidas: limite baixo (50-100 usos)
   • Campanhas longas: limite alto (500-1000 usos)
   • Cupons VIP: limite muito baixo (10-50 usos)

4. Considere o impacto financeiro

   • Calcule o custo total da campanha
   • Monitore o uso em tempo real
   • Ajuste se necessário (desative se uso excessivo)

---

🔄 Gestão de Cupons

1. Revise periodicamente os cupons ativos

   • Desative cupons expirados
   • Remova cupons não utilizados
   • Analise quais tipos têm melhor performance

2. Use descrições detalhadas

   • Explique as condições do cupom
   • Documente o objetivo da campanha
   • Facilita entendimento da equipe

3. Monitore o uso em tempo real

   • Acompanhe o card "Uso do Cupom"
   • Identifique cupons próximos do limite
   • Estenda limite se campanha bem-sucedida

4. Comunique mudanças à equipe

   • Informe quando criar cupons importantes
   • Avise sobre desativações
   • Mantenha todos alinhados

---

⚠️ Cuidados ao Editar

1. Não altere cupons em campanhas ativas

   • Pode causar confusão nos clientes
   • Prefira criar novo cupom

2. Cuidado ao reduzir limite de uso

   • Não reduza para menos que já foi usado
   • Pode impedir uso de clientes que planejavam usar

3. Teste alterações importantes

   • Simule o uso do cupom após editar
   • Verifique se comportamento está correto

4. Documente as mudanças

   • Anote o motivo da alteração
   • Comunique à equipe de marketing

---

📅 Gerenciamento de Períodos

1. Configure períodos realistas

   • Não crie cupons com validade muito longa
   • Revise e renove cupons periódicos

2. Use horários estratégicos

   • Inicie campanhas à meia-noite (00:00)
   • Termine campanhas ao fim do dia (23:59)

3. Planeje com antecedência

   • Crie cupons antes de divulgar
   • Teste antes de campanhas grandes

4. Monitore expirações

   • Verifique cupons próximos de expirar
   • Estenda se campanha bem-sucedida

---

Perguntas Frequentes (FAQ)

Posso ter dois cupons com o mesmo código?

Não é recomendado. Cada código deve ser único para evitar conflitos no sistema e confusão nos clientes. O sistema pode impedir a criação de códigos duplicados.

Posso alterar o tipo de cupom depois de criado?

Sim, mas com muito cuidado. Alterar de Porcentagem para Valor Fixo (ou vice-versa) pode causar problemas se o cupom já estiver em uso. É recomendado criar um novo cupom em vez de alterar o tipo.

O que acontece se o limite de uso for atingido?

Quando o limite de uso é atingido, o cupom não pode mais ser usado pelos clientes, mesmo que ainda esteja dentro do período de validade. Você pode editar o cupom e aumentar o limite se necessário.

Posso excluir um cupom que já foi usado?

Tecnicamente sim, mas não é recomendado. A exclusão pode afetar relatórios e históricos de pedidos. Prefira desativar o cupom alterando o status para "Inativo".

Como funciona o desconto máximo em cupons de porcentagem?

O desconto máximo limita o valor total de desconto. Por exemplo: cupom de 20% com desconto máximo de R$ 100. Se a compra for R$ 1000, o desconto seria R$ 200 (20%), mas será limitado a R$ 100.

Posso criar cupons sem data de expiração?

Não. Todos os cupons devem ter data de início e término configuradas. Isso garante melhor controle das promoções.

Quantos cupons posso criar?

Não há limite técnico, mas é recomendado manter apenas cupons ativos e relevantes para facilitar o gerenciamento.

O cupom pode ser usado múltiplas vezes pelo mesmo cliente?

O limite de uso é global, não por cliente. Se você configurar limite de 100, o cupom pode ser usado 100 vezes no total, independente de quantos clientes diferentes usarem.

---

Suporte

Precisa de Ajuda?

Se você encontrou algum problema ou tem dúvidas:

1. Verifique este manual para soluções comuns
2. Consulte a seção de Problemas Comuns acima
3. Entre em contato com o suporte técnico com as seguintes informações:
   • Print da tela ou descrição do problema
   • Código do cupom (se aplicável)
   • Mensagens de erro exibidas
   • O que você estava tentando fazer

Informações Úteis ao Contatar o Suporte

Tenha em mãos:

• Seu nome de usuário
• Código do cupom relacionado
• Tipo do cupom
• Prints de tela do problema
• Descrição detalhada do que você tentou fazer

---

Glossário

Termo	Significado
Cupom	Código promocional que oferece desconto aos clientes
Código	Identificador único do cupom digitado pelo cliente
Tipo	Categoria do cupom (Porcentagem, Valor Fixo, Frete Grátis)
Desconto	Valor ou percentual de redução no preço
Status	Estado do cupom (Ativo ou Inativo)
Limite de Uso	Quantidade máxima de vezes que o cupom pode ser usado
Valor Mínimo	Valor mínimo da compra para o cupom ser válido
Desconto Máximo	Limite máximo de desconto em reais para cupons de porcentagem
Período de Validade	Intervalo de datas em que o cupom pode ser usado
Uso do Cupom	Quantidade de vezes que o cupom já foi utilizado
Badge	Etiqueta visual que identifica tipo ou status
Auditoria	Registro de quem criou/modificou e quando

---

Próximos Passos

Após dominar os cupons, você pode:

• 📊 Analisar o desempenho dos cupons em relatórios
• 🎯 Criar estratégias de marketing com cupons segmentados
• 💰 Configurar cupons para eventos sazonais (Black Friday, Natal, etc.)
• 🔄 Integrar cupons com campanhas de e-mail marketing
• 📈 Acompanhar métricas de conversão por cupom

Bom uso da ferramenta de cupons! 🎫