Cupons

Cadastro de cupons de desconto para usar no PDV e no carrinho da Loja Virtual. Tela em /cupons, disponível em todos os planos.

Cupom é sempre secreto

Um cupom nunca aparece listado publicamente na loja virtual — só é aplicado quando o cliente ou o vendedor informa o código manualmente.

Cadastro

Campo	Obrigatório	Detalhes
Nome	Sim	Identifica o cupom internamente, entre 2 e 120 caracteres.
Código	Sim, a menos que use geração automática	Até 30 caracteres. É convertido para maiúsculas e precisa ser único no tenant.
Gerar código automaticamente	Não	Ao marcar, o campo Código some e o sistema gera um código a partir de um prefixo opcional + sufixo aleatório (ex.: PROMO-X7F9K2).
Tipo de desconto	Sim	Percentual (%) ou Valor Fixo (R$).
Valor do desconto	Sim	Percentual não passa de 100%. Valor fixo nunca desconta mais do que o subtotal da venda (o sistema limita automaticamente).
Vigência	Sim	Início obrigatório; fim pode ser uma data fixa ou "duração em dias" a partir do início.
Limite de uso	Não	Limite total de usos do cupom, somando todos os clientes.
Status	Vem como Rascunho	Só cupons com status Ativa podem ser aplicados numa venda.

Um cupom por cliente

Cada cliente só pode usar um determinado cupom uma única vez. Cancelar o pedido que usou o cupom libera o cupom de novo para aquele cliente.

Como o desconto é calculado

O desconto do cupom incide sobre o preço já reduzido pela Tabela de Preços vigente, quando houver uma — nunca sobre o preço cheio original (efeito cascata). Isso só acontece se a tabela de preços tiver a opção "Permitir Cupons" ativada; caso contrário, o sistema bloqueia a combinação e avisa que o cupom não pode ser usado com a tabela vigente.

Cupom e desconto manual não se somam

No PDV, aplicar um cupom cancela automaticamente qualquer desconto manual já lançado na venda, e vice-versa — os dois nunca somam na mesma venda.

Inativar ou excluir

Um cupom já usado em algum pedido não pode ser excluído (para preservar o histórico de vendas) — a opção disponível nesse caso é Inativar. Cupons que nunca foram usados podem ser excluídos normalmente.

Onde o cupom aparece depois de usado

Todo pedido que usou um cupom mostra isso explicitamente: a coluna Cupom na listagem de Pedidos (e nas exportações), e um card Cupom na tela de detalhe do pedido.

Permissões

Por padrão, só o perfil Administrador pode gerenciar, ver ou aplicar cupons. Um Grupo de Usuários pode conceder isso a outros perfis através de três permissões independentes:

Permissão	Libera
Gerenciar cupons	Criar, editar e inativar cupons.
Ler cupons	Ver a listagem de cupons cadastrados.
Consultar cupons	Aplicar/consultar um cupom ativo numa venda (ex.: no PDV).

Sem a permissão de Consultar cupons, o campo de código de cupom nem aparece no PDV para aquele usuário.